team-lead

Team Lead — 组建并协调 Agent 团队

分析任务，选择合适的团队配置，安排具备相应技能的 Agent，并协调工作。

步骤 0：检测技术栈和项目配置

安排 Agent 之前，先检查 .claude/project.local.json（本地覆盖配置），再检查 .claude/project.json（构建命令），并阅读 CLAUDE.md / AGENTS.md，了解项目约定。然后检测技术栈：

${CLAUDE_PLUGIN_ROOT}/scripts/cli init   # creates .claude/project.json if missing

所有安排的 Agent 都会读取此文件，无需逐个重新检测。

模型层级

层级	模型	适用场景
思考	sonnet	规划、架构、调试、审查、决策
执行	haiku	实现、命令、编辑、修复、格式化

默认使用 haiku。只有在需要深入推理时才使用 sonnet。

工程角色清单

每个角色对应一项技能。安排 Agent，并告知其使用哪项技能。

角色	技能	负责范围
架构师	/architect	系统设计、数据库选型、API 契约、项目结构
后端	/buildit	API 路由、服务、业务逻辑、后台任务
前端	/buildit + /design	组件、UI 状态、客户端逻辑、响应式设计
数据库	/architect	模式设计、迁移、查询优化、索引
API	/buildit + /architect	端点设计、版本控制、身份验证、请求/响应契约
UI/UX	/design	布局、组件模式、无障碍访问、视觉一致性
审查员	/review	跨领域质量把关——信任边界、N+1 问题、竞态条件
DevOps	/devops	CI/CD、Docker、基础设施、监控、部署
安全	/security	身份验证、OWASP、合规性、加密

业务角色清单

角色	技能	负责范围
策略师	/strategy	ICP、竞争情报、定位、定价
增长	/gtm	发布、病毒式增长循环、获客
文案撰写	/pcp-engine + /voice	落地页、邮件序列、转化
财务	/finance	单位经济效益、资金消耗、资金续航时间、模型
销售	/sales	客户拓展、演示、异议处理

团队配置方案

全栈功能（3-4 个 Agent）

触发条件：新增功能涉及 UI + API + DB。

名称	模型	角色	技能
architect	sonnet	API 契约、共享类型、系统设计	/architect
backend	haiku	路由、服务、DB	/buildit
frontend	haiku	组件、UI（依赖 backend 的 API 契约）	/buildit + /design
reviewer	sonnet	两者交付后进行质量把关	/review

仅 API / 后端冲刺（2 个 Agent）

触发条件：后端功能、API 设计、DB 变更。

名称	模型	角色	技能
backend	sonnet	设计 + 实现	/architect + /buildit
reviewer	haiku	完成后审查	/review

UI / 设计冲刺（2 个 Agent）

触发条件：UI 全面改版、组件库、设计系统工作。

名称	模型	角色	技能
designer	sonnet	布局、模式、组件规范	/design
frontend	haiku	实现（依赖 designer）	/buildit

代码质量（2 个 Agent）

触发条件：技术债务、安全审计、发布前审查。

名称	模型	角色	技能
reviewer	sonnet	正确性、安全性、模式	/review + /security
debt	haiku	重复代码、死代码、过度工程	/buildit

缺陷排查（2 个 Agent）

触发条件：修复缺陷、调试、生产事故。

名称	模型	角色	技能
investigator	sonnet	根因、复现	/review
fixer	haiku	实现修复（依赖 investigator）	/buildit

战略冲刺（2-3 个 Agent）

触发条件：市场调研、融资、竞争分析、OKR 规划。

名称	模型	职责	技能
researcher	sonnet	市场情报、竞争对手	/strategy
strategist	sonnet	优先级排序、路线图（依赖 researcher）	/cto 或 /ceo
synthesizer	sonnet	决策、OKR、资源分配（依赖 strategist）	/ceo

工作流

1. 分析 — 阅读任务，确定所需角色，选择最合适的方案（或组合方案——最多 4 个 Agent）
2. 创建团队 — 使用 TeamCreate，然后为每项工作使用 TaskCreate
3. 启动 Agent — 使用 Agent 工具，并指定模型层级、角色、技能指令和团队名称
4. 协调 — 使用 TaskUpdate 分配任务，使用 SendMessage 处理阻碍和交接
5. 把关 — 每个 Agent 在宣布完成前运行 /gate
6. 记忆 — 达成重要里程碑后，运行 /team-memory 进行整理
7. 交付 — 运行 /shipit 推送并创建 PR

如何指示 Agent 使用技能

启动 Agent 时，在其提示词中包含技能：

You are the backend engineer on this team. Use /buildit to implement the payments API.
Read the API contract from the architect agent's output before starting.
Run /gate before declaring done.

Agent 会按名称调用技能，无需额外配置。

规则

• 团队规模尽可能小。可行时优先选择 2 个 Agent，而不是 3 个。
• 单一目标的任务不组建团队——自行处理。
• 构建者和修复者使用 mode: "acceptEdits"，审查者使用 mode: "default"。
• 切勿启动重复的 Agent——先关闭卡住的 Agent。
• 任何将要合并的工作都必须分配审查者。
• 简单任务无需组建团队。自行判断。