代码语言

知识点思维导图

23 个知识节点

参考资料

Claude Code（22） - 综合实战与最佳实践心法

读完后，你应能完成以下任务：

绘制“Claude Code（22） - 综合实战与最佳实践心法 / 实战一：从零搭一个小项目”的关键对象与数据流，解释“心法：立规矩 → 先规划 → 分步实现+审查 → 补测试验证 → Git 收尾。”，并用源码位置、日志或 Trace 标注证据。

为“Claude Code（22） - 综合实战与最佳实践心法 / 实战二：在陌生代码库修 Bug 并重构”设计正常与异常输入，验证“场景：接手一个没碰过的项目，有个「偶发的下单失败」要修。”，输出首个偏差位置与回归测试结果。

实现“Claude Code（22） - 综合实战与最佳实践心法 / 贯穿全书的心法（重点记这些）”的最小代码或配置，检验“与其纠结「怎么把话说得花哨」，不如把任务输入结构化：目标、相关文件（用 @）、约束边界、验证方式，一次给足。”，输出命令、结果与 Diff，并说明不适用边界。

本章目标：串起全书能力跑一遍真实闭环；总结贯穿全书的高效心法。

恭喜你走到这里。前面 21 章是一个个「招式」，这一章把它们连成「套路」——先看两个完整实战，再提炼可迁移的心法。

一、实战一：从零搭一个小项目

场景：做一个命令行的「待办清单」小工具，带测试。

1.（立规矩，第05章）我要用 Node 做个命令行待办工具。
   先帮我起草一份 CLAUDE.md：约定用 commonjs、2空格缩进、每个函数带中文注释、改完跑 node 测试。

2.（先规划，第06章）进入 Plan Mode。
   先别写代码，给我一份实现计划：要哪些文件、每个文件职责、先做哪步。

3.（分步实现，第03/04章）按计划第一步：先实现数据存取层 storage.js，只这一个文件。
   （审查 diff，认可后继续下一步）

4.（补测试，第08章）给 storage.js 补测试，覆盖空数据、重复项等边界，然后跑测试，全绿才算完成。

5.（收尾，第09章）帮我看 git diff 确认无误，开分支提交，commit message 按 Conventional Commits 写。

心法：立规矩 → 先规划 → 分步实现+审查 → 补测试验证 → Git 收尾。不是「一句话生成整个项目」，而是带着它走完工程闭环。

二、实战二：在陌生代码库修 Bug 并重构

场景：接手一个没碰过的项目，有个「偶发的下单失败」要修。

1.（理解，第07章）给我这个仓库的概览，重点讲下单流程怎么走。

2.（并行研究，第11章）用独立子代理并行研究 订单、库存、支付 三个模块，分别给我职责和关键函数。

3.（追链路，第07章）追踪从「点击下单」到「扣库存」的完整代码路径。

4.（诊断，第06章 Plan Mode）下单偶发失败。先别改，分析可能的根因（重点看并发/竞态）。

5.（修复+验证，第07/08章）按你说的根因修复，补一个能复现该并发场景的测试，跑测试全绿才算完成。

6.（自动化护栏，第18/20章）给项目加个 PostToolUse hook：改完文件自动跑 lint；
   再给我一份 GitHub Action，让以后每个 PR 自动做安全审查。

心法：理解全局 → 并行摸清模块 → 追链路锁定 → 诊断根因 → 修复+补测试 → 加自动化护栏。

三、贯穿全书的心法（重点记这些）

3.1 心法 1：上下文比提示技巧更重要

与其纠结「怎么把话说得花哨」，不如把任务输入结构化：目标、相关文件（用 @）、约束边界、验证方式，一次给足。结构化的输入大幅减少它的猜测空间，产出更稳定、更可审查。

临时指令写在对话里，长期规则写进 CLAUDE.md。

3.2 心法 2：复杂任务先规划再执行

复杂需求直接让它写代码，常常逻辑错、反复改。更有效的是先让它出计划（Plan Mode），认可后再实现。从「即时生成代码」变成「按计划逐步完成」。

3.3 心法 3：让它参与完整开发闭环

别只把它当「代码生成器」。让它走完实现 → 写测试 → 跑测试 → lint/类型检查 → 审查 diff。它从「code generator」升级成「开发循环里的 execution node」。

3.4 心法 4：会话管理 = 上下文治理

会话不是聊天记录，而是一条持续积累上下文的工作线程：任务目标、相关代码、已做的改动、推理过程都在里面。管不好就会变乱、变贵、变笨。实践要点：

一个会话一个任务主线，别在同一线程里堆无关任务；
换任务就 /clear 翻篇；
把探索、跑测试这类「脏活」交给子代理，保持主上下文干净（第 11 章）；
任务太大撞上下文墙，升级 Agent Team（第 12 章）。

3.5 心法 5：规则可执行、流程可沉淀

规则写成可检查、可执行的（第 05 章）：「2 空格缩进」「改完跑 pnpm test」，而非「保持整洁」。
反复出现的流程沉淀下来：一段提示常用就做成自定义命令（第 10 章）/ Skill（第 18 章）；稳定了就 Automation 自动跑。

3.6 心法 6：按风险放手，按规模选工具

放手程度按风险定：不熟/高危用「询问」，体力活用「接受编辑」，可控环境才 bypass（第 06 章）。
并行工具按需求选：要结果用 Subagent，要协作用 Agent Team，文件隔离用 Worktree，长任务丢后台 + claude agents 监控（第 11-14 章）。
自主程度按场景选：周期查用 /loop，干到成用 /goal，实时盯用 Monitor（第 15-17 章）。

四、能力版图：一句话记住每块拼图

CLAUDE.md 管「始终在的上下文」，Skills 管「按需的知识和工作流」，MCP 管「外部连接」，Subagents 管「隔离」，Hooks 管「自动化」。

再加上本书的另外几块：

权限 / Plan Mode：管「安全地放手」；
Subagent / Team / Worktree / 后台：管「并行规模化」；
/loop / /goal / Monitor / Automation：管「自主运行」；
--remote / -p / Action / SDK：管「远程与无头」。

合起来，就是从「敢用」到「用得好」的完整能力图。

五、常见误区总复盘

把 AI 当甩手掌柜：它是需要 Code Review 的同事，产出永远要你审查。
模糊需求硬上：想不清就先用 Plan Mode 聊清楚，别让它瞎猜。
一个会话用到底：上下文越堆越脏，换任务勤 /clear、善用子代理。
过度自动化/过度组队：偶尔用对话解决就行，反复才固化；要结果别硬组队。
无视安全边界：高危操作、密钥、生产数据、外部不可信输入，时刻设防。

六、给你的下一步

挑一个真实项目，从写 CLAUDE.md 开始，把本书心法用上去。
从单兵到规模化循序渐进：先把第 07 章的「理解-查找-修复」练成肌肉记忆，再上并行和自主。
沉淀你自己的工具箱：把高频流程做成命令/Skill，配上 Hooks 和 CI。
回看两篇专题笔记（常用工作流.md、最佳实践.md），它们是本书心法的速查卡。

七、动手实践：Demo 22 · 综合实战剧本 + 心法速查卡

本章是全书收尾。Demo 提供两份可直接用的资产：

7.1 文件

实战剧本.md：两条端到端对话剧本（从零搭项目 / 陌生库修Bug重构），照着发即可走完整闭环。
心法速查卡.md：六大心法 + 能力版图，打印贴墙用。

7.2 怎么用

挑一个你的真实项目，打开 实战剧本.md，按剧本逐步和 Claude Code 对话。
把 心法速查卡.md 当日常提醒，遇到选择困难（用哪种并行/自主工具）翻一翻。

7.3 实践目标

本 Lab 用最小输入验证“Demo 22 · 综合实战剧本 + 心法速查卡”的核心行为。先按上文命令运行基线，记录输入、关键中间状态和最终输出；再只修改一个参数或一个分支，比较结果差异。不要在第一次运行时同时更换依赖、模型和数据，否则失败后无法定位变量。

7.4 实践验收

7.5 常见问题

7.6 配套实践材料

以下材料已并入正文，便于阅读时直接对照和练习。

实战剧本.md

# 端到端实战剧本（照着发给 Claude Code）

## 剧本 A：从零搭一个带测试的小项目
1. 起草 CLAUDE.md：约定语言/缩进/注释/测试命令（第05章）
2. 进 Plan Mode，要实现计划，先别写代码（第06章）
3. 按计划分步实现，每步审查 diff（第03/04章）
4. 补测试覆盖边界，跑测试全绿（第08章）
5. 开分支、提交、提 PR（第09章）

## 剧本 B：陌生代码库修 Bug + 重构
1. 要仓库概览，讲清核心流程（第07章）
2. 用独立子代理并行研究相关模块（第11章）
3. 追踪完整代码链路（第07章）
4. Plan Mode 诊断根因，先别改（第06章）
5. 修复 + 补可复现的测试，跑测试全绿（第07/08章）
6. 加 PostToolUse hook 自动 lint + GitHub Action 自动审查（第18/20章）

## 闭环口诀
立规矩 → 先规划 → 分步实现+审查 → 补测试验证 → Git收尾 → 加自动化护栏

心法速查卡.md

# Claude Code 心法速查卡

## 六大心法
1. 上下文 > 提示技巧：结构化输入（目标+@文件+边界+验证）
2. 复杂任务先规划再执行（Plan Mode）
3. 让它参与完整闭环：实现→测试→跑→lint→审查
4. 会话管理 = 上下文治理：一会话一主线，勤 /clear，脏活给子代理
5. 规则可执行、流程可沉淀：命令/Skill/Hook/Automation
6. 按风险放手，按规模选工具

## 能力版图（一句话记牢）
CLAUDE.md=始终在的上下文 | Skills=按需知识/工作流 | MCP=外部连接 |
Subagents=隔离 | Hooks=自动化

## 选工具速查
- 并行：要结果→Subagent；要协作→Agent Team；文件隔离→Worktree；长任务→后台+claude agents
- 自主：周期查→/loop；干到成→/goal；实时盯→Monitor；定时无人值守→Automation
- 远程无头：脚本→claude -p；团队CI→GitHub Action；产品集成→SDK；离开电脑→web/手机

## 安全红线
AI产出必审查 | 高危操作设防 | 密钥进环境变量 | 外部数据当不可信

八、总结

实战一：从零搭一个小项目：心法：立规矩 → 先规划 → 分步实现+审查 → 补测试验证 → Git 收尾。
实战二：在陌生代码库修 Bug 并重构：场景：接手一个没碰过的项目，有个「偶发的下单失败」要修。
贯穿全书的心法（重点记这些）：与其纠结「怎么把话说得花哨」，不如把任务输入结构化：目标、相关文件（用 @）、约束边界、验证方式，一次给足。
能力版图：一句话记住每块拼图：合起来，就是从「敢用」到「用得好」的完整能力图。
常见误区总复盘：把 AI 当甩手掌柜：它是需要 Code Review 的同事，产出永远要你审查。 -> 模糊需求硬上：想不清就先用 Plan Mode 聊清楚，别让它瞎猜。 -> 一个会话用到底：上下文越堆越脏，换任务勤 /clear、善用子代理。 -> 过度自动化/过度组队：偶尔用对话解决就行，反复才固化；
给你的下一步：挑一个真实项目，从写 CLAUDE.md 开始，把本书心法用上去。 -> 从单兵到规模化循序渐进：先把第 07 章的「理解-查找-修复」练成肌肉记忆，再上并行和自主。 -> 沉淀你自己的工具箱：把高频流程做成命令/Skill，配上 Hooks 和 CI。 -> 回看两篇专题笔记（常用工作流.md、最佳实践.md），它们是本书心法的速查卡。