Skip to content

claude-code.md

Latest commit

 

History

History
81 lines (63 loc) · 3.23 KB

claude-code.md

File metadata and controls

81 lines (63 loc) · 3.23 KB

Claude Code 接入

本文档不是“最小安装说明”，而是 Claude 侧的 自举入口。

Claude 侧目标

Claude 已有 Agent Team 能力。AgentDevFlow 在 Claude 中要做的是：

  1. 复用现有 Team 能力
  2. 约束 Team Lead 的启动顺序
  3. 让每个角色先读共享规则再开始工作
  4. 保证文档阶段、实现阶段、Human Review 和 Issue Comment Gate 都可追溯

启动顺序

  1. 加载 adapters/claude/.claude/skills/
  2. 先读 TEAM_SETUP.md
  3. 先创建 Team Lead
  4. 由 Team Lead 确认：
    • project_id
    • 主 issue 或当前主工作索引
    • 当前 Gate
    • 启动会纪要、Todo Registry、状态板、产物关联主记录
  5. 再通过 按顺序创建：
    • Product Manager
    • 架构师
    • QA Engineer
    • Engineer
    • Platform/SRE
    • PMO
  6. 最后通过 start-agent-team 完成团队启动

Agent 初始化速查表（平台可执行）

序号 Agent 角色类型 Skill 文件 Playbook 文件 创建状态 初始化后动作
1 Team Lead team-lead skills/agents/team-lead.md skills/agents/team-lead.playbook.md 不创建 Human 本身
2 Product Manager product-manager skills/agents/product-manager.md skills/agents/product-manager.playbook.md 立即创建 读取 skills/workflows/prd-review.md
3 架构师 architect skills/agents/architect.md skills/agents/architect.playbook.md 立即创建 读取 skills/workflows/tech-review.md
4 质量工程师 qa-engineer skills/agents/qa-engineer.md skills/agents/qa-engineer.playbook.md 立即创建 读取 skills/workflows/qa-validation.md
5 工程师 engineer skills/agents/engineer.md skills/agents/engineer.playbook.md 立即创建 读取 prompts/019_dual_stage_pr_and_three_layer_safeguard.md
6 Platform/SRE platform-sre skills/agents/platform-sre.md skills/agents/platform-sre.playbook.md 立即创建 读取 skills/workflows/release-review.md
7 PMO pmo skills/agents/pmo.md skills/agents/pmo.playbook.md 按需创建 读取 docs/governance/core-principles.md

创建后立即动作：每个 Agent 创建后必须：

  1. 读取主 issue
  2. 读取最新 Gate 结论
  3. 读取 todo registry
  4. 输出初始化确认结果

创建日志记录：每个 Agent 创建后必须写入 .claude/logs/agent-creation.log

Team Lead 必须先做什么

Team Lead 在创建其他角色前，必须先确认：

  1. project_id
  2. 主 issue 或当前主工作索引
  3. 当前 Gate
  4. 已启用角色与未启用角色
  5. 启动会纪要、Todo Registry、状态板、产物关联主记录

没有这些前置条件，不得宣称团队已启动。

Claude 侧最小通过标准

  1. Team Lead 先读共享入口，不直接开工
  2. 默认角色顺序正确
  3. 文档阶段与实现阶段分离
  4. Human Review #1 / #2 可追溯
  5. Issue Comment Gate 生效

必读文件

  • adapters/claude/.claude/skills/TEAM_SETUP.md
  • skills/start-agent-team.md
  • skills/create-agent.md
  • docs/governance/core-principles.md
  • prompts/004_delivery_gates.md
  • prompts/013_github_issue_and_review_comments.md
  • prompts/019_dual_stage_pr_and_three_layer_safeguard.md