MonkeyCode 教程系列 MC-018 | 需求文档(SDD)：专业级的提需求方式

开篇：口头需求 = 反复返工

官网链接注册更放心哦https://monkeycode-ai.com/?ic=019e0aed-c823-783c-b08a-4f030f891e4e

封面：SDD — 专业级提需求

上一期 MC-017，你学会了定时任务——让 AI 按计划自动干活。但无论是手动触发还是定时执行，有一个问题始终存在：你给 AI 的需求描述够清晰吗？

回顾前面的实战，你的需求大概是这样的：

• "帮我做一个个人博客"
• "写一个待办事项应用"
• "把这个按钮改成蓝色"

在小项目中，这种口头描述够用了——AI 足够聪明，能猜出你想要什么。但随着项目复杂度提升，问题就来了：

• "博客要支持 Markdown 渲染"——用哪个库？渲染服务端还是客户端？
• "待办事项要有提醒功能"——怎么提醒？邮件？弹窗？提前多久？
• "按钮改成蓝色"——哪个按钮？什么蓝？hover 效果呢？

每一次模糊描述，都意味着一次返工。SDD（Software Design Document，软件设计文档）就是解决这个问题的。

为什么需要 SDD

口头需求 vs SDD 文档

SDD 的核心理念很简单：把脑子里模糊的想法，变成结构化、可执行的需求文档。

SDD概念图

SDD 三段式结构

SDD 三段式结构

第一段：原始需求

SDD三段式结构图

用一句话说清楚你要做什么。不要解释原理，不要描述实现方式，只说结果。

关键词是简洁。AI 先理解你要什么，再决定怎么做。

第二段：产品设计

描述用户能看到什么、怎么交互。这一段不用写技术细节，聚焦于用户体验：页面结构、交互流程、数据展示。

第三段：技术设计

描述实现方式——技术栈、架构、数据流。如果你不确定，可以让 AI 建议。

让 AI 帮你写 SDD

SDD 实操演示

如果你觉得写 SDD 太麻烦，有个好消息：AI 本身就能帮你写 SDD。

你只需要给出一个粗略的想法，AI 会输出一份结构化的 SDD 文档。你只需要审核和补充，不需要从零开始写。

这是一个很好的工作流：先用 AI 生成初稿 → 你修改补充 → 把最终版 SDD 交给 AI 执行。

进阶技巧

进阶技巧与总结

SDD 迭代原则

SDD 不是写一次就完事的。随着项目迭代：

• 新增功能 → 在对应段落补充
• 修改需求 → 用删除线标记旧需求，下方写新需求
• 版本管理 → 每次 SDD 更新都 commit 到 Git，方便回溯

SDD改写实操对比图

SDD实操演示流程图

SDD 模板

在项目中维护一个 SDD 模板文件，每次新建功能时复制一份，填入内容即可。

总结与下期预告

动手看：改写对比

SDD 核心要点：

• SDD 把模糊想法变成结构化、可执行的需求文档
• 三段式：原始需求 → 产品设计 → 技术设计
• AI 辅助写 SDD：你给粗略想法，AI 生成初稿，你审核补充
• SDD 随项目更新，用 Git 管理版本
• 效果：需求清晰 → AI 一次做对 → 返工大幅减少

基础入门篇理论部分全部结束。下一期 MC-019：从零搭建个人博客站。