7.1 Web 项目实战路径¶
这一练习只做一个小型 Web 功能。不要在初始阶段让 Codex、Claude Code 或 OpenCode 从零生成大型项目；应先限定范围、输入约束和验收标准，以降低后续维护成本。
推荐练习¶
可以实现一个 notes CRUD，把范围限制到可验证的最小集合：
- 列表。
- 新建。
- 编辑。
- 删除。
- 本地或数据库持久化。
- 最少一条测试。
执行步骤¶
任务 1：写 PRD¶
Goal:
实现 notes CRUD 最小功能。
Out of Scope:
不做协作、不做富文本、不做分享。
Done When:
新增 note 后刷新仍存在；
删除后列表消失；
相关测试通过。
任务 2：让 Agent 只读分析¶
先不要修改文件。请阅读项目结构、路由、数据层和现有测试，给出实现计划。
任务 3：小步实现¶
顺序：
flowchart LR
A[数据模型] --> B[API]
B --> C[UI]
C --> D[测试]
D --> E[验证]不要让 Agent 一次性实现完整 CRUD。每完成一步都应能够检查 diff 并运行验证。
任务 4：验证¶
至少留下这些证据：
- 跑单测。
- 跑 typecheck。
- 看 diff。
- 手动试一遍主要路径。
练习重点¶
这次要练的是：
- PRD 是否清楚。
- Agent 是否先读代码。
- 计划是否可审。
- 验证是否闭环。
- 错误是否沉淀到规范。