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.