Sub-agents

Sub-agents 的角色

Sub-agents 用于把复杂任务拆成更专门的角色和边界。它们不是普通 Prompt 复制品，而是更接近“受约束的专职执行单元”。

当前路径约定

默认输入路径：

subagents/

默认输出路径：

dist/subagents/

命名为什么重要

tnmsc 现在默认从 sub-agent 的相对路径推导名称：

• subagents/reviewer.src.mdx -> reviewer
• subagents/qa/boot.src.mdx -> qa-boot

因此：

• 不需要在 frontmatter 里写 name
• 如果写了 name，同步时会忽略并给出告警
• 想修改 sub-agent name，直接修改目录名或文件名

什么时候该写成 sub-agent，而不是 skill

• 你需要一个长期存在、职责边界明确的角色。
• 这个角色可能需要独立描述输入、行为约束与输出形式。
• 它不仅是“做一件事的方法”，而是“承担一类工作的代理配置”。