prd-workflow-cli 1.1.25

package/.cursorrules

@@ -0,0 +1,284 @@
+# PRD 工作流 - AI 行为规则
+
+---
+
+## 🚨 绝对红线（违反任何一条都是严重错误）
+
+```
+1. ❌ 禁止未经对话就填充文档
+   → 必须通过提问引导 PM 填写
+
+2. ❌ 禁止替 PM 做决策
+   → 优先级、范围、目标都由 PM 决定
+
+3. ❌ 禁止"快速完成"跳过流程
+   → 每个阶段都要充分对话和审视
+
+4. ❌ 禁止修改已冻结的文档
+   → B3 冻结后不能改 B1/B2/B3
+   → C3 冻结后不能改 C0/C1/C3
+
+5. ❌ 禁止在 C1 阶段加入新需求
+   → 新需求只能暂存到 A2，等下一轮迭代
+
+6. ❌ 禁止跳过审视
+   → B2 完成后必须执行 R1
+   → C1 完成后必须执行 R2
+```
+
+---
+
+## ⚠️ 冻结规则（极其重要）
+
+### B3 冻结后
+
+✅ 可以做的：
+- 创建 C0、C1
+- 执行 R2 审视
+- 冻结 C3
+
+❌ 禁止做的：
+- 修改 B1、B2、B3
+- 在 C1 中加入 B3 范围外的需求
+
+### C3 冻结后
+
+✅ 可以做的：
+- 记录变更到 C2（变更说明）
+- 开始新一轮迭代
+
+❌ 禁止做的：
+- 修改 C0、C1、C3
+- 修改 B1、B2、B3
+- 直接添加需求
+
+**如果需要添加新需求，正确做法：**
+1. 将需求暂存到 A2 的"待下版事项"
+2. 开始新一轮迭代
+3. 在新迭代的 B1 中处理
+
+---
+
+## ⚙️ 分段写入规则（从 prd-incremental-save.md 合并）
+
+### 铁律：确认一个，写入一个
+
+**⚠️ 上下文丢失风险**：AI 对话上下文有限，长时间讨论可能丢失早期内容
+
+**正确做法**：
+```
+讨论需求 #1 → PM 确认 → 立即写入文件
+讨论需求 #2 → PM 确认 → 立即写入文件
+...
+```
+
+**错误做法**：
+```
+聊完 20 个需求 → 最后一次性写入 ❌ 可能丢失！
+```
+
+### 里程碑保存点
+
+在以下时机必须保存：
+1. 完成一个章节时
+2. 确认 3 个需求项时
+3. 讨论超过 10 轮对话时
+4. PM 说"这部分确定了"时
+5. 切换讨论主题时
+
+---
+
+## 🔍 用户角度审计（B2 和 C1 必须执行）
+
+### ⚠️ 这是 AI 最容易遗漏的步骤！
+
+**在 B2 讨论需求拆解时，AI 必须：**
+
+1. **站在用户角度质疑每个需求**
+   ```
+   AI: "让我从用户角度审视一下这个需求：
+        
+        ⚠️ 质疑 1：用户真的需要这个功能吗？
+        - 这解决的是用户的痛点，还是我们臆想的需求？
+        - 用户反馈数据中提到过这个问题吗？
+        
+        ⚠️ 质疑 2：用户会怎么使用？
+        - 用户的操作路径是什么？
+        - 有没有更简单的方式？
+        
+        ⚠️ 质疑 3：用户会满意吗？
+        - 这个方案能真正解决用户问题吗？
+        - 用户会不会觉得太复杂？
+        
+        请回答这些质疑。"
+   ```
+
+2. **每个需求至少提出 3 个用户角度质疑**
+
+3. **等待 PM 回答后才能继续**
+
+**在 C1 填写需求细节时，AI 必须：**
+
+1. **审计需求是否站在用户角度**
+   ```
+   AI: "在记录这个需求之前，我需要从用户角度审计：
+        
+        □ 需求背景是否反映真实用户痛点？
+        □ 需求描述是否使用用户语言而非技术语言？
+        □ 验收标准是否考虑了用户体验？
+        □ 边界情况是否会让用户困惑？
+        
+        请补充或确认。"
+   ```
+
+2. **标记不符合用户视角的需求**
+
+### 错误 vs 正确示例
+
+```
+❌ 错误：
+PM: "需求 #1 是添加进度条"
+AI: "好的，我记录下来..." (直接记录，没有质疑)
+
+✅ 正确：
+PM: "需求 #1 是添加进度条"
+AI: "在记录之前，我从用户角度质疑一下：
+
+     1. 用户目前的体验问题是什么？是不知道进度，还是等待太久？
+     2. 进度条真的能解决问题吗？也许用户需要的是更快的速度？
+     3. 进度条的样式用户能理解吗？百分比还是步骤提示？
+     
+     请回答这些问题。"
+```
+
+---
+
+## 🧩 功能完整性检查（PM 说"需求完成"时必须执行）
+
+### ⚠️ AI 最容易犯的错误：只记录 PM 说的，不追问遗漏的！
+
+**当 PM 说"需求说完了"/"就这些"时，AI 必须从以下 5 个维度检查闭环：**
+
+### 5 个通用检查维度
+
+| 维度 | 追问的问题 |
+|------|-----------|
+| **1. 用户维度** | 用户如何触发这个功能？用户看到什么？用户操作后会发生什么？ |
+| **2. 技术维度** | 数据从哪来？存在哪里？前后端接口定义了吗？ |
+| **3. 管理维度** | 谁来配置？谁来管理？有后台吗？ |
+| **4. 产品逻辑维度** | 业务规则是什么？状态如何流转？异常如何处理？ |
+| **5. 体验维度** | 用户等待时有反馈吗？操作成功/失败有提示吗？ |
+
+### AI 必须这样追问
+
+```
+AI: "在确认这个需求完成之前，我从 5 个维度检查功能闭环：
+
+     1️⃣ 用户维度：
+     □ 用户如何触发这个功能？入口在哪里？
+     □ 用户完成操作后会看到什么？
+     
+     2️⃣ 技术维度：
+     □ 这个功能的数据从哪里来？
+     □ 数据如何存储？需要后端接口吗？
+     
+     3️⃣ 管理维度：
+     □ 这个功能需要谁来配置或管理吗？
+     □ 有没有管理后台的需求？
+     
+     4️⃣ 产品逻辑维度：
+     □ 核心业务规则是什么？
+     □ 有哪些状态变化？异常情况怎么处理？
+     
+     5️⃣ 体验维度：
+     □ 用户等待时有加载反馈吗？
+     □ 操作成功/失败有提示吗？
+     
+     请补充你没提到的部分。"
+```
+
+### ❌ 错误 vs ✅ 正确
+
+```
+❌ 错误：
+PM: "这个需求我说完了"
+AI: "好的，我确认一下...（复述内容）...没问题就继续"
+
+✅ 正确：
+PM: "这个需求我说完了"
+AI: "等一下，让我从 5 个维度检查一下：
+     
+     你说的是用户端的功能，但我需要确认：
+     
+     - 技术维度：数据从哪来？需要后端接口吗？
+     - 管理维度：这个功能需要后台配置吗？谁来管理？
+     - 产品逻辑维度：有哪些业务规则？异常怎么处理？
+     
+     请补充这些我没听到的部分。"
+```
+
+---
+
+## 📋 开始工作前的检查
+
+```
+□ 我是否知道当前项目状态？（查看 .prd-config.json）
+□ 我是否知道哪些文档已冻结？（B3? C3?）
+□ 我是否会通过对话引导 PM，而不是直接填写？
+□ 我是否会让 PM 做决策？
+```
+
+---
+
+## 🔄 工作流程
+
+```
+A 阶段（基线）
+  A0 → A1 → A2 → R0
+
+↓ R0 通过后
+
+B 阶段（规划）
+  创建迭代 → B1 → B2 → R1 → B3（冻结）
+
+↓ B3 冻结后
+
+C 阶段（版本）
+  C0 → C1 → R2 → C3（冻结）
+
+↓ C3 冻结后
+
+下一轮迭代或交付开发
+```
+
+---
+
+## � 详细工作流
+
+需要详细指导时，查看 `.agent/workflows/` 目录：
+
+| 阶段 | 文件 |
+|------|------|
+| B1 | `prd-b1-planning-draft.md` |
+| B2 | `prd-b2-planning-breakdown.md` |
+| C1 | `prd-c1-requirement-list.md` |
+| R1 | `prd-r1-review.md` |
+| R2 | `prd-r2-review.md` |
+
+---
+
+## � 核心原则
+
+**PM 决策，AI 执行**
+
+你是战略思维导师，不是自动化工具：
+- ✅ 引导 PM 思考
+- ✅ 挑战模糊表述
+- ✅ 提供决策矩阵
+- ❌ 不替 PM 做决策
+- ❌ 不自动填充文档
+- ❌ 不修改已冻结文档
+
+---
+
+**记住：流程优先，不是效率优先！**

package/GUIDE.md

@@ -0,0 +1,341 @@
+# PRD Workflow CLI - 使用指南
+
+## 目录
+- [快速上手](#快速上手)
+- [完整工作流示例](#完整工作流示例)
+- [与 AI 协作](#与-ai-协作)
+- [常见问题](#常见问题)
+
+## 快速上手
+
+### 第一次使用
+
+```bash
+# 1. 安装
+npm install -g prd-workflow-cli
+
+# 2. 初始化项目
+prd init my-product
+cd my-product
+
+# 3. 查看项目结构
+tree -L 2
+```
+
+你会看到:
+```
+my-product/
+├── 00_项目总览/
+│   └── P0_项目基本信息.md
+├── 01_产品基线/
+├── 02_迭代记录/
+├── 99_归档区/
+├── .agent/workflows/
+└── README.md
+```
+
+## 完整工作流示例
+
+### 阶段一: 建立基线(首次必做)
+
+```bash
+# 1. 创建 A0 - 产品基础与范围说明
+prd baseline create A0
+```
+
+打开 `01_产品基线/A0_产品基础与范围说明.md`,填写:
+- 产品是什么
+- 目标用户
+- 核心场景
+- **重点**: 当前不支持什么
+
+```bash
+# 2. 创建 A1 - 已上线功能清单
+prd baseline create A1
+```
+
+列出所有**已存在**的功能和用户路径,不要写"期望有的"。
+
+```bash
+# 3. 创建 A2 - 存量反馈汇总
+prd baseline create A2
+```
+
+整理用户反馈、数据异常、已知问题。
+
+```bash
+# 4. 创建 R0 - 基线审视
+prd baseline create R0
+```
+
+从头到尾走一遍系统,确认基线稳定。
+
+✅ **基线完成后,可以开始第一轮迭代**
+
+### 阶段二: 启动迭代(每轮必做)
+
+```bash
+# 开始新迭代
+prd iteration new
+```
+
+这会在 `02_迭代记录/第01轮迭代/` 下创建 `R1_规划启动条件检查.md`。
+
+**重要**: 填写并确认三个条件:
+
+1. ✅ 问题真实存在
+   - 在 A1 中能找到对应的功能或路径断点
+   - 或在 A2 中有用户反馈/数据支撑
+
+2. ✅ 值得单独规划
+   - 不是"顺手改一下"
+   - 会显著影响核心路径
+
+3. ✅ 问题已理解清楚
+   - 知道是哪个用户
+   - 知道在哪个场景
+   - 边界清晰
+
+⚠️ **如果任何一条不满足,不要继续!**
+
+### 阶段三: 需求规划(B 阶段)
+
+```bash
+# 1. 创建 B1 - 规划草案
+prd plan create B1
+```
+
+在 `B1_需求规划草案.md` 中描述:
+- 规划目标(一句话)
+- 使用场景(基于 A 类现状)
+- 核心需求
+- **重点**: 明确不做什么
+
+```bash
+# 2. 创建 B2 - 规划拆解
+prd plan create B2
+```
+
+在 `B2_规划拆解与范围界定.md` 中:
+- 拆解需求项
+- 排优先级
+- 划边界
+
+```bash
+# 3. 执行 R1 规划审视
+prd review r1
+```
+
+这会:
+1. 显示 AI 审视指令
+2. 生成 `R1_规划审视报告.md` 模板
+
+**与 AI 协作**:
+```
+请按照刚才显示的 R1 审视指令,
+审查 B1、B2 文档是否有资格冻结为 B3。
+
+请在 R1_规划审视报告.md 中填写审视结果。
+```
+
+AI 会检查 5 个维度并给出结论:
+- [ ] 通过
+- [ ] 有条件通过
+- [ ] 不通过
+
+```bash
+# 4. 如果通过,冻结规划
+prd plan freeze
+```
+
+生成 `B3_规划冻结归档.md`,**此后规划不可随意修改**。
+
+### 阶段四: 版本需求(C 阶段)
+
+```bash
+# 1. 创建 C0 - 版本范围
+prd version create C0
+```
+
+在 `C0_版本范围声明.md` 中:
+- 版本目标(基于 B3)
+- 本版包含什么
+- 本版不包含什么
+
+```bash
+# 2. 创建 C1 - 版本需求清单
+prd version create C1
+```
+
+在 `C1_版本需求清单.md` 中:
+- 逐条列出需求
+- 每条说明目的
+- 关键规则
+
+```bash
+# 3. 执行 R2 版本审视
+prd review r2
+```
+
+AI 会检查:
+- C0/C1 是否忠于 B3
+- 有没有"顺手加戏"
+- 需求粒度是否成熟
+
+```bash
+# 4. 如果通过,冻结版本
+prd version freeze
+```
+
+生成 `C3_版本冻结归档.md`,**标志产品需求阶段完成**。
+
+## 与 AI 协作
+
+### 场景一: R1 审视
+
+```
+我已经完成了 B1、B2 文档。
+
+请你扮演【产品规划审视官】,按照以下 5 个维度审视:
+1. 目标清晰性
+2. 场景真实性
+3. 现状一致性
+4. 范围收敛性
+5. 版本化准备度
+
+请参考:
+- 01_产品基线/ 下的 A 类文档
+- 当前迭代的 B1、B2 文档
+- .agent/workflows/prd-r1-review.md 中的详细指令
+
+请在 R1_规划审视报告.md 中填写审视结果,
+并给出明确的通过/不通过结论。
+```
+
+### 场景二: R2 审视
+
+```
+请你扮演【版本一致性审视官】,检查:
+C0、C1 是否忠实执行了 B3 的规划。
+
+审视维度:
+1. 版本目标一致性
+2. 版本范围偏移检查
+3. 规划覆盖完整性
+4. 需求粒度成熟度
+5. 进入执行准备度
+
+参考 .agent/workflows/prd-r2-review.md 中的详细指令,
+在 R2_版本审视报告.md 中填写结果。
+```
+
+### 场景三: 规划协作
+
+```
+我想为产品添加一个新功能。
+
+先帮我检查 R1 启动条件:
+1. 这个问题是否在 A1/A2 中有依据?
+2. 是否值得单独规划?
+3. 问题边界是否清楚?
+
+然后我们一起完成 B1 规划草案。
+```
+
+## 常见问题
+
+### Q1: 必须严格按顺序吗?
+
+**A**: 是的。这是强制流程:
+```
+A → R1 启动检查 → B1/B2 → R1 审视 → B3 → C0/C1 → R2 审视 → C3
+```
+
+任何跳过都可能导致:
+- 规划膨胀
+- 需求蔓延
+- 反复返工
+
+### Q2: R1 不通过怎么办?
+
+**A**: 有三种情况:
+
+1. **不通过**: 说明这个问题不该开启规划
+   - 可能是小修小补,不需要独立迭代
+   - 可能问题还没想清楚
+   - 建议: 先解决启动条件问题
+
+2. **有条件通过**: 补充指定内容后可通过
+   - 修改 B1/B2
+   - 重新执行 `prd review r1`
+
+3. **通过**: 执行 `prd plan freeze`
+
+### Q3: 基线文档一定要做吗?
+
+**A**: 第一轮迭代前必须做,后续迭代可以:
+- 直接使用(如果产品稳定)
+- 更新(如果有重大变化)
+
+**不做基线的风险**:
+- AI 会假设不存在的能力
+- 规划会"从零重建"
+- 失去现状约束
+
+### Q4: 可以同时进行多个迭代吗?
+
+**A**: 每个项目同时只能有一个活跃迭代。
+
+原因:
+- 每个迭代都需要审视
+- 并行会导致冲突和混乱
+
+如果有多个需求:
+- 在 B2 中全部列出
+- 排优先级
+- 分批进入版本
+
+### Q5: B3 冻结后还能改吗?
+
+**A**: 不建议,除非:
+- 外部约束变化(如合规要求)
+- 发现重大风险
+
+修改流程:
+1. 说明变更原因
+2. 更新 B3
+3. 重新执行 R1 审视
+4. 如果已进入 C 阶段,需要同步更新
+
+### Q6: 与传统 PRD 的区别?
+
+**A**: 
+
+| 传统 PRD | 本工具 |
+|----------|--------|
+| 一次写完 | 分阶段,有闸门 |
+| 想到哪写到哪 | 强制基于现状(A 类) |
+| 需求容易膨胀 | R1/R2 审视控制 |
+| 规划和版本混在一起 | B/C 严格分离 |
+| 人工审查 | AI 可执行审视 |
+
+### Q7: 适合什么规模的项目?
+
+**A**: 
+
+- ✅ **适合**: 需要多轮迭代的产品
+- ✅ **适合**: 团队需要规范约束
+- ✅ **适合**: 与 AI 协作开发
+- ⚠️ **可选**: 一次性项目
+- ⚠️ **可选**: 原型验证阶段
+
+## 下一步
+
+1. 📖 阅读 [文档结构说明](/原始资料素材/2、产品输出文档结构.md)
+2. 🔍 理解 [R1 启动条件](/原始资料素材/5、R1进入B1的条件.md)
+3. 🤖 学习 [R1、R2 审视指令](/原始资料素材/7、R1、R2审视指令.md)
+4. 📊 查看 [B3 与 C 的边界](/原始资料素材/8、B3 与 C0 、 C1 的边界定义.md)
+
+---
+
+**记住**: 这个工具的核心价值不是"写更多文档",而是"防止写错误的文档"。