用Claude+Trae产出Vibe Coding友好需求文档：完整实战步骤 ​

用AI写文档的核心信条：一旦想手搓就掐手，遇到问题优先向AI提问而非请教人。需求梳理是成功的一大半——自己没想明白就开写，AI误解概率大。

核心信条 ​

如果你准备使用AI来写文档，首先要将思路强行转换为使用AI的模式：

• ⚠️ 所有任务尽量通过与AI对话完成，一旦意识到自己想要手搓就立刻掐手
• ⚠️ 遇到问题优先以不同方式向AI提问，而不是请教周边的人类

工具准备 ​

1. 注册Claude账号，购买付费版本
2. 下载、安装、注册Trae（其他IDE工具也可以）

了解基础能力 ​

打开Trae之后，切换至IDE模式，了解各个分区的作用：

在终端对话区输入"Claude"按回车，如果返回登录账号情况，意味着可以正式开始工作了。

第一步：需求梳理 ​

当有新需求时，先建立一个新文件夹，后续所有关联文件都放在里面。

新建一个文件，用逻辑结构清晰的语言描述要做的需求内容，写完再查漏补缺。这一步做的好就成功一大半了。

• 如果单看文字不好Review，可以先让AI生成思维导图
• 如果自己一开始没想明白，再修修补补不仅浪费时间，AI误解你意思的概率会比较大
• 万一中途需求有变化，先重复需求梳理步骤

第二步：依赖内容整理 ​

把完成需求文档的依赖内容放进来。新项目可能不重要，但如果是在原有系统上优化的需求，给AI的参考越多，输出越贴合实际：

第三步：让AI写文档 ​

让AI根据前面的需求文件写需求文档，并告知它可以参考其他哪些文件。

关于模版：模版的参考意义不大，你完全可以告诉AI你的文档要求（比如增加验收标准、需求要有需求编号），它调整起来非常精确。

Vibe Coding友好格式：程序员喜欢Markdown文档，流程图用Mermaid代码——这些AI都可以轻松做到。

分步生成更可控：

1. 先让AI出业务流程图
2. 确保业务流程图完全没有问题
3. 再让AI出功能细节、交互详情部分

第四步：原型效果图 ​

有些原型需要效果图辅助，让Claude根据需求文档生成HTML文件，打开即可在浏览器中查看页面效果。关键页面截图放在文档里。

第五步：部署分享 ​

如果想让其他人看到这些HTML文件，推荐使用Vercel：

1. 在浏览器打开Vercel网站，完成注册
2. 用命令行将当前文件夹的HTML文件部署上去
3. 生成可以分享给其他人的链接

实现这个能力时可能会遇到挫折——记住核心信条：遇到问题直接问AI。

踩坑提醒 ​

使用过程中会发现一些不便捷的地方：

• 命令行工具对多模态内容展示和编辑不友好
• 无法直接打开小程序
• 页面微调很费时间

遇到这些问题很正常，慢慢探索。但切记：不要总是沉迷于解决工具问题，这样会在探索的支线上花费大量时间，忘记了自己的初衷——快速写个需求文档。

完整工作流总结 ​

需求梳理（用清晰语言描述+查漏补缺）
        ↓
依赖内容整理（历史文档/系统截图/页面截图）
        ↓
AI写文档（先业务流程图→再功能细节→分步更可控）
        ↓
原型效果图（生成HTML→浏览器预览→截图放文档）
        ↓
部署分享（Vercel部署→生成分享链接）

就这五步。简单，但管用。