代码先锋 是一个基于 Claude Code 的智能编程专家团队系统。由四位专业领域专家组成，能够根据任务类型自动识别并分配给最合适的专家处理，实现高效协作交付。
┌─────────────────────────────────────────────────────────────────────┐
│ Claude Code 主代理 │
├─────────────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────────────────────────────────────────────────────┐ │
│ │ 协调器 Skill (code-vanguard-coordinator) │ │
│ │ │ │
│ │ • 运行在主代理层面，拥有完整的工具权限 │ │
│ │ • 接收用户任务，分析需求，制定执行计划 │ │
│ │ • 通过 Task 工具触发专家 Agent 执行具体工作 │ │
│ │ • 不自己干活，只负责协调和分配 │ │
│ │ │ │
│ └───────────────────────┬─────────────────────────────────────┘ │
│ │ Task 工具触发 │
│ ┌───────────────┼───────────────┐ │
│ ▼ ▼ ▼ │
│ ┌───────────┐ ┌───────────┐ ┌───────────┐ │
│ │ Agent │ │ Agent │ │ Agent │ ... │
│ │ Phoenix │ │ Viper │ │ Ghost │ │
│ │ │ │ │ │ │ │
│ │ • 子代理 │ │ • 子代理 │ │ • 子代理 │ │
│ │ • 执行任务 │ │ • 执行任务 │ │ • 执行任务 │ │
│ │ • 返回结果 │ │ • 返回结果 │ │ • 返回结果 │ │
│ └───────────┘ └───────────┘ └───────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────┘
| 组件 | 类型 | 作用 | 能否触发其他Agent |
|---|---|---|---|
| 协调器 Skill | Skill | 任务入口，分析需求，协调专家 | 可以（运行在主代理层面） |
| 专家 Agent | Agent | 执行具体任务 | 不可以（子代理无法调用其他子代理） |
Claude Code 有一个关键限制：子代理（Agent）无法调用其他子代理。
因此我们将协调器设计为 Skill（运行在主代理层面），这样它就可以自由触发专家 Agent，实现多专家协作。
| 专家 | 代号 | 核心职责 | 触发场景 | MCP能力 |
|---|---|---|---|---|
| Phoenix | 架构师 | 系统架构设计、技术选型、重构规划 | 架构设计、技术选型 | 深度思考、文档查询、顾问咨询 |
| Viper | 开发者 | 功能实现、算法开发、模块编码 | 写代码、实现功能 | 文档查询 |
| Ghost | 测试专家 | 测试设计、代码审查、性能优化 | 测试、审查、Bug修复 | 文档查询 |
| Oracle | 创新者 | 技术调研、创新方案、疑难攻关 | 新技术、疑难问题 | 深度思考、文档查询、网络搜索、GitHub读取 |
用户: 写一个 Python 快速排序函数
协调器: 分析需求 → 识别为简单编码任务 → 触发 Viper
Viper: 输出可运行代码 + 使用示例
用户: 帮我设计并实现一个用户登录 API，包含测试用例
协调器的工作流程:
┌────────────────────────────────────────────────────────────┐
│ Step 1: 触发 Phoenix 进行架构设计 │
│ → 输出: API 架构设计文档 │
│ │
│ Step 2: 触发 Viper 实现功能代码 │
│ → 输出: 登录 API 实现代码 │
│ │
│ Step 3: 触发 Ghost 编写测试用例 │
│ → 输出: 单元测试 + 集成测试 │
│ │
│ 完成交付 │
└────────────────────────────────────────────────────────────┘
用户: 同时实现用户模块、订单模块和支付模块
协调器:
分析需求 → 识别为独立子任务 → 并行触发多个 Viper
- Viper-1: 实现用户模块
- Viper-2: 实现订单模块
- Viper-3: 实现支付模块
汇总交付
用户: 实现一个高性能缓存系统，不确定用什么技术方案
协调器:
Step 1: 触发 Oracle 调研技术方案
→ 输出: 技术选型建议（Redis vs Memcached）
Step 2: 基于调研结果，触发 Viper 实现
→ 输出: 缓存系统实现代码
# 1. 复制专家 agent 配置到 ~/.claude/agents/
cp agents/*.md ~/.claude/agents/
# 2. 复制协调器 skill 到 ~/.claude/skills/
cp -r skills/code-vanguard-coordinator ~/.claude/skills/安装后需要重启 Claude Code 会话才能加载新配置。
直接向 Claude Code 描述你的需求，协调器会自动分析并分配：
用户: 帮我设计一个用户认证系统的架构
用户: 写一个 Python 快速排序函数
用户: 帮我设计并实现一个用户登录 API，包含测试用例
用户: 这个 bug 怎么修复？
用户: 帮我调研一下 GraphQL 和 REST API 的优劣
协调器会：
- 分析你的需求类型
- 选择合适的协作模式
- 依次或并行触发专家 Agent
- 汇总结果交付
如果你想跳过协调器，直接调用特定专家：
用户: 使用 code-vanguard-phoenix 设计系统架构
用户: 让 code-vanguard-viper 实现这个功能
用户: 请 code-vanguard-ghost 审查这段代码
用户: 让 code-vanguard-oracle 调研这个技术方案
用户: /code-vanguard-coordinator 帮我完成一个完整的用户管理模块
{项目}/.codevanguard/
├── phases/ # 串行阶段（架构→实现→测试）
│ ├── 01_architecture/ # Phoenix 架构设计
│ │ ├── INDEX.md # 阶段索引
│ │ └── *.md # 详细产出文件
│ ├── 02_implementation/ # Viper 功能实现
│ └── 03_testing/ # Ghost 质量保障
├── outputs/ # 并行产出（研究/审查）
│ ├── oracle/ # Oracle 技术调研
│ └── ghost/ # Ghost 代码审查
├── inbox.md # 统一消息收件箱
└── summary.md # 最终项目汇总
| 模式 | 传递方式 | 使用场景 |
|---|---|---|
| 串行 | 链式传递（A→B→C） | 架构→实现→测试 |
| 并行 | 广播传递（独立产出） | 多模块并行开发 |
| 混合 | 串行+并行组合 | 复杂项目动态选择 |
| 级别 | 标识 | 定义 | 使用场景 |
|---|---|---|---|
| 🔴 必要级 | REQUIRED | 任务核心依赖 | 必须使用 |
| 🟡 推荐级 | RECOMMENDED | 显著提升质量 | 建议主动使用 |
| 🟢 可选级 | OPTIONAL | 锦上添花 | 视情况使用 |
| 专家 | MCP工具 | 用途 |
|---|---|---|
| Phoenix | sequential-thinking, context7, aurai-advisor | 深度思考、文档查询 |
| Viper | context7 | 文档查询 |
| Ghost | context7 | 文档查询 |
| Oracle | sequential-thinking, context7, aurai-advisor, web-search, web-reader, zread | 深度思考、文档查询、网络搜索 |
code-vanguard-team/
├── README.md # 本文档
├── INSTALL.md # 安装说明
├── agents/ # 专家 Agent 配置
│ ├── code-vanguard-phoenix.md # 架构师配置
│ ├── code-vanguard-viper.md # 开发者配置
│ ├── code-vanguard-ghost.md # 测试专家配置
│ └── code-vanguard-oracle.md # 创新者配置
└── skills/ # 协调器 Skill 配置
└── code-vanguard-coordinator/
├── skill.md # 协调器主文件
└── references/
└── patterns-examples.md # 协作模式参考
- 🎉 完全重构为混合型团队架构
- ✅ 新增完整的5条核心原则
- ✅ 新增5步执行流程
- ✅ 新增MCP三级授权机制
- ✅ 新增完整的信息传递机制
- ✅ 优化专家核心设定（8条设定）
- 📚 完善调度指令理解和响应规范
- 🎉 团队配置更新到最新版本
- ✅ 优化了协调器和专家代理配置
- 📚 完善了安装指南和使用文档
- 重启生效：修改配置后需重启 Claude Code 会话
- 委托优先：协调器只协调，不自己执行任务
- 工具权限：MCP工具需协调器授权后才能使用
- 信息传递：串行阶段必须读取前序产出
本项目采用 MIT 许可证。
代码先锋 - 让 AI 协作更智能