> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zxiaoruan.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 使用Claude Code Sub Agent的最佳实践工作流

# Vibe Coding - 优秀文章&项目部分

## 优秀文章&项目

### 使用Claude Code Sub-Agent的最佳实践工作流

这套方法的核心思想是：将自己定位为项目总监（CEO），将主Agent（Main Agent）作为你的项目经理或技术主管，而将Sub-Agent视为执行具体、细粒度任务的初级工程师。\
这种垂直化的管理模式能最大程度地发挥主Agent的规划编排能力和Sub-Agent的并发执行效率，同时有效规避Sub-Agent“脆皮”（即能力边界有限，容易出错）的特性。

#### 阶段一：奠定基础与规划（总监决策）

##### 明确核心目标与高级约束 (claude.md)

* **您的角色**：设定项目的最终目标、技术选型、关键架构决策和编码规范。
* **实践方法**：
  * 在项目根目录创建 `claude.md` 或 `.claude/doc` 目录。
  * 用自然语言写下：
    * 项目概述：要实现什么功能。
    * 技术栈：使用的语言、框架、库。
    * 核心原则：KISS原则、代码风格、错误处理策略等。
    * 禁止事项：不能使用的库、不能修改的文件。
* **目的**：此文档是项目“宪法”，为AI提供稳定、高级的上下文，避免方向偏移。

##### 授权主Agent进行项目调研

* **您的角色**：下达第一个指令。
* **实践方法**：
  * 指令示例：“开启UltraThink，首先阅读全部项目文档，尤其是 `.claude/doc` 下的内容。然后扫描整个代码库，理解结构与逻辑。”
* **目的**：让主Agent深入了解现状，便于后续拆解和分配任务。

#### 阶段二：任务分解与编排（项目经理履职）

##### 从宏观到微观的迭代式任务拆解

* **您的角色**：提出一个较大的需求，如“重构用户认证系统”。
* **主Agent角色**：拆解为详细、细小、可执行的计划。
* **实践方法**：
  * 指令示例：“请遵循KISS原则，为重构制定一个分批次执行计划，任务拆解到函数或模块级别。”
* **关键点**：
  * 任务要拆得足够细！
  * 好的任务例子：“为 `user.ts` 中的 `getUser` 函数增加 `email` 字段的返回”。

##### 动态生成Sub-Agent指令

* **主Agent角色**：
  * 将小任务包装成清晰的 Prompt，分配给Sub-Agent。
* **关键点**：
  * 指令应实时动态生成，具体到文件、函数、目标和参考代码。

#### 阶段三：并发执行与监控（工程师团队开工）

##### 安全第一：使用版本控制进行隔离

* **最佳实践**：强烈建议主Agent先 `git branch` 或 `git worktree` 创建新分支。
* **实践方法**：
  * 指令示例：“创建一个名为 `feat/refactor-auth-batch-1` 的新分支，所有Sub-Agent操作在此进行。”
* **目的**：隔离AI修改，避免污染主分支。

##### 启动并行的Sub-Agent

* **您的角色**：批准计划并下令执行。
* **实践方法**：
  * 指定并发数量：“你准备调用几批，每批多少个SubAgent？”
* **应用场景**：
  * 修复大量 lint 错误、代码替换、生成样板代码等任务。

##### 处理中断与错误

* **现实情况**：Sub-Agent可能中断。
* **实践方法**：
  * 示例指令：“第二批SubAgent中断了，重新启动5个，并检查当前任务完成情况后继续。”
* **目的**：建立具备恢复力的工作流。

#### 阶段四：评审、迭代与整合（质量控制与循环）

##### 评审工作成果

* **您的角色或主Agent角色**：
  * 检查新分支代码变更，如 `git diff`。
* **实践方法**：
  * 示例指令：“请总结修改并运行单元测试。”

##### 迭代优化下一批次

* **主Agent角色**：
  * 汇报结果并优化下一批次任务。
* **关键点**：
  * 示例：“第一批完成，确认大部分已实现，现在准备第二批。”

##### 合并与清理

* **您的角色**：决定是否合并主分支。
* **实践方法**：
  * `git merge` 或 `git rebase`
  * 临时Prompt用后即删，无需保留。

#### 核心要点总结 (TL;DR)

* **垂直管理模型**：你是CEO，主Agent是经理，Sub-Agent是员工。
* **文档先行**：`claude.md` 是AI活动的宪法。
* **极致拆解**：任务必须细到Sub-Agent能独立完成。
* **并发加速**：对重复任务使用并行Sub-Agent提升效率。
* **Git隔离**：永远在独立分支操作Sub-Agent。
* **动态指令**：主Agent需生成定制化指令。
* **迭代循环**：遵循“规划-执行-评审-优化”模式，允许失败。
* **从简到繁**：先做简单任务，逐步探索能力边界。