prd-workflow-cli 1.3.0 → 1.4.0

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

@@ -179,54 +179,51 @@ description: A2UI 可视化指南 - 架构图与界面原型
     📁 位置：02_迭代记录/第01轮迭代/C1_UI原型/"
 ```
 
-### HTML 预览文件要求
+### 🚀 生成独立预览文件 (HTML)
 
-1. 包含完整的 CSS 样式
-2. 包含完整的渲染引擎 JS 代码
-3. 内嵌 JSON 数据（不依赖外部文件）
-4. 顶部显示需求编号、界面名称、确认时间
-5. 可以脱离服务器，双击直接打开
+当 PM 确认原型后，AI 必须生成一个**独立 HTML 文件**，该文件可脱离环境直接打开，方便分享给相关方。
 
----
+**生成步骤**：
+1. 读取下方的 **[HTML 独立文件模板]** 代码
+2. 替换以下占位符：
+   - `{{TITLE}}` -> 需求编号+名称（如 "#REQ-001 用户登录"）
+   - `{{REQ_ID}}` -> 需求编号
+   - `{{NAME}}` -> 界面名称
+   - `{{DATE}}` -> 当前日期 (YYYY-MM-DD)
+   - `{{JSON_DATA}}` -> 完整的 A2UI JSON 数据（注意：不要加引号，直接作为 JS 对象插入）
+3. **关键：必须保存两份文件**：
+   - 📄 **原始数据**：保存为 `.json` (如 `REQ-001-登录页.json`) -> **用于后续溯源和修改**
+   - 👁️ **预览页面**：保存为 `.html` (如 `REQ-001-登录页.html`) -> **用于交付和查看**
+   - 路径统一为：`02_迭代记录/第XX轮迭代/C1_UI原型/`
 
-## 📝 第三部分：通用规范
+**[HTML 独立文件模板]**：
 
-### AI 触发流程
+请读取文件：`prd-cli/templates/a2ui-standalone.html` 获取完整模板代码（包含 HTML/CSS/React/AntD 逻辑）。
 
-```
-1. PM 描述结构/界面
-   ↓
-2. AI 识别关键词（"系统模块"、"页面"、"表单"等）
-   ↓
-3. AI 主动提议："让我生成一个可视化的图..."
-   ↓
-4. AI 生成 JSON 并写入 `.a2ui/current.json`
-   ↓
-5. AI 提示：👉 请刷新浏览器 (http://localhost:3333) 查看
-   ↓
-6. PM 反馈 → AI 迭代修改 → PM 确认 → AI 正式保存
-```
-
-### 在 Markdown 中嵌入预览
+⚠️ **注意**：AI 在生成文件时，必须先读取上述模板文件的内容，然后执行替换操作。不要自己编造 HTML 结构。
 
-```markdown
-## 系统架构图
+### 👀 历史溯源与多文件预览
 
-> 查看 [系统架构图](./B1_架构图/架构图-系统架构.html)
+**方法 A：命令行指定文件**
+```bash
+prd ui ./path/to/specific.json
+```
 
-<!-- 或使用 iframe（部分编辑器支持）-->
-<iframe src="./B1_架构图/架构图-系统架构.html" width="100%" height="400"></iframe>
+**方法 B：浏览器 URL 参数（推荐）**
+启动服务后，直接在浏览器地址栏添加 `?file=` 参数：
+```
+http://localhost:3333/?file=02_迭代记录/第01轮迭代/C1_UI原型/REQ-001.json
 ```
 
-### index.md 索引文件格式
+> 💡 **提示**：你可以在 Markdown 文档中直接复制文件的相对路径，粘贴到 `file=` 后面。
 
-```markdown
-# UI 原型索引
+### 📂 多原型文件管理指南
 
-| 编号 | 名称 | 👁️ 预览 | 📄 数据 | 确认时间 |
-|------|------|--------|--------|---------|
-| REQ-001 | 登录页 | [.html](./REQ-001-登录页.html) | [.json](./REQ-001-登录页.json) | 2025-12-28 |
-```
+一个项目中通常会有多个需求点，建议按以下方式管理：
+
+1. **命名规范**：`REQ-{编号}-{名称}.html` (如 `REQ-003-用户反馈.html`)
+2. **索引文件**：务必更新 `index.md`，提供所有原型的入口列表
+3. **版本控制**：如果需求变更，直接覆盖旧文件，或另存为 `_v2.html`
 
 ---
 

package/.agent/workflows/prd-b1-planning-draft.md

@@ -4,6 +4,51 @@ description: B1 需求规划草案填写工作流
 
 # B1 需求规划草案填写工作流
 
+---
+
+## 🚨 本阶段必须遵守的规则
+
+> ⚠️ AI 在执行任务前必须逐条确认以下规则。输出时需包含自检清单。
+
+| ID | 规则 | 严重程度 | 自检 |
+|----|------|----------|------|
+| G001 | 所有回复必须使用简体中文 | 🔴 严重 | ☐ |
+| G002 | 禁止未经对话就填充文档，必须通过提问引导 PM 填写 | 🔴 严重 | ☐ |
+| G003 | 禁止替 PM 做决策（优先级/范围/目标由 PM 决定） | 🔴 严重 | ☐ |
+| G004 | 禁止'快速完成'跳过流程，每个阶段都要充分对话和审视 | 🔴 严重 | ☐ |
+| D005 | 文档状态变更后必须同步更新 .prd-config.json | 🟠 高 | ☐ |
+| S004 | 新需求正确流程：暂存 A2 → 新迭代 → B1 处理 | 🟠 高 | ☐ |
+| V001 | PM 描述系统结构时，必须生成 A2UI 架构图 | 🟠 高 | ☐ |
+| I001 | 确认一个需求，立即写入文件（铁律） | 🔴 严重 | ☐ |
+| I002 | 禁止聊完全部需求后一次性写入 | 🔴 严重 | ☐ |
+| I003 | 完成章节/确认 3 个需求项/10 轮对话后必须保存 | 🟠 高 | ☐ |
+| I004 | 切换讨论主题前必须保存当前内容 | 🟠 高 | ☐ |
+| C003 | 禁止'只记录 PM 说的，不追问遗漏的' | 🟠 高 | ☐ |
+| W001 | 开始工作前，必须查看 .prd-config.json 了解项目状态 | 🟠 高 | ☐ |
+| W002 | 开始工作前，必须确认哪些文档已冻结 | 🟠 高 | ☐ |
+
+**自检清单模板**（AI 输出时必须包含）：
+```
+## ✅ 规则自检 (B1)
+- [ ] G001: 所有回复必须使用简体中文...
+- [ ] G002: 禁止未经对话就填充文档，必须通过提问引导 PM 填写...
+- [ ] G003: 禁止替 PM 做决策（优先级/范围/目标由 PM 决定）...
+- [ ] G004: 禁止'快速完成'跳过流程，每个阶段都要充分对话和审视...
+- [ ] D005: 文档状态变更后必须同步更新 .prd-config.json...
+- [ ] S004: 新需求正确流程：暂存 A2 → 新迭代 → B1 处理...
+- [ ] V001: PM 描述系统结构时，必须生成 A2UI 架构图...
+- [ ] I001: 确认一个需求，立即写入文件（铁律）...
+- [ ] I002: 禁止聊完全部需求后一次性写入...
+- [ ] I003: 完成章节/确认 3 个需求项/10 轮对话后必须保存...
+- [ ] I004: 切换讨论主题前必须保存当前内容...
+- [ ] C003: 禁止'只记录 PM 说的，不追问遗漏的'...
+- [ ] W001: 开始工作前，必须查看 .prd-config.json 了解...
+- [ ] W002: 开始工作前，必须确认哪些文档已冻结...
+```
+
+---
+
+
 **核心原则**：AI 是战略思维导师，PM 是决策者。AI 通过结构化提问引导 PM 思考，而不是被动记录。
 
 ---

package/.agent/workflows/prd-b2-planning-breakdown.md

@@ -4,6 +4,59 @@ description: B2 规划拆解与范围界定填写工作流
 
 # B2 规划拆解与范围界定填写工作流
 
+---
+
+## 🚨 本阶段必须遵守的规则
+
+> ⚠️ AI 在执行任务前必须逐条确认以下规则。输出时需包含自检清单。
+
+| ID | 规则 | 严重程度 | 自检 |
+|----|------|----------|------|
+| G001 | 所有回复必须使用简体中文 | 🔴 严重 | ☐ |
+| G002 | 禁止未经对话就填充文档，必须通过提问引导 PM 填写 | 🔴 严重 | ☐ |
+| G003 | 禁止替 PM 做决策（优先级/范围/目标由 PM 决定） | 🔴 严重 | ☐ |
+| G004 | 禁止'快速完成'跳过流程，每个阶段都要充分对话和审视 | 🔴 严重 | ☐ |
+| D005 | 文档状态变更后必须同步更新 .prd-config.json | 🟠 高 | ☐ |
+| S004 | 新需求正确流程：暂存 A2 → 新迭代 → B1 处理 | 🟠 高 | ☐ |
+| V001 | PM 描述系统结构时，必须生成 A2UI 架构图 | 🟠 高 | ☐ |
+| I001 | 确认一个需求，立即写入文件（铁律） | 🔴 严重 | ☐ |
+| I002 | 禁止聊完全部需求后一次性写入 | 🔴 严重 | ☐ |
+| I003 | 完成章节/确认 3 个需求项/10 轮对话后必须保存 | 🟠 高 | ☐ |
+| I004 | 切换讨论主题前必须保存当前内容 | 🟠 高 | ☐ |
+| U001 | B2 讨论需求时，必须从用户角度提出至少 3 个质疑 | 🟠 高 | ☐ |
+| U003 | 禁止直接记录 PM 说的内容而不质疑 | 🟠 高 | ☐ |
+| C001 | PM 说'需求完成'时，必须从 5 维度检查功能闭环 | 🔴 严重 | ☐ |
+| C002 | 5 维度具体内容：用户/技术/管理/产品逻辑/体验 | 🟠 高 | ☐ |
+| C003 | 禁止'只记录 PM 说的，不追问遗漏的' | 🟠 高 | ☐ |
+| W001 | 开始工作前，必须查看 .prd-config.json 了解项目状态 | 🟠 高 | ☐ |
+| W002 | 开始工作前，必须确认哪些文档已冻结 | 🟠 高 | ☐ |
+
+**自检清单模板**（AI 输出时必须包含）：
+```
+## ✅ 规则自检 (B2)
+- [ ] G001: 所有回复必须使用简体中文...
+- [ ] G002: 禁止未经对话就填充文档，必须通过提问引导 PM 填写...
+- [ ] G003: 禁止替 PM 做决策（优先级/范围/目标由 PM 决定）...
+- [ ] G004: 禁止'快速完成'跳过流程，每个阶段都要充分对话和审视...
+- [ ] D005: 文档状态变更后必须同步更新 .prd-config.json...
+- [ ] S004: 新需求正确流程：暂存 A2 → 新迭代 → B1 处理...
+- [ ] V001: PM 描述系统结构时，必须生成 A2UI 架构图...
+- [ ] I001: 确认一个需求，立即写入文件（铁律）...
+- [ ] I002: 禁止聊完全部需求后一次性写入...
+- [ ] I003: 完成章节/确认 3 个需求项/10 轮对话后必须保存...
+- [ ] I004: 切换讨论主题前必须保存当前内容...
+- [ ] U001: B2 讨论需求时，必须从用户角度提出至少 3 个质疑...
+- [ ] U003: 禁止直接记录 PM 说的内容而不质疑...
+- [ ] C001: PM 说'需求完成'时，必须从 5 维度检查功能闭环...
+- [ ] C002: 5 维度具体内容：用户/技术/管理/产品逻辑/体验...
+- [ ] C003: 禁止'只记录 PM 说的，不追问遗漏的'...
+- [ ] W001: 开始工作前，必须查看 .prd-config.json 了解...
+- [ ] W002: 开始工作前，必须确认哪些文档已冻结...
+```
+
+---
+
+
 **核心原则**：用 MECE 原则完整拆解需求，PM 决定优先级和范围。
 
 ---

package/.agent/workflows/prd-c1-requirement-list.md

@@ -4,6 +4,69 @@ description: C1 版本需求清单填写工作流
 
 # C1 版本需求清单填写工作流
 
+---
+
+## 🚨 本阶段必须遵守的规则
+
+> ⚠️ AI 在执行任务前必须逐条确认以下规则。输出时需包含自检清单。
+
+| ID | 规则 | 严重程度 | 自检 |
+|----|------|----------|------|
+| G001 | 所有回复必须使用简体中文 | 🔴 严重 | ☐ |
+| G002 | 禁止未经对话就填充文档，必须通过提问引导 PM 填写 | 🔴 严重 | ☐ |
+| G003 | 禁止替 PM 做决策（优先级/范围/目标由 PM 决定） | 🔴 严重 | ☐ |
+| G004 | 禁止'快速完成'跳过流程，每个阶段都要充分对话和审视 | 🔴 严重 | ☐ |
+| D005 | 文档状态变更后必须同步更新 .prd-config.json | 🟠 高 | ☐ |
+| S001 | 禁止在 C1 阶段加入新需求，新需求只能暂存到 A2 | 🔴 严重 | ☐ |
+| S003 | C1 需求必须在 B3 范围内，禁止超出 | 🟠 高 | ☐ |
+| S004 | 新需求正确流程：暂存 A2 → 新迭代 → B1 处理 | 🟠 高 | ☐ |
+| V002 | PM 描述界面/表单时，必须生成 A2UI 界面原型 | 🟠 高 | ☐ |
+| V004 | PM 确认原型后，必须保存 .json + .html 两个文件 | 🔴 严重 | ☐ |
+| V005 | 原型命名规范：REQ-XXX-名称.json/html | 🟠 高 | ☐ |
+| V006 | 保存原型后必须更新 index.md 索引 | 🟠 高 | ☐ |
+| I001 | 确认一个需求，立即写入文件（铁律） | 🔴 严重 | ☐ |
+| I002 | 禁止聊完全部需求后一次性写入 | 🔴 严重 | ☐ |
+| I003 | 完成章节/确认 3 个需求项/10 轮对话后必须保存 | 🟠 高 | ☐ |
+| I004 | 切换讨论主题前必须保存当前内容 | 🟠 高 | ☐ |
+| U002 | C1 记录需求前，必须审计是否站在用户角度 | 🟠 高 | ☐ |
+| U003 | 禁止直接记录 PM 说的内容而不质疑 | 🟠 高 | ☐ |
+| C001 | PM 说'需求完成'时，必须从 5 维度检查功能闭环 | 🔴 严重 | ☐ |
+| C002 | 5 维度具体内容：用户/技术/管理/产品逻辑/体验 | 🟠 高 | ☐ |
+| C003 | 禁止'只记录 PM 说的，不追问遗漏的' | 🟠 高 | ☐ |
+| W001 | 开始工作前，必须查看 .prd-config.json 了解项目状态 | 🟠 高 | ☐ |
+| W002 | 开始工作前，必须确认哪些文档已冻结 | 🟠 高 | ☐ |
+
+**自检清单模板**（AI 输出时必须包含）：
+```
+## ✅ 规则自检 (C1)
+- [ ] G001: 所有回复必须使用简体中文...
+- [ ] G002: 禁止未经对话就填充文档，必须通过提问引导 PM 填写...
+- [ ] G003: 禁止替 PM 做决策（优先级/范围/目标由 PM 决定）...
+- [ ] G004: 禁止'快速完成'跳过流程，每个阶段都要充分对话和审视...
+- [ ] D005: 文档状态变更后必须同步更新 .prd-config.json...
+- [ ] S001: 禁止在 C1 阶段加入新需求，新需求只能暂存到 A2...
+- [ ] S003: C1 需求必须在 B3 范围内，禁止超出...
+- [ ] S004: 新需求正确流程：暂存 A2 → 新迭代 → B1 处理...
+- [ ] V002: PM 描述界面/表单时，必须生成 A2UI 界面原型...
+- [ ] V004: PM 确认原型后，必须保存 .json + .html 两个...
+- [ ] V005: 原型命名规范：REQ-XXX-名称.json/html...
+- [ ] V006: 保存原型后必须更新 index.md 索引...
+- [ ] I001: 确认一个需求，立即写入文件（铁律）...
+- [ ] I002: 禁止聊完全部需求后一次性写入...
+- [ ] I003: 完成章节/确认 3 个需求项/10 轮对话后必须保存...
+- [ ] I004: 切换讨论主题前必须保存当前内容...
+- [ ] U002: C1 记录需求前，必须审计是否站在用户角度...
+- [ ] U003: 禁止直接记录 PM 说的内容而不质疑...
+- [ ] C001: PM 说'需求完成'时，必须从 5 维度检查功能闭环...
+- [ ] C002: 5 维度具体内容：用户/技术/管理/产品逻辑/体验...
+- [ ] C003: 禁止'只记录 PM 说的，不追问遗漏的'...
+- [ ] W001: 开始工作前，必须查看 .prd-config.json 了解...
+- [ ] W002: 开始工作前，必须确认哪些文档已冻结...
+```
+
+---
+
+
 **核心原则**：忠实于 B3，不新增范围 + 完整记录所有细节。C1 是 AODW 的输入源！
 
 ---

package/.agent/workflows/prd-p0-project-info.md

@@ -4,6 +4,51 @@ description: P0 项目基本信息填写指引
 
 # P0_项目基本信息填写工作流
 
+---
+
+## 🚨 本阶段必须遵守的规则
+
+> ⚠️ AI 在执行任务前必须逐条确认以下规则。输出时需包含自检清单。
+
+| ID | 规则 | 严重程度 | 自检 |
+|----|------|----------|------|
+| G001 | 所有回复必须使用简体中文 | 🔴 严重 | ☐ |
+| G002 | 禁止未经对话就填充文档，必须通过提问引导 PM 填写 | 🔴 严重 | ☐ |
+| G003 | 禁止替 PM 做决策（优先级/范围/目标由 PM 决定） | 🔴 严重 | ☐ |
+| G004 | 禁止'快速完成'跳过流程，每个阶段都要充分对话和审视 | 🔴 严重 | ☐ |
+| D005 | 文档状态变更后必须同步更新 .prd-config.json | 🟠 高 | ☐ |
+| S004 | 新需求正确流程：暂存 A2 → 新迭代 → B1 处理 | 🟠 高 | ☐ |
+| V001 | PM 描述系统结构时，必须生成 A2UI 架构图 | 🟠 高 | ☐ |
+| I001 | 确认一个需求，立即写入文件（铁律） | 🔴 严重 | ☐ |
+| I002 | 禁止聊完全部需求后一次性写入 | 🔴 严重 | ☐ |
+| I003 | 完成章节/确认 3 个需求项/10 轮对话后必须保存 | 🟠 高 | ☐ |
+| I004 | 切换讨论主题前必须保存当前内容 | 🟠 高 | ☐ |
+| C003 | 禁止'只记录 PM 说的，不追问遗漏的' | 🟠 高 | ☐ |
+| W001 | 开始工作前，必须查看 .prd-config.json 了解项目状态 | 🟠 高 | ☐ |
+| W002 | 开始工作前，必须确认哪些文档已冻结 | 🟠 高 | ☐ |
+
+**自检清单模板**（AI 输出时必须包含）：
+```
+## ✅ 规则自检 (P0)
+- [ ] G001: 所有回复必须使用简体中文...
+- [ ] G002: 禁止未经对话就填充文档，必须通过提问引导 PM 填写...
+- [ ] G003: 禁止替 PM 做决策（优先级/范围/目标由 PM 决定）...
+- [ ] G004: 禁止'快速完成'跳过流程，每个阶段都要充分对话和审视...
+- [ ] D005: 文档状态变更后必须同步更新 .prd-config.json...
+- [ ] S004: 新需求正确流程：暂存 A2 → 新迭代 → B1 处理...
+- [ ] V001: PM 描述系统结构时，必须生成 A2UI 架构图...
+- [ ] I001: 确认一个需求，立即写入文件（铁律）...
+- [ ] I002: 禁止聊完全部需求后一次性写入...
+- [ ] I003: 完成章节/确认 3 个需求项/10 轮对话后必须保存...
+- [ ] I004: 切换讨论主题前必须保存当前内容...
+- [ ] C003: 禁止'只记录 PM 说的，不追问遗漏的'...
+- [ ] W001: 开始工作前，必须查看 .prd-config.json 了解...
+- [ ] W002: 开始工作前，必须确认哪些文档已冻结...
+```
+
+---
+
+
 ## 📌 P0 文档的定位
 
 P0_项目基本信息.md 是整个 PRD 体系的**起点文档**，在创建其他任何文档之前必须先完善。

package/.agent/workflows/prd-r1-review.md

@@ -1,5 +1,50 @@
 # R1 规划审视工作流
 
+---
+
+## 🚨 本阶段必须遵守的规则
+
+> ⚠️ AI 在执行任务前必须逐条确认以下规则。输出时需包含自检清单。
+
+| ID | 规则 | 严重程度 | 自检 |
+|----|------|----------|------|
+| G001 | 所有回复必须使用简体中文 | 🔴 严重 | ☐ |
+| G002 | 禁止未经对话就填充文档，必须通过提问引导 PM 填写 | 🔴 严重 | ☐ |
+| G003 | 禁止替 PM 做决策（优先级/范围/目标由 PM 决定） | 🔴 严重 | ☐ |
+| G004 | 禁止'快速完成'跳过流程，每个阶段都要充分对话和审视 | 🔴 严重 | ☐ |
+| D005 | 文档状态变更后必须同步更新 .prd-config.json | 🟠 高 | ☐ |
+| F004 | R1 禁止直接输出'通过'，必须有 5 维度分析 + 评估矩阵 | 🔴 严重 | ☐ |
+| S004 | 新需求正确流程：暂存 A2 → 新迭代 → B1 处理 | 🟠 高 | ☐ |
+| I001 | 确认一个需求，立即写入文件（铁律） | 🔴 严重 | ☐ |
+| I002 | 禁止聊完全部需求后一次性写入 | 🔴 严重 | ☐ |
+| I003 | 完成章节/确认 3 个需求项/10 轮对话后必须保存 | 🟠 高 | ☐ |
+| I004 | 切换讨论主题前必须保存当前内容 | 🟠 高 | ☐ |
+| C003 | 禁止'只记录 PM 说的，不追问遗漏的' | 🟠 高 | ☐ |
+| W001 | 开始工作前，必须查看 .prd-config.json 了解项目状态 | 🟠 高 | ☐ |
+| W002 | 开始工作前，必须确认哪些文档已冻结 | 🟠 高 | ☐ |
+
+**自检清单模板**（AI 输出时必须包含）：
+```
+## ✅ 规则自检 (R1)
+- [ ] G001: 所有回复必须使用简体中文...
+- [ ] G002: 禁止未经对话就填充文档，必须通过提问引导 PM 填写...
+- [ ] G003: 禁止替 PM 做决策（优先级/范围/目标由 PM 决定）...
+- [ ] G004: 禁止'快速完成'跳过流程，每个阶段都要充分对话和审视...
+- [ ] D005: 文档状态变更后必须同步更新 .prd-config.json...
+- [ ] F004: R1 禁止直接输出'通过'，必须有 5 维度分析 + 评估矩...
+- [ ] S004: 新需求正确流程：暂存 A2 → 新迭代 → B1 处理...
+- [ ] I001: 确认一个需求，立即写入文件（铁律）...
+- [ ] I002: 禁止聊完全部需求后一次性写入...
+- [ ] I003: 完成章节/确认 3 个需求项/10 轮对话后必须保存...
+- [ ] I004: 切换讨论主题前必须保存当前内容...
+- [ ] C003: 禁止'只记录 PM 说的，不追问遗漏的'...
+- [ ] W001: 开始工作前，必须查看 .prd-config.json 了解...
+- [ ] W002: 开始工作前，必须确认哪些文档已冻结...
+```
+
+---
+
+
 **重要说明**：本工作流是关于 **R1 规划审视**（在 B1/B2 之后），不是 **R1 启动条件检查**（在 B1/B2 之前）。
 
 - **R1 启动条件检查**：在 `prd iteration new` 时自动创建，用于确认是否允许进入规划阶段（B1/B2 之前）

package/.agent/workflows/prd-r2-review.md

@@ -1,5 +1,48 @@
 # R2 版本审视工作流
 
+---
+
+## 🚨 本阶段必须遵守的规则
+
+> ⚠️ AI 在执行任务前必须逐条确认以下规则。输出时需包含自检清单。
+
+| ID | 规则 | 严重程度 | 自检 |
+|----|------|----------|------|
+| G001 | 所有回复必须使用简体中文 | 🔴 严重 | ☐ |
+| G002 | 禁止未经对话就填充文档，必须通过提问引导 PM 填写 | 🔴 严重 | ☐ |
+| G003 | 禁止替 PM 做决策（优先级/范围/目标由 PM 决定） | 🔴 严重 | ☐ |
+| G004 | 禁止'快速完成'跳过流程，每个阶段都要充分对话和审视 | 🔴 严重 | ☐ |
+| D005 | 文档状态变更后必须同步更新 .prd-config.json | 🟠 高 | ☐ |
+| S004 | 新需求正确流程：暂存 A2 → 新迭代 → B1 处理 | 🟠 高 | ☐ |
+| I001 | 确认一个需求，立即写入文件（铁律） | 🔴 严重 | ☐ |
+| I002 | 禁止聊完全部需求后一次性写入 | 🔴 严重 | ☐ |
+| I003 | 完成章节/确认 3 个需求项/10 轮对话后必须保存 | 🟠 高 | ☐ |
+| I004 | 切换讨论主题前必须保存当前内容 | 🟠 高 | ☐ |
+| C003 | 禁止'只记录 PM 说的，不追问遗漏的' | 🟠 高 | ☐ |
+| W001 | 开始工作前，必须查看 .prd-config.json 了解项目状态 | 🟠 高 | ☐ |
+| W002 | 开始工作前，必须确认哪些文档已冻结 | 🟠 高 | ☐ |
+
+**自检清单模板**（AI 输出时必须包含）：
+```
+## ✅ 规则自检 (R2)
+- [ ] G001: 所有回复必须使用简体中文...
+- [ ] G002: 禁止未经对话就填充文档，必须通过提问引导 PM 填写...
+- [ ] G003: 禁止替 PM 做决策（优先级/范围/目标由 PM 决定）...
+- [ ] G004: 禁止'快速完成'跳过流程，每个阶段都要充分对话和审视...
+- [ ] D005: 文档状态变更后必须同步更新 .prd-config.json...
+- [ ] S004: 新需求正确流程：暂存 A2 → 新迭代 → B1 处理...
+- [ ] I001: 确认一个需求，立即写入文件（铁律）...
+- [ ] I002: 禁止聊完全部需求后一次性写入...
+- [ ] I003: 完成章节/确认 3 个需求项/10 轮对话后必须保存...
+- [ ] I004: 切换讨论主题前必须保存当前内容...
+- [ ] C003: 禁止'只记录 PM 说的，不追问遗漏的'...
+- [ ] W001: 开始工作前，必须查看 .prd-config.json 了解...
+- [ ] W002: 开始工作前，必须确认哪些文档已冻结...
+```
+
+---
+
+
 本工作流用于执行 R2 版本审视，判断版本需求是否忠实于规划。
 
 ---

package/.antigravity/rules.md

@@ -2,6 +2,20 @@
 
 你是 Google Deepmind 的 Antigravity AI，正在协助 PM 进行产品需求管理。
 
+> 📖 **规则索引**：完整规则定义见 `rules/index.json`（37 条规则，按 rule_id 标识）
+> 
+> 🔍 **规则校验**：运行 `prd check` 验证项目是否符合规则
+> 
+> ✅ **自检要求**：AI 在关键操作后必须输出规则自检清单
+
+---
+
+## 📋 规则系统概述
+
+本项目使用结构化规则系统。规则分为 9 类：G(全局)、D(文档)、F(流程)、S(范围)、V(可视化)、I(保存)、U(用户)、C(完整性)、W(启动)。
+
+**每个 workflow 文件开头都有该阶段的规则子集表，AI 必须阅读并遵守。**
+
 ---
 
 ## 🚨 绝对红线

package/.cursorrules

@@ -1,5 +1,31 @@
 # PRD 工作流 - AI 行为规则
 
+> 📖 **规则索引**：完整规则定义见 `rules/index.json`（37 条规则，按 rule_id 标识）
+> 
+> 🔍 **规则校验**：运行 `prd check` 验证项目是否符合规则
+> 
+> ✅ **自检要求**：AI 在关键操作后必须输出规则自检清单
+
+---
+
+## 📋 规则系统概述
+
+本项目使用结构化规则系统管理 AI 行为。规则分为 9 类：
+
+| 分类 | 说明 | 校验方式 |
+|------|------|----------|
+| **G - 全局红线** | 基本行为准则 | AI 自检 |
+| **D - 文档状态** | 冻结保护 | `prd check` 程序校验 |
+| **F - 流程顺序** | 阶段前置检查 | `prd check` 程序校验 |
+| **S - 需求范围** | 范围控制 | `prd check` 程序校验 |
+| **V - A2UI可视化** | 文件/命名/Schema | `prd check` 程序校验 |
+| **I - 分段保存** | 即时写入 | AI 自检 |
+| **U - 用户角度** | 用户视角审计 | AI 自检 |
+| **C - 完整性检查** | 5 维度闭环 | AI 自检 |
+| **W - 工作启动** | 开始前检查 | 混合 |
+
+**每个 workflow 文件开头都有该阶段的规则子集表，AI 必须阅读并遵守。**
+
 ---
 
 ## 🚨 绝对红线（违反任何一条都是严重错误）

package/a2ui-viewer/index.html

@@ -399,7 +399,8 @@
 
         async function checkUpdate() {
             try {
-                const res = await fetch('/ui.json');
+                // 获取数据
+                const res = await fetch('/ui.json' + window.location.search);
                 if (res.ok) {
                     const data = await res.json();
                     const dataStr = JSON.stringify(data);
@@ -412,6 +413,21 @@
 
                     document.getElementById('status-text').textContent = '已连接';
                     document.querySelector('.status-dot').style.background = '#52c41a';
+
+                    // 如果有 file 参数，显示当前文件
+                    const params = new URLSearchParams(window.location.search);
+                    if (params.get('file')) {
+                        document.title = `预览: ${params.get('file')} - PRD A2UI`;
+                        // 可以在页面上也显示一下
+                        const statusBar = document.querySelector('.status-bar');
+                        if (!document.getElementById('status-file-info')) {
+                            const fileInfo = document.createElement('span');
+                            fileInfo.id = 'status-file-info';
+                            fileInfo.style.marginLeft = '10px';
+                            fileInfo.textContent = `| 文件: ${params.get('file')}`;
+                            statusBar.appendChild(fileInfo);
+                        }
+                    }
                 }
             } catch (e) {
                 document.getElementById('status-text').textContent = '连接失败';

package/bin/prd-cli.js

@@ -102,15 +102,36 @@ program
 
 // A2UI 预览服务
 program
-  .command('ui')
-  .description('启动 A2UI 界面预览服务')
+  .command('ui [file]')
+  .description('启动 A2UI 界面预览服务 [可指定 .json 文件]')
   .option('-p, --port <number>', '指定端口号', '3333')
-  .action((options) => {
+  .action((file, options) => {
     const A2UIServer = require('../commands/a2ui-server');
-    const server = new A2UIServer(options.port);
+    const server = new A2UIServer(options.port, file);
     server.start();
   });
 
+// 规则校验命令
+program
+  .command('check')
+  .description('检查当前项目是否符合 PRD 规则')
+  .option('--json', '输出 JSON 格式（供 AI 读取）')
+  .option('--category <cat>', '只运行指定分类的规则 (G/D/F/S/V/I/U/C/W)')
+  .option('--rule <id>', '只运行指定规则 (如 D001)')
+  .option('--no-log', '不保存日志到 .prd-logs/')
+  .action((options) => {
+    require('../commands/check')(options);
+  });
+
+// 规则统计命令
+program
+  .command('stats')
+  .description('显示规则校验统计报告（基于历史日志）')
+  .option('--json', '输出 JSON 格式')
+  .action((options) => {
+    require('../commands/stats')(options);
+  });
+
 // 帮助信息增强
 program.on('--help', () => {
   console.log('');

package/commands/a2ui-server.js

@@ -5,8 +5,9 @@ const chalk = require('chalk');
 const { exec } = require('child_process');
 
 class A2UIServer {
-    constructor(port = 3333) {
+    constructor(port = 3333, targetFile = null) {
         this.port = port;
+        this.targetFile = targetFile;
         this.viewerPath = path.join(__dirname, '../a2ui-viewer');
         this.projectPath = process.cwd();
     }
@@ -18,11 +19,32 @@ class A2UIServer {
             res.setHeader('Access-Control-Allow-Methods', 'GET, POST, OPTIONS');
 
             // 路由处理
-            if (req.url === '/') {
+            const parsedUrl = new URL(req.url, `http://localhost:${this.port}`);
+            const pathname = parsedUrl.pathname;
+
+            if (pathname === '/') {
                 this.serveFile(res, path.join(this.viewerPath, 'index.html'), 'text/html');
-            } else if (req.url === '/ui.json') {
-                // 读取项目根目录下的 a2ui-data.json
-                this.serveFile(res, path.join(this.projectPath, '.a2ui/current.json'), 'application/json');
+            } else if (pathname === '/ui.json') {
+                // Priority: 1. URL Query Param (?file=...) 2. CLI Argument 3. Default
+                const queryFile = parsedUrl.searchParams.get('file');
+                let jsonPath = path.join(this.projectPath, '.a2ui/current.json');
+
+                if (queryFile) {
+                    // Prevent directory traversal attacks (basic check)
+                    // Allow relative paths from project root
+                    jsonPath = path.resolve(this.projectPath, queryFile);
+                    if (!jsonPath.startsWith(this.projectPath)) {
+                        res.writeHead(403);
+                        res.end('Access denied: File outside project directory');
+                        return;
+                    }
+                } else if (this.targetFile) {
+                    jsonPath = path.isAbsolute(this.targetFile)
+                        ? this.targetFile
+                        : path.join(this.projectPath, this.targetFile);
+                }
+
+                this.serveFile(res, jsonPath, 'application/json');
             } else {
                 res.writeHead(404);
                 res.end('Not found');