AI AI 工具指南
AI 工具教程

Claude Code 工作流——可复用模式

Claude Code 的日常开发工作流：读代码、拆任务、改文件、跑测试、复盘上下文，整理成可重复使用的模式。

发布于: 作者: AI Productivity Guide Team 🌐 查看英文版本

这篇讲什么

在真项目里日常用 Claude Code 的模式——能撑过第一周、半年后还适用的那些。痛点：多数新手学了基础、跑了几个炫的 demo，然后掉进坏习惯（大任务、不 commit、CLAUDE.md 过期），慢慢失去信任。这篇把能让 agent 一直有用的可复用模式说清楚。

本文涉及的工具 / 概念：

  • Claude Code: Anthropic 的命令行 AI 编程 agent，能在你的终端里读、写、运行项目代码。
  • Planning prompt: 先要计划再要代码；产出稳定的最高杠杆习惯。
  • 锚点 commit: 在 agent 步骤之间频繁的小 commit，框住回滚距离。

这篇适合谁看

已经用 Claude Code 并在拿它出活的开发者。如果你撞过那堵墙——前三周很顺，现在返工多于进展——这篇尤其值。

什么时候适合用

日常项目工作：功能、重构、bug 修复、加测试、依赖升级。一次性脚本（直接跟 Claude 聊就行）和绿地架构决策（先找人聊）不在此列。

开始前准备

  • 每次 session 当作一个小 PR。选一个目标，一句话写下来，抵抗范围 creep。
  • 确认 CLAUDE.md 反映当前现实。过期约定比没约定还让 agent 糊涂。
  • 开始前 main 上测试要通过。否则分不清是 agent 改坏还是你继承的坏。
  • 决定哪些命令 agent 可以不问就跑——.claude/settings.json 里明确 allow/ask。

具体步骤

  1. 先 plan：写计划，先不要写代码。列要改的文件、要新建的文件、要加的测试、和范围外的文件。先按一套 AI 编程上下文管理流程把相关文件喂进去，让计划基于真实代码。
  2. 严格审计划。涉及超过 5 个文件就砍范围。没要的部分直接反推。
  3. 改动一次一个 PR。每个 PR 等于一个逻辑改动；打包必让 review 崩溃。
  4. 用 TODO 注释做锚点——// TODO(claude): 把这段抽成单独函数 让你在后续 session 里指到准确位置。
  5. 小而描述清楚的 commit——好回滚、好 bisect、好写有意义的 PR 描述。
  6. 每次 session 收尾写一段总结：改了什么、还有什么没完。贴进 PR 描述，留给 reviewer（和未来的自己）上下文。

第一次实操怎么跑

  1. 看你当前 Claude Code 流程里通常跳过哪一步。最常见：planning prompt。
  2. 下一个任务里显式补上那一步。注意输出质量是否变化。
  3. 比较前后 commit log——commit 更小、回滚更少就是习惯起效。
  4. 把这个习惯写进 CLAUDE.md，让 agent 反过来督促你。

完成后检查

  • 每个 commit 测试 + lint 都过——没商量。Agent 不该在坏状态上下一步。
  • Diff 在范围内——只动计划里提到的文件。多出来就问为什么。
  • PR 描述自洽——三句话讲不清的，说明打包过头了。
  • Agent 行为与 CLAUDE.md 一致。规则和行为漂移说明规则太模糊。

怎么复用这套流程

  • 把最爱的 planning prompt 存成 slash command（.claude/commands/plan.md）。
  • 维护一份个人”agent style guide”——半打你写过最稳出正确输出的句式。
  • CLAUDE.md 每月审一次。Agent 已默认遵守的删掉；新犯的错加进去。
  • 维护 session 日志——一行一 session，哪儿好、哪儿差。二十条后规律会出现。

建议的操作流程

Plan → 审计划 → 小改动 → 测试 → commit → 对 main diff → 下一任务。重复到 session 目标完成，再写一段总结进 PR。

FAQ

  • 单个 agent 任务该多大？: 1-3 个文件，diff 200 行内。更大 review 就崩。
  • Agent 该跑我的测试吗？: 该，但你核对测试数和通过失败状态。有 agent 会把”测试通过”总结出来其实是跳过了。
  • 长 session 怎么办？: 无人值守不超过 30 分钟。再久注意力会漂，坏 diff 溜过去。
  • Agent 能开 PR 吗？: 用 GitHub 集成可以——见 Claude GitHub 集成工作流。
  • 遇到 merge 冲突怎么办？: 自己先解决，再让 agent 做下一步。Agent 解冲突很糟。
  • 小任务能跳 planning prompt 吗？: 一行修复可以；涉及多于一个函数就先 plan。

容易踩的坑

  • 一次让它跨多文件大改——拿到没法 review 的 diff。
  • 任务之间不 commit——两步之后坏了没法 bisect。
  • 不维护 CLAUDE.md——过期约定比无规则更让 agent 糊涂。
  • 因为”这很简单”跳 planning prompt——简单任务也会打包 creep。
  • 每条命令都无脑同意——危险那条迟早溜过去。
  • 把 agent 当架构决策权威——它执行快，但”该不该”不够稳。

相关阅读

标签: #Claude #教程 #Claude Code

相关文章