prd-workflow-cli 1.4.1 → 2.0.0

package/.agent/workflows/prd-a1-scan.md

@@ -0,0 +1,133 @@
+---
+description: A1 代码扫描 - 自动生成功能清单
+---
+
+# A1 代码扫描工作流
+
+> ⚠️ **A1 是自动生成的文档，禁止手动维护！**
+
+本工作流指导 AI 扫描项目代码，自动生成或更新 `A1_代码功能快照.md`。
+
+---
+
+## 🎯 触发条件
+
+当 PM 说以下内容时，AI 应主动执行此工作流：
+- "扫描一下现在的功能"
+- "更新 A1"
+- "看看代码里有什么功能"
+- "同步一下功能清单"
+
+---
+
+## 📋 扫描步骤
+
+### Step 1: 识别项目类型
+
+AI 首先判断项目类型：
+
+| 项目类型 | 识别特征 | 扫描重点 |
+|---------|---------|---------|
+| **前端** | package.json 有 react/vue/next | `pages/`, `components/`, 路由配置 |
+| **后端** | package.json 有 express/fastify/nest | `routes/`, `controllers/`, API 定义 |
+| **全栈** | 同时有前后端特征 | 分别扫描前后端 |
+| **CLI** | bin 字段 | `commands/`, 命令定义 |
+| **Python** | requirements.txt / pyproject.toml | `main.py`, `app/`, FastAPI/Flask 路由 |
+
+### Step 2: 执行扫描
+
+AI 应该：
+
+1. **读取目录结构**
+   ```
+   使用 list_dir 或 find_by_name 获取项目结构
+   ```
+
+2. **识别入口文件**
+   - 前端：`src/App.js`, `pages/`, `app/`
+   - 后端：`index.js`, `app.js`, `routes/`
+   - Python：`main.py`, `app.py`
+
+3. **提取功能清单**
+   - 路由 → 功能点
+   - 组件 → 界面能力
+   - API → 服务能力
+
+4. **分类整理**
+   按模块/领域分组
+
+### Step 3: 生成 A1 文档
+
+使用以下模板生成：
+
+```markdown
+# A1_代码功能快照
+
+> ⚠️ **本文件由 AI 扫描代码自动生成，请勿手动编辑！**
+> 
+> 最后扫描时间: YYYY-MM-DD HH:mm
+> 扫描范围: [项目根目录]
+
+---
+
+## 1. 项目概览
+
+- **项目类型**: [前端/后端/全栈/CLI]
+- **技术栈**: [React/Vue/Express/...]
+- **入口文件**: [...]
+
+---
+
+## 2. 功能清单
+
+### 2.1 [模块A]
+
+| 功能 | 路径/入口 | 说明 |
+|-----|----------|------|
+| 功能1 | `src/xxx` | ... |
+| 功能2 | `src/yyy` | ... |
+
+### 2.2 [模块B]
+
+...
+
+---
+
+## 3. API 清单 (如有)
+
+| 方法 | 路径 | 说明 |
+|-----|------|------|
+| GET | /api/xxx | ... |
+| POST | /api/yyy | ... |
+
+---
+
+## 4. 扫描日志
+
+- 扫描了 X 个文件
+- 识别了 Y 个功能点
+- 识别了 Z 个 API
+```
+
+---
+
+## 🔄 更新策略
+
+- **首次扫描**: 生成完整 A1
+- **增量更新**: 对比已有 A1，标注 [新增] / [变更] / [删除]
+- **冲突处理**: 如果发现代码与 A0 边界冲突，必须报告给 PM
+
+---
+
+## ❌ AI 禁止
+
+1. ❌ 要求用户手动填写 A1
+2. ❌ 跳过扫描直接编造功能
+3. ❌ 忽略项目中的隐藏文件夹（如 .git）
+
+---
+
+## 💡 最佳实践
+
+- 在每次 `prd plan freeze` 前建议执行一次 A1 扫描
+- 将 A1 扫描结果与 A0 边界对比，识别"代码超出规划"的情况

package/.agent/workflows/prd-a2ui-guide.md

@@ -8,7 +8,7 @@ description: A2UI 可视化指南 - 架构图与界面原型
 
 - **P0 阶段**：使用架构图组件生成项目架构图
 - **B1/B2 阶段**：使用架构图组件生成模块架构图、需求结构图
-- **C1 阶段**：使用界面原型组件生成交互界面
+- **IT 阶段**：使用界面原型组件生成交互界面
 
 ---
 
@@ -158,11 +158,11 @@ description: A2UI 可视化指南 - 架构图与界面原型
 
 ### 保存规则
 
-**保存位置**：`02_迭代记录/第XX轮迭代/C1_UI原型/`
+**保存位置**：`02_迭代记录/第XX轮迭代/IT/IT-XXX-名称/UI原型/`
 
 **保存文件**：
-- `REQ-001-界面名称.json` - 数据结构
-- `REQ-001-界面名称.html` - 独立预览文件（内嵌渲染器）
+- `IT-001-界面名称.json` - 数据结构
+- `IT-001-界面名称.html` - 独立预览文件（内嵌渲染器）
 - `index.md` - 索引目录
 
 ### AI 保存流程
@@ -170,13 +170,13 @@ description: A2UI 可视化指南 - 架构图与界面原型
 ```
 1. PM 确认："这个界面可以了"
    ↓
-2. AI 询问：请告诉我需求编号（如 REQ-001）
+2. AI 询问：请确认对应的 IT 编号（如 IT-001）
    ↓
 3. AI 生成 3 个文件：.json + .html + 更新 index.md
    ↓
 4. AI 确认：
    "✅ 界面原型已保存！
-    📁 位置：02_迭代记录/第01轮迭代/C1_UI原型/"
+    📁 位置：02_迭代记录/第01轮迭代/IT/IT-001-用户反馈/UI原型/"
 ```
 
 ### 🚀 生成独立预览文件 (HTML)

package/.agent/workflows/prd-b-planning.md

@@ -0,0 +1,135 @@
+---
+description: B 规划文档填写工作流（简化版）
+---
+
+# B 规划文档工作流
+
+> ⚠️ B 阶段只有 **2 个文档**：`B_规划文档.md` + `B3_规划冻结.md`
+
+---
+
+## 🚨 核心规则
+
+| ID | 规则 | 严重程度 |
+|----|------|----------|
+| G002 | 禁止未经对话就填充文档 | 🔴 严重 |
+| G003 | 禁止替 PM 做决策 | 🔴 严重 |
+| I001 | 确认一个需求，立即写入 | 🔴 严重 |
+
+---
+
+## 📋 B_规划文档 结构
+
+```markdown
+# B_规划文档
+
+## 1. 启动检查
+
+在开始规划前，必须确认以下三点：
+
+- [ ] **问题真实存在** - 在 A1/A2 中有证据
+- [ ] **值得单独规划** - 不是小修小补
+- [ ] **问题已理解清楚** - 不是用规划来想问题
+
+## 2. 核心问题
+
+**要解决的问题**:
+<!-- 用一句话说明 -->
+
+**期望达成的结果**:
+<!-- 可衡量的目标 -->
+
+**不做什么**:
+<!-- 明确排除的范围 -->
+
+## 3. 需求拆解
+
+| ID | 需求 | 优先级 | 首版 |
+|----|------|-------|-----|
+| REQ-001 | xxx | P0 | ✅ |
+| REQ-002 | yyy | P1 | ❌ |
+
+## 4. PM 确认
+
+- [ ] 核心问题已明确
+- [ ] 需求拆解完整
+- [ ] 首版范围已确认
+
+**PM 签字**: ___________
+**日期**: ___________
+```
+
+---
+
+## 🔄 AI 执行流程
+
+### Step 1: 启动检查（对话中完成）
+
+```
+AI: "在开始规划前，我需要确认几个问题：
+
+     1. 这个问题在 A1/A2 中有记录吗？
+     2. 这是一个独立的改进，还是小修补？
+     3. 问题本身是否已经理解清楚？
+     
+     请逐一回答。"
+```
+
+### Step 2: 明确核心问题
+
+```
+AI: "好的。请用一句话告诉我：
+     这次规划要解决的核心问题是什么？"
+```
+
+### Step 3: 需求拆解
+
+```
+AI: "基于这个问题，我们需要拆解具体需求。
+     请告诉我需要做哪些事情来解决这个问题？"
+```
+
+### Step 4: 优先级排序
+
+```
+AI: "现在我们有 [N] 个需求项。
+     哪些是 P0（必须做）？
+     哪些是 P1（重要但可延后）？"
+```
+
+### Step 5: 确认首版范围
+
+```
+AI: "最后确认首版范围：
+     [列出 P0 需求]
+     
+     这些是首版必须交付的，对吗？"
+```
+
+### Step 6: 写入文档
+
+```
+AI: "已将规划写入 B_规划文档.md
+     
+     下一步：执行 prd plan freeze 冻结规划"
+```
+
+---
+
+## ❌ 禁止行为
+
+1. ❌ 跳过启动检查
+2. ❌ 替 PM 决定优先级
+3. ❌ 替 PM 决定首版范围
+4. ❌ 一次性填充整个文档
+
+---
+
+## 📁 废弃文档
+
+以下文档已废弃，不再使用：
+
+- ~~R1_规划启动条件检查.md~~ → 合并到 B_规划文档
+- ~~B1_需求规划草案.md~~ → 合并到 B_规划文档
+- ~~B2_规划拆解与范围界定.md~~ → 合并到 B_规划文档
+- ~~R1_规划审视报告.md~~ → 内化为 freeze 命令的自动检查

package/.agent/workflows/prd-it-biz.md

@@ -0,0 +1,56 @@
+---
+description: 协助编写 IT-BIZ 业务需求文档
+---
+
+# IT-BIZ 编写工作流
+
+本工作流旨在协助用户（主要是 PM 或业务代表）编写高质量的 **IT-BIZ 业务需求文档**。
+该文档的核心目标是：**业务确认**。
+它必须清晰、无歧义，且**不包含**任何技术实现细节。
+
+## 1. 启动与上下文确认
+
+1.  **确认文件**: 确认当前正在编辑的文件是 `IT-xxx-BIZ.md`。
+2.  **确认输入**:
+    *   读取 `B3_规划冻结归档.md` (理解背景和规划目标)。
+    *   读取 `A2_存量反馈与数据汇总.md` (如有，用于关联真实反馈)。
+3.  **询问用户**: 询问用户这个 IT 用户故事的核心目标是什么，以及主要解决哪个场景的问题。
+
+## 2. 编写引导 (Socratic Method)
+
+不要直接生成内容，通过提问引导用户明确需求：
+
+### 2.1 用户故事
+*   **角色**: "谁是这个功能的主要使用者？"
+*   **目的**: "他们为什么需要这个功能？"
+*   **价值**: "这能给他们带来什么具体的价值？"
+
+### 2.2 应用场景
+*   **触发**: "用户在什么情况下会想到用这个功能？"
+*   **流程**: "请描述一下用户完成这个任务的理想步骤（不要涉及具体的按钮点击，只要业务流程）。"
+*   **异常**: "如果过程中出现问题（比如拒绝、撤回），业务上希望怎么处理？"
+
+### 2.3 验收标准 (最重要的部分)
+*   **业务成功**: "您如何判断这个功能已经做好了？"
+*   **体验要求**: "有什么必须要满足的体验标准吗（比如响应速度、易用性）？"
+
+## 3. 内容生成规则
+
+在生成或修改 Markdown 内容时，遵守以下 **禁止事项**：
+
+*   ❌ **禁止使用技术术语**: 不要出现 API、数据库、JSON、前端组件、后端服务等词汇。
+*   ❌ **禁止定义 UI细节**: 不要描述"蓝色按钮"、"弹窗"、"下拉框"，而是描述"用户提交"、"系统提示"、"选择"。
+*   ❌ **禁止替代技术决策**: 比如不要写"数据每5分钟同步一次"，而是写"用户能看到最新的数据"。
+
+## 4. 完整性检查
+
+在用户认为完成后，检查以下几点：
+
+1.  **场景闭环**: 是否考虑了开始到结束的完整闭环？
+2.  **异常处理**: 是否定义了业务异常（如库存不足、审核不通过）的处理方式？
+3.  **价值明确**: 用户故事是否符合 INVEST 原则中的 Valuable？
+
+## 5. 结束
+
+提醒用户：
+> "IT-BIZ 文档是您与开发团队的契约。请确认内容准确无误。确认后，开发团队将基于此编写详细的技术规格 (IT-DEV)。"

package/.agent/workflows/prd-it-dev.md

@@ -0,0 +1,163 @@
+---
+description: 协助编写 IT-DEV 功能规格文档
+---
+
+# IT-DEV 编写工作流
+
+本工作流旨在协助将业务需求（BIZ）转化为可执行的开发规格（DEV）。
+
+> ⚠️ **核心原则：从 BIZ 提取，不重复不编造**
+
+---
+
+## 🚨 DEV 文档定位
+
+| BIZ 文档 | DEV 文档 |
+|---------|---------|
+| What（做什么）| How（怎么实现）|
+| 用户故事、验收标准 | RT 拆解、技术约束 |
+| 业务规则 | 影响范围、涉及模块 |
+
+**DEV 的核心价值是 RT 拆解，不是重复 BIZ 内容！**
+
+---
+
+## 1. 从 BIZ 提取已知信息
+
+DEV 文档应该**引用**而不是**重复**BIZ 中已有的内容：
+
+```markdown
+## 1. 需求概述（引用 BIZ）
+
+> 📋 详细验收标准见 [IT-xxx-BIZ.md](./IT-xxx-BIZ.md)
+
+**需求描述**: [从 BIZ 用户故事提取，一句话总结]
+**验收标准数**: X 个
+**涉及业务规则**: X 个
+```
+
+**不要把 BIZ 中已有的状态流转、通知渠道等内容再列一遍！**
+
+---
+
+## 2. DEV 核心内容
+
+### 2.1 必填项（从 BIZ 提取 + 技术判断）
+
+| 字段 | 说明 | 谁填 |
+|-----|------|-----|
+| 需求描述 | 一句话总结（从 BIZ 提取）| AI 可填 |
+| 需求类型 | Feature / Bug / Enhancement | AI 可填 |
+| 预估影响范围 | 哪些功能/页面受影响 | AI 可推断 |
+| 涉及模块 | 前端/后端/哪些服务 | AI 可推断 |
+| 是否涉及 UI | 是否有界面改动 | AI 可判断 |
+
+### 2.2 待确认项（需技术负责人确认）
+
+| 字段 | 说明 |
+|-----|------|
+| 技术约束 | 必须使用某技术/不能改某代码 |
+| 关联需求 | 与其他 RT 的依赖关系 |
+| 风险评估 | 低 / 中 / 高 |
+
+### 2.3 开发要点（供技术负责人参考）
+
+DEV 文档只需列出**开发要点提示**，具体 RT 拆解由技术负责人决定：
+
+```markdown
+## 3. 开发要点
+
+> ⚠️ 以下仅为开发要点提示，具体 RT 拆解由技术负责人决定
+
+### 涉及的验收标准
+- AC-001: xxx
+- AC-002: xxx
+- ...
+
+### 可能的开发方向
+- 前端: xxx页面、xxx组件
+- 后端: xxx服务
+- 其他: xxx
+```
+
+**AI 不应该输出具体的 RT 编号和工时评估！**
+
+---
+
+## 3. AI 禁止事项
+
+| 禁止 | 原因 |
+|------|------|
+| ❌ 重复 BIZ 中已有的业务规则 | BIZ 是唯一真理来源 |
+| ❌ 编造 API 设计 | 接口由技术负责人设计 |
+| ❌ 编造数据库设计 | 表结构由开发团队设计 |
+| ❌ 大量留空表格 | DEV 不是问卷调查 |
+
+---
+
+## 4. DEV 文档模板（正确版）
+
+```markdown
+# IT-xxx-DEV: [名称]
+
+**关联BIZ**: [IT-xxx-BIZ.md](./IT-xxx-BIZ.md)
+**状态**: 待确认
+
+---
+
+## 1. 需求概述
+
+> 📋 详细验收标准见 BIZ 文档
+
+**需求描述**: [从 BIZ 一句话提取]
+**需求类型**: Feature
+**验收标准数**: X 个
+
+---
+
+## 2. 影响范围
+
+| 项目 | 内容 |
+|-----|------|
+| 涉及模块 | 前端: xxx / 后端: xxx |
+| 是否涉及 UI | 是 / 否 |
+| 影响页面 | xxx |
+| 外部依赖 | xxx |
+
+---
+
+## 3. 开发要点
+
+> ⚠️ 以下仅为开发要点提示，具体 RT 拆解由技术负责人决定
+
+### 涉及的验收标准
+- AC-001: xxx
+- AC-002: xxx
+
+### 可能的开发方向
+- 前端: xxx
+- 后端: xxx
+
+---
+
+## 4. 待确认问题
+
+1. [具体的技术决策问题]
+2. [具体的依赖问题]
+
+---
+
+## 技术负责人确认
+
+- [ ] 影响范围确认
+- [ ] 开发要点已评审
+- [ ] RT 已拆解（记录在任务系统中）
+- [ ] 可以开始开发
+```
+
+---
+
+## 5. 结束
+
+提醒用户：
+> "DEV 文档提供开发要点，具体 RT 拆解由技术负责人在任务系统中完成。"