Vibe Coding 活文档

问题从哪来

很多项目的 PRD、架构说明和页面结构写在 Notion 或一次性 Markdown 里，跑通第一个 demo 之后就不再改；栈选型、模块边界和鉴权/data flow 只留在对话记录里，发版前靠回忆补文档。结果是「setup doc」和真实系统长期脱节。

技能如何工作

vibe-coding-live-docs 在仓库里维护一套 project-docs/ 活文档，用 Draft → Confirmed → As-Built 三态表达「假设、已拍板、已交付」，并在里程碑与事件触发时更新，而不是等到 release。

典型骨架：

• project-docs/PRD.md：产品意图、用户旅程、验收与页面摘要
• project-docs/ARCHITECTURE.md：当前架构、模块、数据流、鉴权与 as-built 结构
• project-docs/PROJECT_STATE.md：文档债务、最近确认、下一更新节点、冻结决策（同步控制塔）
• 多页 UI 时加 project-docs/PAGE_FRAME.md；非 trivial 技术选型加 project-docs/TECH_DECISIONS.md

工作流要点：识别是新项目、大特性还是文档漂移清理；若 PRD 输入是会议纪要、粗糙 brief 等杂乱材料，可先走推荐子技能 $prd-creater 生成结构化初稿，再映射进 PRD.md 并挂上生命周期元数据；不确定内容留在 Draft，首版可运行或重大决策稳定后升到 Confirmed，发版或交接前把关键文档升到 As-Built。决策历史进 TECH_DECISIONS.md，页面结构进 PAGE_FRAME.md，避免 PRD.md / ARCHITECTURE.md 膨胀。

触发矩阵覆盖：项目启动、首版可运行、核心流程稳定、发版准备；以及栈锁定、页面框架锁定、模块边界变更、鉴权或数据流变更、第三方依赖选定或替换等事件。

适用边界

已有成熟 PRD、只需小范围状态更新、或不想要 Notion 式 PRD 流程时，不必强行走 $prd-creater，直接维护活文档即可。常见失误包括：过早写满细节却从不回访、只改 PROJECT_STATE.md 却不动架构/页面文档、把 Draft 当临时草稿而非有意阶段、以及发版前从记忆里重建文档。