Claude Code 项目工作流
可用的 Claude Code 工作通常是一条链路：理解仓库、定义小范围改动、实现、验证、审查结果。跳过这些步骤，代理输出就会难以评审。
- 最近核验
- 适用版本
- 适用于 Claude Code 2.1.x。本机使用 2.1.198 检查 CLI 拼写；当前官方文档可能包含更新的 2.1.x 行为。
- 核验方式
- 2026-07-19 对照官方文档、CLI reference 和 changelog。流程顺序属于本站编辑综合；Claude 命令有官方依据，项目命令和结果必须在各仓库实际验证。
可复现实践
修复一个失败测试，同时控制范围漂移
分开复现、定位、实现和回归审查，不把看似合理的补丁误当成已验证修复。
准备
- 可复现失败命令及第一个可操作错误。
- 已知 git 基线，并有权编辑受影响区域。
- 有 task branch 或已审查 working-tree diff 作为回退路径。
执行步骤
提示前先复现
记录准确命令和最小稳定错误片段，去除秘密和个人数据。
步骤 1 # 运行仓库自己的失败测试 git status --short在 plan mode 定位
要求给出失败路径、候选文件、竞争假设和窄范围验证计划。
步骤 2 claude --permission-mode plan一次实现一个假设
计划能解释为何观察到的失败会改变后才允许编辑，避免顺手重构。
运行证据阶梯
先跑原失败检查，再跑相邻测试，最后跑更广的项目 gate。
步骤 4 # 1. 原失败命令 # 2. 相邻测试组 # 3. 项目 lint、typecheck 或 build git diff --check
预期结果
原失败不能再复现，相邻行为保持，diff 只包含证据支持的改动。
验证
- 原命令必须通过，不能只看新加测试。
- 检查无关格式化、依赖和生成文件改动。
- 记录无法运行的更广 gate 及原因。
失败处理
失败具有波动性
重复基线并记录条件，不能凭一次绿色运行宣称修复。
假设不成立
只回退该实验并保留证据，再测试下一个假设，不堆叠补丁。
清理或回退
- 用已审查 diff 或 task branch 移除失败实验。
- 生成文件应由所属 generator 恢复，不手工编辑。
边界与不适用场景
- 破坏性迁移、事故响应或需要生产外部验证的改动不能只依赖此流程。
- 本地测试通过不证明部署、权限、网络或数据相关行为。
编辑前先探索
先让 Claude Code 找出相关文件、入口、测试和构建命令。这样可以降低它改错层级或新增重复实现的风险。
高影响改动先计划
迁移、共享组件、安全敏感代码或大范围重构应先出计划。好的计划会写明涉及文件、验证命令和风险点。
用项目命令验证
验证应使用仓库自己的工具：类型检查、lint、单元测试、集成测试、浏览器检查或人工 QA。只有总结而没有命令输出，证据强度较低。
审查并整理结果
要求 Claude Code 总结 diff、说明已知限制和后续风险。提交或 PR 信息应绑定被验证的行为，而不是复述对话过程。
claude "Map the auth flow files, propose a plan, implement the fix, run pnpm test auth, then summarize the diff and remaining risks."按任务类型选择工作流
不同任务适合不同步骤。缺陷修复需要复现和回归检查，重构需要边界定义，功能开发需要验收标准。