Agent Orchestration Rules
这是一套面向 Claude Code 的智能体编排规则,用于指导何时以及如何把实现类任务交给子智能体执行,以保护主对话的上下文。
用途
当用户要求实现某项功能时,使用实现型智能体(implementation agents),避免主对话上下文被大量文件读取和代码修改细节占满。
核心模式
反面做法(消耗上下文):
Main: Read files → Understand → Make edits → Report
(2000+ tokens consumed in main context)
正确做法(保留上下文):
Main: Spawn agent("implement X per plan")
↓
Agent: Reads files → Understands → Edits → Tests
↓
Main: Gets summary (~200 tokens)
何时使用智能体
- 多文件实现:是。理由是智能体在内部处理复杂度。
- 执行计划中的某个阶段:是。理由是智能体读取计划并实现。
- 带测试的新功能:是。理由是智能体可以运行测试。
- 单行修复:否。直接做更快。
- 快速配置改动:否。开销不值得。
关键观点
智能体会读取自己的上下文。不要为了“弄清楚该给智能体传什么”而在主对话里先读文件——把任务交给它,它自己会搞清楚。
示例提示词
Implement Phase 4: Outcome Marking Hook from the Artifact Index plan.
**Plan location:** thoughts/shared/plans/2025-12-24-artifact-index.md (search for "Phase 4")
**What to create:**
1. TypeScript hook
2. Shell wrapper
3. Python script
4. Register in settings.json
When done, provide a summary of files created and any issues.
触发词
当用户说出以下内容时,考虑使用智能体:
- “implement”“build”“create feature”
- “follow the plan”“do phase X”
- “use implementation agents”