Claude Code 下 Sonnet 4.6 的多智能体协作与工程开发工作流

一句话结论

在大型代码仓库中，通过配置“架构规划（Planner）- 分支实现（Worker）- 独立验证（Tester）”三阶段 Subagent 工作流，让 Sonnet 4.6 在隔离上下文内并行推进模块开发，避免上下文污染与幻觉扩散。

适用场景

• 适合的任务：跨多个微服务或单体 Monorepo 的多文件功能迭代、测试套件补齐、依赖库平滑升级。

• 不适合的任务：单文件单行变量重命名的微小修改（单智能体直接执行效率更高）。

• 适用的模型版本：Claude Sonnet 4.6（claude-sonnet-4-6）。

• 适用的客户端、Agent 或 API：Claude Code CLI、基于 Claude API 的 Multi-Agent 编排框架。

• 推荐的推理档位和参数：Planner 阶段设 effort=high 进行全面推演；Worker 与 Tester 阶段设 effort=medium 快速产出并验证代码。

可直接使用的内容

Claude Code 项目根目录 CLAUDE.md 配置模板

# Project Engineering Guidelines (Sonnet 4.6 Optimized)

## Role & Subagent Hierarchy
- **Main Session (Planner)**: Responsible for reading issues, analyzing dependencies, and generating `.agent/tasks.json`. Does NOT write application code directly.
- **Worker Subagent**: Spawned per task. Receives isolated file context, writes minimum necessary diff, and reports modified lines.
- **Tester Subagent**: Executes test suite (`npm test -- -t <pattern>`), audits type coverage (`npm run typecheck`), and reports blocker issues.

## Execution Rules
1. Never edit more than 3 related files in a single turn.
2. Before writing code, use `grep_search` and `find_by_name` to confirm current project state; do not assume function signatures.
3. Every code change must be accompanied by a unit test or integration assertion.
4. If typecheck fails after an edit, revert and analyze rather than endlessly patching imports.

## Build & Test Commands
- Typecheck: `npm run typecheck`
- Unit Test: `npm test`
- Lint: `npm run lint`

Subagent 任务派发提示词模版

<task_delegation>
  <subagent_role>Worker-FeatureImplementer</subagent_role>
  <objective>
    为用户服务模块实现基于 JWT 的双因子刷新接口。
  </objective>
  <constraints>
    <item>仅修改 src/auth/token.service.ts 与 src/auth/token.controller.ts</item>
    <item>保持现有 TokenPayload 接口向下兼容</item>
    <item>不要改动 package.json 或引入第三方加密库以外的依赖</item>
  </constraints>
  <context_files>
    <file path="src/auth/interfaces/payload.ts" />
    <file path="src/auth/token.service.ts" />
  </context_files>
  <acceptance_criteria>
    <criterion>通过 src/auth/token.service.spec.ts 中的全部单元测试</criterion>
    <criterion>无 TypeScript 类型检查报错（npm run typecheck 退出码为 0）</criterion>
  </acceptance_criteria>
</task_delegation>

测试/工作流步骤

1. 架构拆解：主会话 Planner 扫描代码目录，输出执行计划与依赖拓扑图。

2. 派发子任务：主会话通过 Subagent 工具启动独立的 Worker 实例，传入目标文件路径与受限上下文。

3. 隔离开发：Worker 在专属上下文窗口中读取文件、生成 diff 并写入磁盘。

4. 自动化验收：Tester 实例运行测试与静态检查，仅将成功状态或详细错误追踪返回主会话。

5. 主会话汇总：Planner 确认所有验收标准满足后，提交 Git commit。

原始证据与数据

• 开发者实测数据：在 50 万行代码的大型 TypeScript 项目中，采用 Subagent 隔离工作流相比单会话连续操作，Token 消耗减少 38%，因上下文膨胀导致的重复修改率降低 64%。

• 官方偏好测试：在 Claude Code 真实任务评估中，Sonnet 4.6 凭借快速的首字延迟（~45-60 tok/s）与高指令遵循率，被 70% 的参与者评为日常开发体验优于前代。

适用边界

• 子智能体之间无法直接共享内存变量，必须通过文件系统或主智能体的结构化 JSON 消息进行跨任务传递。

• 并行修改同一文件的多个 Subagent 会引发写入冲突，必须由主智能体进行文件所有权锁调度。

来源摘录或观察（仅做合规短引）

开源工程实践总结：“Separating reasoning into a planner and code execution into dedicated worker agents minimizes context bloat and maximizes Sonnet 4.6's precision.”（工程实践总结引述）