用途：指导编写 Claude Code 的 agent .md 文件（Markdown 加 frontmatter，存放于 .claude/agents/）。Codex CLI 用 [agents.<name>] TOML 表定义在 .codex/config.toml；Antigravity 子智能体资料暂未提供；多智能体编排与插件架构另有相关文档。
主要能力与要点： 一、触发。缺少 <example> 块时 Claude 只能猜测何时派发 agent。最少 2 个、理想 3 个示例，分别覆盖明显触发、边界情况与非显而易见场景。示例应含具体 Context、贴近真实用户的 user 消息、以及展示决策逻辑的 assistant 回复。 二、模型选择。机械/解析/格式化/计数类用 haiku；分析/推理/中等判断用 sonnet；复杂判断/编排/多智能体用 opus。启发式：指令少于 20 行且无判断词用 haiku；20 至 50 行或有判断词用 sonnet；超过 50 行或有协调逻辑用 opus。判断词如 evaluate、decide、assess、determine、prioritize、recommend、judge、infer、synthesize。相对成本：haiku 为 1x，sonnet 10x，opus 30x；原则是先 haiku，输出质量不达标再升级。 三、工具最小权限。只列出正文实际引用的工具。审计/审查类常用 Read、Glob、Grep；代码生成类常用 Write、Edit、Bash；编排类用 Task；扫描类用 Grep、Glob、Read。 四、输出格式。每个 agent 必须定义输出格式，否则每次调用结果不一致、父级 agent 无法解析。可用结构化报告、按严重级别标注的发现（CRITICAL > HIGH > MEDIUM > LOW > INFO）、Pass/Fail 门禁等模式。 五、系统提示结构。按 Mission、Instructions、Boundaries、Output Format、Error Handling 顺序排列。各段建议行数：Mission 2-3，Instructions 5-15，Boundaries 3-7，Output Format 5-15，Error Handling 3-5。总体目标 25-45 行，超过 60 行说明职责过重，应拆分。
限制：文中给出的“40%/92% 触发准确率”“52/100、95/100 评分”等均为原文示例数字，非普适保证；实际效果取决于具体实现。示例中的具体路径、模型名与工具名应按项目实际情况调整。