Claude Code 与多 Agent 协作实战：避免上下文爆炸的 4 项黄金法则 / Mastering Multi-Agent Workflows with Claude Code

在将 Claude Code CLI 与 Claude 3.7 Sonnet 接入日常复杂项目重构后，许多开发者常遇到类似困扰：对话进行到第 10 轮以上时，模型开始“遗忘”最初的架构约束，甚至产生幻觉、修改无关文件。

这就是典型的上下文衰减与爆炸（Context Rotting & Bloat）。要让 Agent 稳定交付高质量工程代码，建议遵循以下 4 项黄金工程准则：

1. 测试先行作为锚点（Test-Driven Anchoring）

在让 Agent 动业务逻辑前，先命令其编写针对当前 Bug 或新功能的失败单元测试。

• 只有当 Agent 可以自主执行 npm test 或 pytest 并根据退出码判断成功与否时，才能形成闭环自愈；
• 避免空泛的人工肉眼 Review。

2. 打造极简的 CLAUDE.md

CLAUDE.md 是每次会话都会自动注入系统上下文的文件。请务必保持其小巧精悍：

• 列出关键命令：构建（Build）、单测（Test）、Lint 命令；
• 声明架构红线：如“禁止使用 any”、“必须使用 Tailwind CSS”、“不得直接修改自动生成的 schema”；
• 避免放入冗长的业务介绍或伪代码。

3. 多 Agent 职责切分（Context Isolation）

面对跨模块重构任务，不要使用单一会话一干到底。推荐拆解为流水线：

• Research Agent（只读）：全库检索符号引用、分析调用拓扑，输出 Markdown 方案；
• Implement Agent（写入）：仅加载受影响文件，执行代码变更并跑通测试；
• Review Agent（审查）：比对 git diff，排查破坏性变更与潜在安全隐患。

4. 强制 Conventional Commits

规范化提交记录不仅方便回滚，更让自动化工具和同行能一眼洞悉变更意图。建议在规则中固化 feat(...), fix(...), refactor(...) 等前缀。

English Summary

When scaling Claude Code CLI on complex codebases, context bloat can degrade output accuracy. Anchor modifications with test-first harnesses, keep your root CLAUDE.md concise, isolate research from execution across dedicated subagents, and enforce conventional commit messages.