欢迎来到项目展示与讨论区。这里不仅是展示成果的画廊，更是思想碰撞的广场。

在这个系列中，我们不仅谈论理论，更强调实战。这里汇集了我们在文章中构建的实际项目演示、系统架构设计图，以及供大家延伸讨论的话题空间。

📖 如何使用本页

  • 🎨 想看成果？ → 跳转到"实战项目展示"，查看在线演示

  • 🏗️ 想了解架构？ → 查看"系统架构与工作流"的可视化图表

  • 💬 想参与讨论？ → 在"讨论与交流区"找到你感兴趣的话题

  • 🤝 想做贡献？ → 阅读"社区贡献指南"了解如何参与

1. 实战项目展示

这是我们"从零到一"构建的成果。你可以点击链接亲自体验，看看文档驱动开发到底能产出什么样的产品。

🏠 Landing Page (v0.1 起点)

这是我们在第 1-2 篇中构建的静态首页。它代表了项目的起点——一个简单的想法是如何通过一份 intent.md 变成现实的。

  • 在线演示：👉 🔗 查看 Landing Page Demo

  • 核心特点：

    • 极简设计，专注于个人介绍

    • 完全响应式（移动端适配）

    • 无复杂逻辑，纯静态展示

🚀 博客系统 (v1.0 终点)

这是经过 8 篇文章演化后的完整形态。它不再是一个玩具，而是一个生产就绪的内容平台。

  • 在线演示：出于知识产权保护考虑，完整的博客系统源码暂不公开演示。如果你跟随系列文章实践，你将拥有属于自己的完整版本。

这个系统的价值不在于「看」，而在于「做」。我们鼓励你用文档驱动的方式，亲手构建出属于你自己的博客系统——那才是真正的学习。

  • 主要功能清单：

    • ✅ 全文搜索：基于 Fuse.js 的即时搜索

    • ✅ 多维度分类：支持 Category 和 Tags 筛选

    • ✅ 多作者系统：支持团队协作和专栏展示

    • ✅ 极致 SEO：自动生成 Sitemap 和 Meta 标签

    • ✅ 国际化：中英文一键切换

    • ✅ 高性能：Lighthouse 评分 95+

2. 系统架构与工作流

为了让你更直观地理解系统是如何运作的，我们整理了以下架构图。

🏗️ 博客系统技术架构图

这张图展示了 Next.js、Markdown 内容层和部署环境是如何交互的。

An image to describe post

  • 前端层 (Frontend): Next.js 14 (App Router), React, Tailwind CSS

  • 数据层 (Data): 本地 Markdown/MDX 文件, Frontmatter 元数据

  • 构建层 (Build): 静态站点生成 (SSG), 搜索索引生成

  • 部署层 (Deploy): Vercel Edge Network, CDN 加速

🔄 文档驱动工作流图

这张图展示了从想法到代码的完整流动过程，以及 AI 在其中的角色。

An image to describe post

  • 核心流向: Intent (Why) → Spec (What) → Plan (How) → Code (Implementation)

  • 关键动作: 澄清需求、更新文档、生成代码、Code Review

3. 讨论与交流区

文档驱动开发不是教条，而是一个不断演化的实践。我们非常期待听到你的声音。请在评论区（或对应的社区频道）参与以下话题的讨论：

💡 开放讨论空间

这里欢迎所有声音——无论是赞同、质疑还是批评。

  • ✓ 分享成功案例，也分享失败教训

  • ✓ 提出不同观点，帮助完善方法论

  • ✓ 没有"标准答案"，只有"更好的实践"

请尊重每一位参与者，让讨论聚焦于问题本身，而非人身攻击。

💬 你的实践故事

引导问题：

  • 你尝试用文档驱动开发做了什么项目？

  • 你真的坚持下来了吗？如果没有，是在哪个环节放弃的？

  • 分享一个你觉得"文档救了我一命"的时刻。

🤔 方法论讨论

引导问题：

  • 你觉得对于单人开发者，写三份文档（Intent/Spec/Plan）是不是太重了？

  • 你如何处理"灵光一现"和"文档约束"之间的冲突？

  • 在你的团队中推广这套方法论，最大的阻力是什么？

🛠️ 工具与技巧

引导问题：

  • 你发现了哪些好用的 Prompt 技巧，能让 AI 生成的代码质量更高？

  • 除了 Cursor，还有什么工具能完美配合这套流程？

  • 你如何管理文档的版本控制？

🐛 问题求助

引导问题：

  • 如果你在实践中卡住了，请在这里描述你的困难。

  • 遇到了 AI 无法理解文档的情况？贴出你的文档片段，大家一起看看。

💡 改进建议

引导问题：

  • 这个系列文章有哪些地方没讲清楚？

  • 你希望看到更多哪方面的实战案例？

4. 社区贡献指南

这个系列和配套资源是开源且开放的。如果你想为它添砖加瓦，可以通过以下方式参与：

  1. 分享案例：如果你用这套方法做出了有趣的项目，欢迎提交 PR 将你的项目链接添加到本页的展示区。

  2. 改进模板：如果你优化了 spec.md 或 plan.md 的模板结构，欢迎提交给我们，造福更多人。

  3. 反馈 Bug：如果在演示代码中发现 Bug，请在 GitHub 仓库提交 Issue。

让我们一起，探索 AI 时代更优雅的开发方式。

#文档驱动 #实战开发 #社区共创