用途:本目录存放仓库自持的 agent 定义(一 agent 一档),不依赖 everything-claude-code(ECC)plugin,供 design/SKILL.md、update/SKILL.md 等调用方在启动 general-purpose subagent 时引用其定义。
主要能力与常用定义:complexity-triage.md 做任务复杂度分诊(low/medium/multi-session),由 /design Step 2a 引用;doc-reviewer.md 对计划或文件逐项 PASS/FAIL 审查,由 /design Step 4a、/update Step 2 引用;doc-updater.md 同步 README/docs/CODEMAPS 并输出变更 Manifest,由 /update Step 1 引用;tdd-guide.md 引导 TDD 红-绿-重构,含 80% 覆盖率门槛,由 /design Step 1、Step 3 引用。
使用方式:一律经 general-purpose 加明确 prompt 引用定义档内容执行,不直呼定义档 name 当 subagent_type,例如 Agent(subagent_type="general-purpose", model="sonnet"),model 取自定义档 frontmatter(doc-reviewer/doc-updater/tdd-guide=sonnet、complexity-triage=haiku)。prompt 需包含「依 agents/<name>.md 的定义与检查清单执行 <任务>」及调用方传入的 context。禁止 Agent(subagent_type="tdd-guide") 这类撞名直呼,否则会静默加载同名 ECC 遗留定义且无错误提示。
验收:主模型须对照定义档的「输出格式」逐项核对回报是否符合契约;doc-updater 回报的变更 Manifest 不可直接采信,须亲自 git diff 逐条比对(见其红旗章节);doc-reviewer 与 complexity-triage 则核对是否逐项给出 PASS/FAIL 或固定 JSON 格式。
路径解析:repo checkout 为 agents/<name>.md;skills CLI 安装环境为 ~/.agents/skills/agents/<name>.md。找不到文件视为 agents/ 目录不存在(安装不完整),可从 https://github.com/ashe-li/agent-skills 取 agents/<name>.md,或请使用者重跑 npx skills update。本资料未提供各定义档完整内容与其它平台支持信息。