Skip to content

前提条件

  • 已安装 Claude Code: npm install -g @anthropic-ai/claude-code
  • 已配置 API 密钥: export ANTHROPIC_API_KEY="sk-ant-..."
  • 一个 Git 仓库项目

启动工作流

进入你的 Git 项目目录,直接输入 slash 命令:

bash
cd ~/my-project
claude

进入 Claude Code 交互式界面后,输入:

/do 为项目添加一个 /health HTTP 端点,返回 JSON 格式

Claude Code 会自动加载 do 工作流技能,然后分阶段引导你完成:

[/do] Starting workflow...
[Stage 1/7] Clarify — 分析需求,识别模糊点
[Stage 2/7] Explore — 扫描项目结构,理解现有代码
[Stage 3/7] Plan — 设计实现方案
[Stage 4/7] Implement — 编写代码(在 Git worktree 中)
[Stage 5/7] Test — 生成测试用例
[Stage 6/7] Review — 代码审查
[Stage 7/7] Summary — 交付报告

7 阶段详解

Clarify(澄清)

智能体分析你的需求描述,识别模糊点并自动澄清。

典型输出: 功能点列表、验收标准、边界条件

Explore(探索)

深度扫描项目结构,理解相关代码区域。

典型输出: 代码地图、涉及文件、依赖关系

Plan(规划)

制定具体实现方案,包括文件变更列表、API 设计、步骤规划。

典型输出: 详细的实现计划文档

Implement(实现)

在 Git worktree 隔离环境中编写代码,主分支不受影响。

典型输出: 六个文件变更(新文件、修改文件)

Test(测试)

生成需求驱动的测试用例,覆盖快乐路径和边界情况。

典型输出: 测试用例 + 覆盖率报告

Review(审查)

五维评估(可维护性/性能/安全/风格/兼容性)。

典型输出: 审查报告 + 修复建议

Summary(总结)

生成完整交付报告,包括变更清单和使用说明。

典型输出: 变更文件 diff、后续建议

查看工作流产出

工作流完成后,Claude Code 会输出完整的交付摘要。你可以在 Git worktree 中查看变更:

bash
# 查看 worktree 列表
git worktree list

# 查看变更
git diff pinable/do-xxx..HEAD

# 确认无误后合并
git merge pinable/do-xxx

直接用原生 CLI 执行单个任务

不需要完整工作流时,直接调用原生 CLI:

bash
# Claude Code(交互式)
claude "解释 src/auth/login.go 的逻辑"

# Codex(HEREDOC 批量)
codex - <<'EOF'
为 src/auth/login.go 添加单元测试,覆盖:
- 正常登录
- 密码错误
- 用户不存在
EOF

常见问题

工作流中途断了怎么办?

Claude Code 会自动保存会话状态:

bash
# 恢复会话
claude --resume

可以跳过某个阶段吗?

可以,但仅在明确知道该阶段产出时使用:

/do <任务> --skip clarify

我想同时运行多个任务怎么办?

bash
# 并行执行
codex --parallel <<'EOF'
---TASK---
id: task1
---CONTENT---
实现用户注册
---TASK---
id: task2
---CONTENT---
实现用户登录
EOF

Workflows / Orchestration / Execution