Harness 技能与 Agent 创作

要解决什么问题

在 harness 类工具集里加新能力时，常见失误是：把可独立跑完的任务塞进 Skill 占满主对话 context，或把主对话需要持续引用的流程做成 Subagent 导致推理断档；SKILL.md 越写越长、description 与正文能力不一致，还会和已有 skill 功能重叠，让模型在多个近似选项里摇摆。

技能如何工作

本技能以 context 预算 和 渐进披露 为约束，给出可执行的创作方法论：

• Skill vs Subagent：Skill 把知识/工作流注入当前 context；Subagent 在独立 context 里执行，只把摘要带回主对话。经验法则：主对话需要「记住才能继续推理」→ Skill；可「委派出去等结果」→ Subagent。
• 三层加载：name + description 常驻（约百词）；正文触发后加载，正文 ≤ 500 行；references/、scripts/、assets/ 按需加载。
• description 写法：同时写清做什么与何时用，用具体场景（如用户说 A/B/C）而非抽象标签；正文必须能支撑 description 中的每一项能力。
• Subagent 权限：只读 agent 不给 Edit/Write；省略 allowed-tools 会继承全部工具，不是默认安全选项。通过 skills 预加载相关 skill，避免在 system prompt 里复制一份正文。
• 新增能力步骤：先定 skill/subagent → 写 description（先 when）→ 控预算写正文并规划 references/ → subagent 最小工具集与模型选择 → grep 查重叠 → 更新 CLAUDE.md/README → 自检行数与权限。

Agent 提示词以 ## Agent 提示词 为唯一规范版本，不再维护独立的 agents/*.md。

适用边界

不适用：创建与 harness 无关的独立工具、项目不使用 harness 方法论、或只想了解现有 skill 用法而不扩展体系。新增前应检查与现有能力重叠，应合并或划清边界；正文逼近 500 行必须拆到 references/ 并在正文写清加载说明。