子代理听起来很高级，其实就是一个 Markdown 文件：放在 .claude/agents/名字.md（单个项目）或 ~/.claude/agents/（所有项目通用），顶部几行设置、下面写 plain-English 指令。主会话把活派给它，它在自己的上下文里干完，只回一句话摘要，长搜索和啰嗦输出不会污染主对话。作者 11 月 5 日在 demo 项目里现建了三个，实测了加载、运行和被跳过的情况。
格式分三部分。第一，头部必填的只有两个字段：name（唯一标识，不能含冒号）和 description；可选的有 tools、model、disallowedTools、permissionMode、skills、memory 等。第二，description 是最关键的一行——Claude 靠它决定什么时候派活，要同时写清“做什么”和“什么时候用”，比如“用户要求快速审代码时用它审 Python 文件的崩溃和缺失检查”，写“帮我看代码”这种含糊描述等于没写；两个代理也别抢同一个活。第三，正文就是给它的指令，越具体越好。
实测过程很直观。作者建了个 reviewer.md，tools 只给 Read、Grep、Glob，model 用 haiku，指令是“最多列 4 个问题、每条写行号和会怎么崩、绝不改文件”。在 demo 文件夹里说一句 “Use the reviewer subagent on app.py. Report only.”，7 秒跑完，报出 4 个崩溃风险、一个文件都没改。反面例子也测了：没有 description 的文件会被直接跳过，tools 只给了 Read 的代理改不了文件。另外注意：老教程里的 /agents 向导在 v2.1.318 已移除，现在要自己写文件，或者让 Claude 帮你写——懂了格式，才能检查它写出来的东西对不对。
适合想给 Claude Code 配专属帮手的人：审代码、查文档、跑固定检查，都可以先写一个小文件试试。相关阅读：站内 技能、子代理、插件到底怎么选、把技能和子代理打包成一个插件；原文见 AI Parabellum 实测全文，字段说明见 Claude Code 官方子代理文档。
来源：AI Parabellum，原文：https://aiparabellum.com/claude-code-subagent-file-format-examples/
没有回复内容