Agent Creator
铁律:不要先写新 agent,再思考它是不是其实应该是 skill,或者只是现有角色的一次补充。
工作流
- Step 1: 判断应由 skill 还是 agent 承载 ⚠️ REQUIRED
- 1.1 加载 references/admission-guide.md,先判断这是可复用工作流,还是需要上下文隔离与多角色编排。
- 1.2 如果 skill 更合适,停止新建 agent,转交 skill-creator。
- Step 2: 审计现有能力 ⚠️ REQUIRED
- 2.1 扫描 AGENTS.md、agents/ 与 skills/,确认是否已有高重叠角色。
- 2.2 如果只是现有 agent 或 skill 的补充,优先补到原文件,不新增目录。
- Step 3: 设计 agent 边界
- 3.1 明确 agent 的职责、输入、输出、接棒关系和不负责的事项。
- 3.2 明确它集成哪些 skills,是否需要调用其他 agents。
- Step 4: 编写或更新 .agent.md ⚠️ REQUIRED
- 4.1 保持 frontmatter 可触发,正文包含角色设定、集成技能、参考文档、核心职责和协作工作流。
- 4.2 不使用不存在的文档路径作为强制参考资料。
- Step 5: 审计安全与准入
- 5.1 检查是否与现有 agents / skills 高度重复。
- 5.2 检查是否引导越权操作、危险命令或模糊职责。
- 5.3 需要审查时,联动 code-reviewer 做结构与安全审计。
- Step 6: 同步项目索引
- 6.1 更新 AGENTS.md 中的 agent/skill 列表与定位说明。
- 6.2 如果新增的是治理型角色,明确其准入规则与管理边界。
核心规则
- 需要上下文隔离、多角色协作、分阶段接棒或专门治理职责时,优先考虑 agent。
- 只是一个可复用工作流、检查清单或带 references/scripts 的任务时,优先考虑 skill。
- 发现与现有能力高重叠时,默认补充现有 skill 或 agent,而不是创建新项。
反模式
- 用 agent 解决其实是 skill 更适合的问题。
- 为了“看起来完整”创建一个和现有角色几乎重复的新 agent。
- 把 agent 写成一个没有边界的万能执行器。
- 在 agent 里引用不存在的 docs/ 路径或虚构流程。
交付前检查
- 已明确这是 skill 问题还是 agent 问题。
- 已审计现有 skills / agents,确认不是高重叠新增。
- .agent.md 中职责、边界、接棒关系和集成技能清晰。
- 已同步 AGENTS.md 或其他必要索引。