阶段缓冲:文档模板沉淀与第三阶段准备

连载走到第二阶段的第 12 天，今天不做新文档。缓冲不是休息，是补给——跑长跑的人都知道，中间那口水不喝，后半程一定崩。今天做三件事：给 11 篇成果清一次账，把模板库从"纸上的目录"落成"能直接开工的文件"，再把第三阶段的工具提前备好。

一、清账：11 篇、8 类文档、42 个 Prompt

先把第二阶段的存量盘清楚，这是你判断"这套方法到底有没有落地"的底数：

比数量更值得看的是反馈。两周下来，评论区问得最多的是三类问题：一是"公司不让用外部大模型，怎么办"；二是"生成得很好，但我不敢直接用，怎么审"；三是"文档写完了，团队没人看"。这三条其实指向同一个答案——AI 生成文档的瓶颈从来不在生成，而在出处、校审和落地机制。前两阶段解决的是前两条，第三条要靠工作流，不是靠工具。

二、模板库 v2：从目录到可开工的文件

Day 24 画了模板库的目录结构，今天把它真正落地。v2 与 v1 的区别只有一句话：v1 是图，v2 是能打开的文件——31 个 Markdown 文件、9 类文档目录，每类固定"模板 + Prompt + 脱敏示例"三件套，外加一个通用目录。

doc-templates/            ← 31 个文件，已打包 zip├── README.md               # 三件套约定 / 命名规范 / 文档链全景图├── 00-通用/│   ├── 文档骨架速查表.md    # 9 类文档的章节骨架，一页纸│   ├── 上下文准备清单.md    # 每类文档开工前要喂给 AI 的材料│   └── 校审四道关.md        # 全文档通用的人工校验清单├── 01-PRD/    模板.md + Prompt.md + 示例-星辰ERP.md├── 02-技术方案/  03-详细设计/  04-测试方案/  05-部署方案/└── 06-项目计划/  07-风险评估/  08-接口文档/  09-运维手册/

三个使用约定，写死进 README：开新文档先复制 模板.md，别从空白页开始；Prompt 与模板同目录存放，用的时候不翻聊天记录；示例一律脱敏，真实项目数据永远不进模板库。模板是活的——每次评审被问住的地方，就是模板缺的那一节，当场回写。

三、读者避坑：五类最常见的失败

征集回来的失败案例，去重之后剩五类。这五条不是 AI 的错，是用法错：

避坑五条：

① 无出处幻觉——AI 编出根本不存在的字段名和数字，对策是每段强制标注出处，没出处的一律待确认；

② 一次生成整篇——直接要"一份完整详细设计"，得到的一定是浅框架，对策是分节生成再组装；

③ 术语漂移——同一个实体，PRD 叫"收货单"、设计叫"入库单"、接口叫"Receipt"，对策是术语表先行，逐篇对齐；

④ 只生成不校审——把 AI 产出当成品直接发,对策是四道校验关一步不省；

⑤ 模板当万能钥匙——拿 PRD 的 Prompt 去写运维手册,对策是上下文准备清单按类照做。

这五条里，最贵的是第①和第④——幻觉让文档不可信，不校审让幻觉流出去。一份被同事信任过的错文档，造成的损失远大于没文档。

四、读者调研：第三阶段该用谁的例子

第三阶段要贴代码，示例语言必须先定。连载统一的虚构项目"星辰 ERP"是 .NET Core + Java Spring Boot 双栈，但每日示例只能取其一，取谁得看你们。请在评论区投一票，格式：语言 + 场景，例如"Java Spring Boot + 后台管理接口"或"Vue + 中后台页面"。

投票选项：

① C# / .NET Core（后端服务）　

② Java / Spring Boot（后端服务）　

③ TypeScript + Vue / React（前端）　

④ Python（脚本 / 数据处理）　

⑤ SQL / 数据库脚本

票数最高的组合，就是第三阶段主力示例。这不只是偏好问题——示例语言和你的日常语言一致，方法才迁移得动；否则你学到的是"AI 写 Java 的样子"，而不是"AI 写你代码的样子"。

五、预告与准备：进第三阶段前，先装好两样东西

第三阶段（Day 26-38）的主线是AI 辅助编程：从工具选型开始，走完代码补全、单元测试生成、遗留代码解读、重构、Code Review、调试排错，最后到 AI Agent 自主完成小任务。它的前置准备只有两件：

工具准备清单：① 主力 IDE——VS Code / Visual Studio / IntelliJ IDEA，任选你日常用的；② 一款 AI 编程工具——本阶段统一用 CodeBuddy（腾讯云代码助手，覆盖插件 / IDE / CLI 三端）作示例：最省事的是把插件装在 VS Code 或 JetBrains 里，想体验 AI 原生编辑器就装 CodeBuddy IDE，个人版免费即可上手，国内网络直达不用额外折腾。先装好、用起来，Day 26 再谈怎么选。

选型时会展开一张对比表：代码补全质量、多文件理解、对话能力、Agent 自主执行、价格、数据合规六个维度。对企业用户，数据合规的权重可能高于能力——代码能不能出内网，往往一票否决。这句话先记着，Day 26 细说。

本篇核心回顾① 第二阶段存量：11 篇、9 类文档、42 个 Prompt、1 条完整文档链② 反馈的共性问题：生成不是瓶颈，出处、校审、落地机制才是③ 模板库 v2 = 能打开的文件：31 个 md、9 类三件套、写死三条使用约定④ 避坑五条：无出处幻觉 / 一次生成整篇 / 术语漂移 / 不校审 / 模板当万能钥匙⑤ 调研先行：投票选出第三阶段主力示例语言，方法才迁移得动⑥ 进第三阶段前只做两件事：装好 IDE，体验至少一款 AI 编程插件

· · · · · ·

——本篇小结——

缓冲篇的价值不在新知识，在把两周的散点收成一张网：11 篇成果有了存量底数，模板库从目录变成 31 个能直接开工的文件，读者踩过的坑被提炼成五条可执行的避坑清单，第三阶段的示例语言交给你们投票决定。第二阶段到此收官，检验标准还是那句话——下个新项目来的时候，你是打开模板库，而不是打开聊天记录。

今日互动：① 评论区投下第三阶段的示例语言票（格式：语言 + 场景）；② 你在"AI 写文档"上踩过最贵的一个坑是什么？