用 Claude 完成一次完整开发任务

让 Claude Code 动手

上一节我们有了干净的 todo-app 目录、完整的需求文档（README.md）和项目约定（CLAUDE.md）。这一节，让 Claude Code 把它实现出来。

在项目目录里启动：

claude

---

第一次实现

对它说：

读一下 README.md 和 CLAUDE.md，把这个终端待办工具实现出来。

观察它怎么做：先读 README 和 CLAUDE.md 了解需求与约定，然后写出 index.js、可能建 todo.txt，再跑命令测试。看操作轨迹，你会理解它是怎么一步步实现的。

---

让它解释，别只让它写

实现完，继续追问：

把 index.js 给我讲一遍：它是怎么实现 list、add、done、del 这四个命令的？

这一步很重要——别只当一个「验收官」，要听懂它写的代码。这既是学习，也是审查的前提。

---

安全开关：让改动可撤销

我们要求「先预览再执行」。让它把它做成命令行选项：

按 README 要求，每个操作执行前都要先打印"将做什么"，确认后才真正执行。
尤其删除操作，删之前必须明确提示要删的是哪条。

这样工具默认「先预览、不动手」，你确认后才真正改——非常安全的做法。

---

测试 + 验收

让它给自己补个测试，然后你亲自验证：

帮我写几个测试用例，覆盖：添加一条、添加空名称、标记完成、删除、没有待办时显示"暂无待办"。

然后你自己亲手跑一遍：

node index.js list                      # 应该显示「暂无待办」
node index.js add "买牛奶"               # 应该打印确认，然后添加
node index.js add ""                    # 应该提示「名称不能为空」
node index.js list                      # 应该看到「买牛奶」
node index.js done 1                    # 标记第 1 条完成
node index.js list                      # 应该看到 [x] 买牛奶

你亲手验证通过，才算这个任务真的完成。

---

用自定义命令收尾

最后，用我们第 3 模块造的 /review-todo 命令做一次收尾审查：

/review-todo

它就会按之前固化的规则（空状态、名称非空、边界情况）审查一遍。这正是自定义命令的意义——一次定义，反复复用。

---

完整闭环复盘

到这，你走通了完整的 AI 结对编程闭环，并且用上了贯穿项目的所有技能：

环节	你怎么做的
描述需求	写了 README，让 AI 读
记忆偏好	写了 CLAUDE.md，它自动遵守
AI 实现	它写了 index.js
让它解释	听懂了核心逻辑
加安全开关	迭代加了「先预览再执行」
测试验收	造数据、跑命令、亲眼验证
复用命令	用 /review-todo 收尾审查

这正是本课程反复强调的「你描述、它执行、你审查」。

---

落地练习：让 todo 真正属于你

现在让这个工具「活」起来，加上你自己的东西：

1. 用 node index.js add "我的第一个待办" 添加一条你自己的待办
2. 用 done 完成它，用 list 查看
3. 试着让 Claude 加一个新功能——比如「给待办加优先级」：

给 todo 加一个功能：add 时支持优先级，比如 node index.js add "重要的事" high，
然后 list 时按优先级排序。记得遵守 CLAUDE.md 的约定。

怎么判断做对了？——你能用命令行正常添加、查看、完成、删除待办，且让 Claude 帮你加了优先级后还能正常跑。这个工具现在是「你的」了，不再是练习品。

卡住了怎么办？ 命令报错？把报错直接贴给 Claude 让它修。功能加得乱七八糟？用 /clear 开新会话重来，或 /review-todo 让它自查。加完乱了想重来？删掉 index.js 让它按 README 重写。

---

常见坑：做出来就跑，没验收

最大的坑是：Claude 说「完成了」，你一看没报错就以为好了，收工。

必须亲手验收——造真实数据、跑每个命令、看边界情况（空名称、无待办、删不存在的序号）。AI 说「完成」和「真的能用」是两回事。这一步是你作为「结对工程师」不可推卸的责任，也是全课学到的核心习惯。

---

小结

这门课到此结束。你已具备：

1. 安装 Claude Code 并接上国内大模型（DeepSeek）
2. 在终端里操作、与它对话
3. 用斜杠命令、CLAUDE.md、自定义命令提速
4. 独立完成一个贯穿全程的真实项目——todo 终端待办工具
5. 养成「你描述、它执行、你审查、亲手验收」的习惯

下一步，进入进阶实战：学会用子 Agent、计划模式、技能系统，把工作流从「一问一答」升级为「多 Agent 协作」。