从 v0.2 到 v1.0 的完整演化
—— 文档驱动的可控迭代实践
系列导读：这是《用一份 .md，把想法变成产品》系列的第4篇。在前三篇中，我们建立了文档驱动的理念，定义了三份核心文档,并成功实现了博客的 v0.1 和 v0.2。这一篇，我们将经历一个更完整的演化过程，见证文档如何驱动产品从简单原型走向可用系统。
开篇：卡比的新旅程
v0.2 上线后，卡比的博客已经可以渲染单篇 Markdown 文章了。访问 /posts/hello-world 能看到精美排版的内容，代码高亮正常，SEO 标签完整。
但卡比很快意识到一个问题："只有一个文章详情页，但没有入口，读者怎么发现我的文章？"
于是，卡比列出了接下来需要的功能：
-
文章列表页：让读者能浏览所有文章
-
分页功能：避免列表过长影响性能
-
分类系统：按主题组织文章
-
标签功能：多维度查找内容
-
搜索功能：快速定位文章
-
RSS 订阅：支持读者订阅更新
看着这个列表，卡比感到有些焦虑。"这么多功能，从哪里开始？优先级怎么定？万一做到一半发现方向错了怎么办？"
这时，卡比想起了文档驱动开发的核心理念："不要一次做太多，要渐进式演化。"
卡比决定：先规划版本路线，然后一步一步来。
一、版本规划：从混乱到清晰
1.1 先问自己三个问题
卡比没有急着动手，而是先整理思路：
问题 1：v1.0 的最小可用版本是什么？
- 回答：一个完整的博客系统，能够让读者浏览、发现、阅读文章
问题 2：从 v0.2 到 v1.0 需要哪些关键能力？
-
文章发现：列表页、分页
-
内容组织：分类、标签
-
功能增强：搜索、RSS（可选）
问题 3：这些功能的依赖关系是什么？
-
列表页 → 依赖：文章读取逻辑（v0.2 已有）
-
分页 → 依赖：列表页
-
分类/标签 → 依赖：文章读取逻辑（需扩展文章元信息）
-
搜索 → 依赖：列表页、分类/标签
1.2 版本规划表
基于以上分析，卡比制定了清晰的版本规划：
| 版本 | 核心功能 | 文档变更重点 | 预期完成时间 |
|---|---|---|---|
| v0.3 | 文章列表 + 分页 | spec.md: 新增列表功能<br>plan.md: 数据读取优化 | 1 天 |
| v0.4 | 分类和标签系统 | spec.md: 新增分类/标签筛选<br>plan.md: 文章元信息扩展 | 1 天 |
| v0.5 | 搜索功能（计划中） | spec.md: 搜索交互设计<br>plan.md: 搜索算法选型 | 1 天 |
| v0.8 | 性能优化 + SEO | plan.md: 缓存策略、构建优化 | 1 天 |
| v1.0 | 完整交付 | 所有文档的最终版本 | - |
关键原则：
-
✅ 每个版本只做一件核心的事
-
✅ 每个版本都是可用的（不是半成品）
-
✅ 版本之间有清晰的依赖关系
-
✅ 文档先于代码更新
1.3 更新 intent.md
虽然核心意图没变，但卡比决定在 intent.md 中增加版本规划：
版本演化路线（v0.2 → v1.0）
短期目标（v0.3 - v0.4）
-
v0.3：实现文章发现机制（列表 + 分页）
-
v0.4：建立内容组织体系（分类 + 标签）
中期目标（v0.5 - v0.8）
-
v0.5：增强用户体验（搜索）
-
v0.8：优化性能和 SEO
长期目标（v1.0）
-
完整、可维护、可演化的博客系统
-
完善的文档支持后续扩展
为什么要更新 intent.md？
-
记录决策过程：为什么选择这个顺序？
-
给未来的自己（或团队）提供上下文
-
避免迷失方向：时刻提醒自己"做到哪一步了"