Appearance
19 · Capstone 综合实战
📚 系列导航：上一篇 18 入门实战 用单会话跑通了一个最小项目。这一篇拉大——跨会话、接 MCP、派 Subagent、靠检查点兜底，走一趟从开工到交付的完整工程流。
01 全景：六步流程
立项 → 规划 → 接外部 → 分活 → 容错 → 交付
↕（跨会话接力回到规划）真实项目一个会话干不完，验证完一轮会回到「规划」开下一个会话，把功能一块块啃下来。
02 立项：定项目、写 CLAUDE.md、配权限基线
bash
mkdir todo-cli && cd todo-cli && git init
claudetext
帮我在项目根目录建一个 CLAUDE.md，写清这几条：
1. 纯 Python 标准库的命令行工具，不引入任何第三方依赖
2. 数据持久化到项目根 todos.json
3. 每加一个功能配 unittest 测试，改完跑 python3 -m unittest 验证
4. 提交信息用中文，前缀用 feat: / fix: / docs:权限基线： 把反复跑的测试命令加进允许列表，减少审批噪音。
text
/permissions把 python3 -m unittest、git diff、git status 加进 allow。
03 规划：先出 SPEC，再跨会话分步实现
进 Plan Mode（Shift+Tab）：
text
我想做一个命令行任务清单工具 todo-cli，数据存本地 JSON。
用 AskUserQuestion 采访我：技术实现、CLI 接口设计、边界情况。
问完把完整规格写进 SPEC.md。把大活儿切成「一个会话一块」：
text
会话 1：搭骨架——文件结构、todos.json 读写、add 命令 + 测试
会话 2：list 和 done 命令 + 测试
会话 3：边界处理（文件损坏、空清单）+ 补全测试
会话 4：写 README、整体过一遍、交付会话间接力： 新会话第一句：
text
先读 SPEC.md 和 git log 看我们做到哪了，别改任何代码，
告诉我下一块该做什么、有没有遗留的坑。04 接外部：用 MCP 查文档
bash
claude mcp add --transport http claude-code-docs https://code.claude.com/docs/mcp在会话里：
text
用 claude-code-docs server 查一下 subagent 的配置文件怎么配05 分活：派 Subagent 隔离脏活
text
派一个 subagent 去摸清 todos.json 的所有读写都发生在哪些函数里，
只把「哪些文件、哪些函数、各自干啥」的清单报给我，别贴文件全文。06 容错：检查点 + Git 双重兜底
每个会话开工前 git commit 一个干净原点。改坏了先 /rewind，不行就 git checkout。
07 动手：跑通第一个会话
bash
mkdir capstone-demo && cd capstone-demo && git init
claude先 /init 生成 CLAUDE.md，再切 Plan Mode 写 SPEC，然后开始实现第一个功能块。
08 小结
| 环节 | 关键动作 |
|---|---|
| 立项 | git init + CLAUDE.md + 权限基线 |
| 规划 | Plan Mode 采访出 SPEC.md，切块分会话 |
| 跨会话接力 | SPEC.md + git log 当交接班备忘录 |
| 接外部 | MCP server 查文档 |
| 分活 | Subagent 扛脏活，只回结论 |
| 容错 | 检查点 + Git 双重兜底 |
| 交付 | 提交、PR、归档 |
NOTE
下一篇：20 最佳实践五条法则：把零散的好习惯攒成一套能照着做的心法。