开发工作流

使用 Claude Code 的规划模式、检查点和原生 Git 集成的端到端工作流。

功能开发工作流

本页讲人类可读的开发流程。Claude Code 的脚本化 orchestration runtime 见 Dynamic Workflows 与 Ultracode。

使用 Claude Code 构建功能的推荐流程。

阶段 1：探索（规划模式）

在规划模式下开始（Shift + Tab × 2），在不做任何更改的情况下理解代码库：

text
我需要添加 Google OAuth 登录。探索：
- @src/auth/ 中现有的认证系统
- @prisma/schema.prisma 中的数据库 schema
- 现有的中间件模式

提出一个包含文件变更的实现计划。

阶段 2：实现（普通模式）

切换回普通模式并逐步实现。Claude 会在写入文件前询问：

text
实现上面的 OAuth 计划。
先做数据库迁移，然后是 API 路由，
最后是前端。为每一层编写测试。
每完成一个步骤就提交。

阶段 3：审查与发布

text
审查自 main 以来的所有更改，检查：
- 遗漏的错误处理
- OAuth 流程中的安全问题
- 测试覆盖缺口
然后创建一个描述清晰的 PR。

Bug 修复工作流

1. 在规划模式下诊断

text
Bug：访客用户结账时出现 TypeError

探索 @src/pages/Checkout.tsx 并追踪调用链。
先不要修改任何内容，只找出根因。

2. 编写失败测试

切换到普通模式：

text
编写一个复现访客结账 bug 的测试。
放在 @src/__tests__/checkout.test.ts 中。
先不要实现修复。

3. 修复并验证

text
现在修复代码使失败的测试通过。
之后运行完整的测试套件。如果其他测试也失败了，
一并修复。所有测试通过后提交。

4. 扫描类似 Bug

text
扫描代码库中相同的模式——
访问 user 属性时没有空值检查。
列出找到的每一处。

TDD 工作流

Claude Code 非常适合测试驱动开发：

  1. 用自然语言描述功能
  2. 让 Claude 先编写失败测试
  3. 让 Claude 实现代码以通过测试
  4. 让 Claude 在保持测试通过的情况下重构
text
用 TDD 实现这个功能：/api/auth/login 端点的限流。
每个 IP 每分钟最多 5 次尝试，超出后返回 429。

第 1 步：先编写全面的测试。
第 2 步：实现代码使所有测试通过。
第 3 步：重构以提高可读性。

每步之间运行测试。第 2-3 步中不要修改测试。

检查点工作流

使用 Claude Code 内置的检查点功能进行安全实验：

  1. 开始一个任务 — Claude 会自动创建检查点
  2. 如果方法不奏效，按 Esc Esc 回退
  3. 选择：仅恢复代码、仅恢复对话，或两者都恢复
  4. 在保留上下文的情况下尝试不同方法

这对于探索性重构特别有用，你可以尝试多种方法。

PR 创建工作流

Claude Code 具有原生 Git 集成：

text
为当前更改创建一个 PR。

包含：
- 变更内容和原因的摘要
- 测试说明
- 如果 UI 有变化，附上截图
关联 issue #42。

审查他人的 PR：

bash
git diff main...feature-branch | claude -p "审查这个 PR。
重点关注正确性、安全性和测试覆盖。
指出具体的行号。"

想要设计自己的 Agent 工作流？

这些工作流遵循所有自主 Agent 使用的"探索 → 规划 → 执行"模式。理解这个循环为何有效，能帮助你构建更高效的 AI 辅助开发实践。

学习 Agent 基础与工具使用

延伸阅读

  • 提示词 — 每个工作流步骤的可复制提示词
  • Hooks — 使用 hooks 自动化这些工作流的部分步骤
  • Skills — 打包可重复的工作流步骤
  • Subagents — 委托高噪声或专门步骤
  • Dynamic Workflows — 通过 workflow scripts 编排大量 agents
  • Agent Teams — 协调更大的并行工作流

继续实践

开发工作流 的核心概念已经读完

如果你想把理解变成可复用的能力，可以到 AgentWay 继续练习

进入练习