第 06 课 | 第六幕：收尾

第六幕：收尾（第13-14集）

从"能用"到"交付"

第13集：怎么知道做完了？——验证方法论

场景：代码写完了，但怎么确认真的做完了？

• 验证不是跑一遍测试就完了
• 目标回溯：从 Phase 目标倒查，每个"必须为真"的陈述都验证了吗？
• /gsd-verify 做什么：独立 agent 读 PLAN.md 目标 → 检查代码 → 生成 VERIFICATION.md
• 代码审查：/gsd-code-review 多维度扫描（安全/性能/可维护性），严重性分级（Critical/High/Medium/Low）
• 修复流程：审查发现问题 → /gsd-code-review-fix 自动逐条修复
• 全项目 154 个测试通过意味着什么（覆盖了什么，没覆盖什么）
• 核心概念：做完 ≠ 做对，验证是独立的步骤

产出文件：

• .planning/phases/*/VERIFICATION.md — 4 份验证报告
• .planning/phases/*/REVIEW.md — 审查报告

对应命令：/gsd-verify，/gsd-code-review

---

第14集：回顾——从一句话到完整产品

场景：收工。回头看看这一路做了什么。

• 起点："做个计算器，老人也能用"（一句话）
• 终点：3 文件 / 1529 行代码 / 1631 行测试 / 154 测试全通过
• 完整文件清单和各自的作用：
  • index.html — 57 行，语义化结构，ARIA 完整
  • style.css — 535 行，CSS 变量双主题，3 断点响应式
  • app.js — 937 行，四层架构（引擎/状态机/UI/持久化）
  • .planning/ — 项目规划全记录（需求/路线图/决策/计划/验证）
• 踩坑清单：浮点精度、CSS Grid 隐藏元素、file:// 协议限制
• GSD 工作流回顾：
  • /gsd-new-project — 想法 → 结构化
  • /gsd-discuss-phase — 锁定决策
  • /gsd-plan-phase — 拆任务
  • /gsd-execute-phase — 写代码
  • /gsd-verify — 验证
  • /gsd-quick — 小修复
• 这套方法能复用到别的项目吗？（能——GSD 适用于任何软件项目）
• v2 展望：科学计算、货币换算、PWA 离线安装

---

附录

A. 本项目用到的 GSD 命令速查

命令	什么时候用	本项目用了几次
/gsd-new-project	有想法，想启动	1
/gsd-discuss-phase	动手前锁定决策	4（每 Phase 一次）
/gsd-plan-phase	把决策拆成任务	4
/gsd-execute-phase	执行任务写代码	4
/gsd-verify	确认做对了	4
/gsd-code-review	检查代码质量	按需
/gsd-quick	小修复	按需
/gsd-debug	调查 bug	按需

B. 技术概念索引

按概念字母排序，标注出现在第几集：

• ARIA labels → 第9集
• CSS Custom Properties → 第8集
• Event Delegation → 第6集
• FIFO Queue → 第5集
• Media Query → 第12集
• Shunting-yard → 第3集
• State Machine → 第7集
• TDD → 第4集
• XSS 防护 → 第11集