你丢需求，AI 帮你整理成 PRD。

---

Product-OS 用于把 PM 放在 01_Input/ 的原始材料，整理成可追踪、可交付、可恢复的需求主链路文档。

主目标不是"自动补全需求"，而是把已有输入整理为稳定的工作台与交付物，避免流程失控。

第一次使用？ 请先阅读 5 分钟上手指南，配合 examples/ 目录中的完整示例快速了解流程。启动 npm run docs 可以在浏览器中查看完整文档。

---

适用场景

• PM 已经提供原始需求材料，但格式不统一
• 原始输入可能来自 PDF、飞书文档摘录、语音转文字、截图说明、零散文字
• 希望先形成 _WORK_SHEET.md 工作台，再继续补问题、生成 PRD
• 希望把"待确认问题""当前状态""输出文件"放在同一主链路中管理
• 需要明确区分：当前不能正式生成 / 可以先出草稿 / 可以正式生成 PRD

---

不适用场景

• 希望 AI 自行设计完整产品方案
• 希望 AI 在原始输入缺失时自动补齐业务规则
• 希望跳过 _WORK_SHEET.md 直接稳定产出正式 PRD
• 希望把前端页面、流程图、原型图等扩展技能自动混入主流程
• 希望在没有 @代码文件 的情况下，让 AI 编造"现状逻辑"

---

主链路步骤

Product-OS 的主链路围绕 3 个核心对象：

• 01_Input/：原始输入
• _WORK_SHEET.md：主流程唯一状态源
• 03_Output/：最终输出

Step 1：整理需求

触发词：整理 / 整理一下

执行结果：

• 读取 01_Input/ 中的原始材料
• 如果存在 01_Input/Context.md，一并读取
• 只生成或更新 _WORK_SHEET.md
• 不生成正式 PRD

此时 _WORK_SHEET.md 的状态通常为：

• pending：有待确认问题
• ready：待确认问题已清零

Step 2：确认状态

正式生成前，必须先看 _WORK_SHEET.md 中的状态块。

状态	含义	允许正式生成	允许草稿
pending	仍有待确认问题	否	是
ready	待确认已清零	是	是
draft	已生成草稿，仍未达正式条件	视待确认是否清零	是
completed	正式 PRD 已生成	再次生成需新建文件	是

Step 3：生成 PRD

触发词：生成文档 / 生成PRD

系统必须先判断 _WORK_SHEET.md 当前状态：

情况 A：状态为 pending

• 正式 PRD：拒绝生成
• 草稿 PRD：允许，输出独立 _draft.md

情况 B：状态为 ready

• 允许生成正式 PRD → 03_Output/
• 默认不覆盖已有文件

情况 C：状态为 draft

• 若待确认仍未清零 → 禁止正式生成
• 若待确认已清零 → 先更新为 ready，再正式生成

情况 D：状态为 completed

• 再次生成 → 默认创建新文件，不覆盖原文件

---

指令对照表

指令/触发词	行为	结果
整理 / 整理一下	执行需求整理	只更新 _WORK_SHEET.md
生成文档 / 生成PRD	尝试生成正式 PRD	若状态非 ready，拒绝正式生成
生成草稿 / 出草稿 / 草稿PRD	生成草稿	输出独立 _draft.md，不替代正式 PRD
完整生成	先整理，再等待确认	不得绕过待确认直接正式生成
精简一下 / 精简PRD / 出精简版	精简正式 PRD	输出 PRD_*_light.md
扫描代码	仅在用户 @代码文件 时进行	为"现状逻辑"提供代码依据

---

失败恢复

场景 1：只整理了一半

• 回到 _WORK_SHEET.md
• 检查状态块、待确认列表、输入来源
• 补齐后继续，不要跳过工作台直接出 PRD

场景 2：用户要求直接生成正式 PRD，但仍有待确认

• 拒绝正式生成
• 提示用户先清零待确认，或改为生成草稿 _draft.md

场景 3：没有 @代码文件，但需要"现状逻辑"

• 保留"现状逻辑"章节
• 明确标记：待扫描
• 不得编造现状逻辑

场景 4：目标输出文件已存在

• 默认不覆盖
• 创建新文件名继续输出

场景 5：扩展技能干扰主流程

• 先完成主链路：整理 → 状态确认 → 生成/拒绝
• 扩展技能只能在用户明确提出时单独执行
• 不得自动插入主流程

---

输出规则

_WORK_SHEET.md 是唯一状态源

主链路里所有状态判断只认 _WORK_SHEET.md，包括：

• 当前需求是否已整理
• 是否仍有待确认问题
• 是否允许正式生成 PRD
• 是否已经生成过草稿或正式文档

草稿模式

• 必须输出独立文件，文件名包含 _draft
• 草稿不能伪装成正式 PRD
• 草稿生成后，_WORK_SHEET.md 状态标记为 draft

默认不覆盖已有文件

若目标文件已存在：自动追加序号 / 提升版本号 / 生成带日期的新文件名。

---

目录说明

01_Input/           原始输入区（把需求材料丢这里）
03_Output/          最终交付物区（PRD 在这里生成）
_WORK_SHEET.md      主流程唯一状态源
docs/               文档站源文件（npm run docs 启动）
docs/templates/     PRD 模板
examples/           完整示例（输入 → WorkSheet → PRD → 精简版）
scripts/            工具脚本

命名规范

• 日期格式：YYYYMMDD
• 版本格式：v1.0、v1.1、v2.0
• 功能名：使用下划线，不使用空格
• 正式文档：PRD_{功能名}_v{版本}_{日期}.md
• 草稿文档：PRD_{功能名}_v{版本}_{日期}_draft.md

---

核心原则

• 原始输入是唯一事实来源
• _WORK_SHEET.md 是主流程唯一状态源
• 待确认未清零，禁止正式生成 PRD
• 草稿必须独立输出 _draft.md
• 无 @代码文件 时，"现状逻辑"保留但标记"待扫描"
• 扩展技能默认不得自动插入主流程
• 默认不覆盖已有输出文件