prd-workflow-cli 1.3.4 → 1.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (19) hide show
  1. package/.agent/workflows/prd-b1-planning-draft.md +45 -0
  2. package/.agent/workflows/prd-b2-planning-breakdown.md +53 -0
  3. package/.agent/workflows/prd-c1-requirement-list.md +63 -0
  4. package/.agent/workflows/prd-p0-project-info.md +45 -0
  5. package/.agent/workflows/prd-r1-review.md +45 -0
  6. package/.agent/workflows/prd-r2-review.md +43 -0
  7. package/.antigravity/rules.md +14 -0
  8. package/.cursorrules +26 -0
  9. package/README.md +42 -17
  10. package/bin/prd-cli.js +21 -0
  11. package/commands/check.js +509 -0
  12. package/commands/stats.js +192 -0
  13. package/docs/RULE-SYSTEM-ROADMAP.md +286 -0
  14. package/package.json +3 -1
  15. package/rules/index.json +614 -0
  16. package/rules/schemas/a2ui.schema.json +545 -0
  17. package/rules/schemas/rules.schema.json +221 -0
  18. package/scripts/inject-rules.js +167 -0
  19. package/templates/a2ui-standalone.html +3 -3
package/.agent/workflows/prd-b1-planning-draft.md CHANGED
@@ -4,6 +4,51 @@ description: B1 需求规划草案填写工作流
4
4
 
5
5
  # B1 需求规划草案填写工作流
6
6
 
7
+ ---
8
+
9
+ ## 🚨 本阶段必须遵守的规则
10
+
11
+ > ⚠️ AI 在执行任务前必须逐条确认以下规则。输出时需包含自检清单。
12
+
13
+ | ID | 规则 | 严重程度 | 自检 |
14
+ |----|------|----------|------|
15
+ | G001 | 所有回复必须使用简体中文 | 🔴 严重 | ☐ |
16
+ | G002 | 禁止未经对话就填充文档，必须通过提问引导 PM 填写 | 🔴 严重 | ☐ |
17
+ | G003 | 禁止替 PM 做决策（优先级/范围/目标由 PM 决定） | 🔴 严重 | ☐ |
18
+ | G004 | 禁止'快速完成'跳过流程，每个阶段都要充分对话和审视 | 🔴 严重 | ☐ |
19
+ | D005 | 文档状态变更后必须同步更新 .prd-config.json | 🟠 高 | ☐ |
20
+ | S004 | 新需求正确流程：暂存 A2 → 新迭代 → B1 处理 | 🟠 高 | ☐ |
21
+ | V001 | PM 描述系统结构时，必须生成 A2UI 架构图 | 🟠 高 | ☐ |
22
+ | I001 | 确认一个需求，立即写入文件（铁律） | 🔴 严重 | ☐ |
23
+ | I002 | 禁止聊完全部需求后一次性写入 | 🔴 严重 | ☐ |
24
+ | I003 | 完成章节/确认 3 个需求项/10 轮对话后必须保存 | 🟠 高 | ☐ |
25
+ | I004 | 切换讨论主题前必须保存当前内容 | 🟠 高 | ☐ |
26
+ | C003 | 禁止'只记录 PM 说的，不追问遗漏的' | 🟠 高 | ☐ |
27
+ | W001 | 开始工作前，必须查看 .prd-config.json 了解项目状态 | 🟠 高 | ☐ |
28
+ | W002 | 开始工作前，必须确认哪些文档已冻结 | 🟠 高 | ☐ |
29
+
30
+ **自检清单模板**（AI 输出时必须包含）：
31
+ ```
32
+ ## ✅ 规则自检 (B1)
33
+ - [ ] G001: 所有回复必须使用简体中文...
34
+ - [ ] G002: 禁止未经对话就填充文档，必须通过提问引导 PM 填写...
35
+ - [ ] G003: 禁止替 PM 做决策（优先级/范围/目标由 PM 决定）...
36
+ - [ ] G004: 禁止'快速完成'跳过流程，每个阶段都要充分对话和审视...
37
+ - [ ] D005: 文档状态变更后必须同步更新 .prd-config.json...
38
+ - [ ] S004: 新需求正确流程：暂存 A2 → 新迭代 → B1 处理...
39
+ - [ ] V001: PM 描述系统结构时，必须生成 A2UI 架构图...
40
+ - [ ] I001: 确认一个需求，立即写入文件（铁律）...
41
+ - [ ] I002: 禁止聊完全部需求后一次性写入...
42
+ - [ ] I003: 完成章节/确认 3 个需求项/10 轮对话后必须保存...
43
+ - [ ] I004: 切换讨论主题前必须保存当前内容...
44
+ - [ ] C003: 禁止'只记录 PM 说的，不追问遗漏的'...
45
+ - [ ] W001: 开始工作前，必须查看 .prd-config.json 了解...
46
+ - [ ] W002: 开始工作前，必须确认哪些文档已冻结...
47
+ ```
48
+
49
+ ---
50
+
51
+
7
52
  **核心原则**：AI 是战略思维导师，PM 是决策者。AI 通过结构化提问引导 PM 思考，而不是被动记录。
8
53
 
9
54
  ---
package/.agent/workflows/prd-b2-planning-breakdown.md CHANGED
@@ -4,6 +4,59 @@ description: B2 规划拆解与范围界定填写工作流
4
4
 
5
5
  # B2 规划拆解与范围界定填写工作流
6
6
 
7
+ ---
8
+
9
+ ## 🚨 本阶段必须遵守的规则
10
+
11
+ > ⚠️ AI 在执行任务前必须逐条确认以下规则。输出时需包含自检清单。
12
+
13
+ | ID | 规则 | 严重程度 | 自检 |
14
+ |----|------|----------|------|
15
+ | G001 | 所有回复必须使用简体中文 | 🔴 严重 | ☐ |
16
+ | G002 | 禁止未经对话就填充文档，必须通过提问引导 PM 填写 | 🔴 严重 | ☐ |
17
+ | G003 | 禁止替 PM 做决策（优先级/范围/目标由 PM 决定） | 🔴 严重 | ☐ |
18
+ | G004 | 禁止'快速完成'跳过流程，每个阶段都要充分对话和审视 | 🔴 严重 | ☐ |
19
+ | D005 | 文档状态变更后必须同步更新 .prd-config.json | 🟠 高 | ☐ |
20
+ | S004 | 新需求正确流程：暂存 A2 → 新迭代 → B1 处理 | 🟠 高 | ☐ |
21
+ | V001 | PM 描述系统结构时，必须生成 A2UI 架构图 | 🟠 高 | ☐ |
22
+ | I001 | 确认一个需求，立即写入文件（铁律） | 🔴 严重 | ☐ |
23
+ | I002 | 禁止聊完全部需求后一次性写入 | 🔴 严重 | ☐ |
24
+ | I003 | 完成章节/确认 3 个需求项/10 轮对话后必须保存 | 🟠 高 | ☐ |
25
+ | I004 | 切换讨论主题前必须保存当前内容 | 🟠 高 | ☐ |
26
+ | U001 | B2 讨论需求时，必须从用户角度提出至少 3 个质疑 | 🟠 高 | ☐ |
27
+ | U003 | 禁止直接记录 PM 说的内容而不质疑 | 🟠 高 | ☐ |
28
+ | C001 | PM 说'需求完成'时，必须从 5 维度检查功能闭环 | 🔴 严重 | ☐ |
29
+ | C002 | 5 维度具体内容：用户/技术/管理/产品逻辑/体验 | 🟠 高 | ☐ |
30
+ | C003 | 禁止'只记录 PM 说的，不追问遗漏的' | 🟠 高 | ☐ |
31
+ | W001 | 开始工作前，必须查看 .prd-config.json 了解项目状态 | 🟠 高 | ☐ |
32
+ | W002 | 开始工作前，必须确认哪些文档已冻结 | 🟠 高 | ☐ |
33
+
34
+ **自检清单模板**（AI 输出时必须包含）：
35
+ ```
36
+ ## ✅ 规则自检 (B2)
37
+ - [ ] G001: 所有回复必须使用简体中文...
38
+ - [ ] G002: 禁止未经对话就填充文档，必须通过提问引导 PM 填写...
39
+ - [ ] G003: 禁止替 PM 做决策（优先级/范围/目标由 PM 决定）...
40
+ - [ ] G004: 禁止'快速完成'跳过流程，每个阶段都要充分对话和审视...
41
+ - [ ] D005: 文档状态变更后必须同步更新 .prd-config.json...
42
+ - [ ] S004: 新需求正确流程：暂存 A2 → 新迭代 → B1 处理...
43
+ - [ ] V001: PM 描述系统结构时，必须生成 A2UI 架构图...
44
+ - [ ] I001: 确认一个需求，立即写入文件（铁律）...
45
+ - [ ] I002: 禁止聊完全部需求后一次性写入...
46
+ - [ ] I003: 完成章节/确认 3 个需求项/10 轮对话后必须保存...
47
+ - [ ] I004: 切换讨论主题前必须保存当前内容...
48
+ - [ ] U001: B2 讨论需求时，必须从用户角度提出至少 3 个质疑...
49
+ - [ ] U003: 禁止直接记录 PM 说的内容而不质疑...
50
+ - [ ] C001: PM 说'需求完成'时，必须从 5 维度检查功能闭环...
51
+ - [ ] C002: 5 维度具体内容：用户/技术/管理/产品逻辑/体验...
52
+ - [ ] C003: 禁止'只记录 PM 说的，不追问遗漏的'...
53
+ - [ ] W001: 开始工作前，必须查看 .prd-config.json 了解...
54
+ - [ ] W002: 开始工作前，必须确认哪些文档已冻结...
55
+ ```
56
+
57
+ ---
58
+
59
+
7
60
  **核心原则**：用 MECE 原则完整拆解需求，PM 决定优先级和范围。
8
61
 
9
62
  ---
package/.agent/workflows/prd-c1-requirement-list.md CHANGED
@@ -4,6 +4,69 @@ description: C1 版本需求清单填写工作流
4
4
 
5
5
  # C1 版本需求清单填写工作流
6
6
 
7
+ ---
8
+
9
+ ## 🚨 本阶段必须遵守的规则
10
+
11
+ > ⚠️ AI 在执行任务前必须逐条确认以下规则。输出时需包含自检清单。
12
+
13
+ | ID | 规则 | 严重程度 | 自检 |
14
+ |----|------|----------|------|
15
+ | G001 | 所有回复必须使用简体中文 | 🔴 严重 | ☐ |
16
+ | G002 | 禁止未经对话就填充文档，必须通过提问引导 PM 填写 | 🔴 严重 | ☐ |
17
+ | G003 | 禁止替 PM 做决策（优先级/范围/目标由 PM 决定） | 🔴 严重 | ☐ |
18
+ | G004 | 禁止'快速完成'跳过流程，每个阶段都要充分对话和审视 | 🔴 严重 | ☐ |
19
+ | D005 | 文档状态变更后必须同步更新 .prd-config.json | 🟠 高 | ☐ |
20
+ | S001 | 禁止在 C1 阶段加入新需求，新需求只能暂存到 A2 | 🔴 严重 | ☐ |
21
+ | S003 | C1 需求必须在 B3 范围内，禁止超出 | 🟠 高 | ☐ |
22
+ | S004 | 新需求正确流程：暂存 A2 → 新迭代 → B1 处理 | 🟠 高 | ☐ |
23
+ | V002 | PM 描述界面/表单时，必须生成 A2UI 界面原型 | 🟠 高 | ☐ |
24
+ | V004 | PM 确认原型后，必须保存 .json + .html 两个文件 | 🔴 严重 | ☐ |
25
+ | V005 | 原型命名规范：REQ-XXX-名称.json/html | 🟠 高 | ☐ |
26
+ | V006 | 保存原型后必须更新 index.md 索引 | 🟠 高 | ☐ |
27
+ | I001 | 确认一个需求，立即写入文件（铁律） | 🔴 严重 | ☐ |
28
+ | I002 | 禁止聊完全部需求后一次性写入 | 🔴 严重 | ☐ |
29
+ | I003 | 完成章节/确认 3 个需求项/10 轮对话后必须保存 | 🟠 高 | ☐ |
30
+ | I004 | 切换讨论主题前必须保存当前内容 | 🟠 高 | ☐ |
31
+ | U002 | C1 记录需求前，必须审计是否站在用户角度 | 🟠 高 | ☐ |
32
+ | U003 | 禁止直接记录 PM 说的内容而不质疑 | 🟠 高 | ☐ |
33
+ | C001 | PM 说'需求完成'时，必须从 5 维度检查功能闭环 | 🔴 严重 | ☐ |
34
+ | C002 | 5 维度具体内容：用户/技术/管理/产品逻辑/体验 | 🟠 高 | ☐ |
35
+ | C003 | 禁止'只记录 PM 说的，不追问遗漏的' | 🟠 高 | ☐ |
36
+ | W001 | 开始工作前，必须查看 .prd-config.json 了解项目状态 | 🟠 高 | ☐ |
37
+ | W002 | 开始工作前，必须确认哪些文档已冻结 | 🟠 高 | ☐ |
38
+
39
+ **自检清单模板**（AI 输出时必须包含）：
40
+ ```
41
+ ## ✅ 规则自检 (C1)
42
+ - [ ] G001: 所有回复必须使用简体中文...
43
+ - [ ] G002: 禁止未经对话就填充文档，必须通过提问引导 PM 填写...
44
+ - [ ] G003: 禁止替 PM 做决策（优先级/范围/目标由 PM 决定）...
45
+ - [ ] G004: 禁止'快速完成'跳过流程，每个阶段都要充分对话和审视...
46
+ - [ ] D005: 文档状态变更后必须同步更新 .prd-config.json...
47
+ - [ ] S001: 禁止在 C1 阶段加入新需求，新需求只能暂存到 A2...
48
+ - [ ] S003: C1 需求必须在 B3 范围内，禁止超出...
49
+ - [ ] S004: 新需求正确流程：暂存 A2 → 新迭代 → B1 处理...
50
+ - [ ] V002: PM 描述界面/表单时，必须生成 A2UI 界面原型...
51
+ - [ ] V004: PM 确认原型后，必须保存 .json + .html 两个...
52
+ - [ ] V005: 原型命名规范：REQ-XXX-名称.json/html...
53
+ - [ ] V006: 保存原型后必须更新 index.md 索引...
54
+ - [ ] I001: 确认一个需求，立即写入文件（铁律）...
55
+ - [ ] I002: 禁止聊完全部需求后一次性写入...
56
+ - [ ] I003: 完成章节/确认 3 个需求项/10 轮对话后必须保存...
57
+ - [ ] I004: 切换讨论主题前必须保存当前内容...
58
+ - [ ] U002: C1 记录需求前，必须审计是否站在用户角度...
59
+ - [ ] U003: 禁止直接记录 PM 说的内容而不质疑...
60
+ - [ ] C001: PM 说'需求完成'时，必须从 5 维度检查功能闭环...
61
+ - [ ] C002: 5 维度具体内容：用户/技术/管理/产品逻辑/体验...
62
+ - [ ] C003: 禁止'只记录 PM 说的，不追问遗漏的'...
63
+ - [ ] W001: 开始工作前，必须查看 .prd-config.json 了解...
64
+ - [ ] W002: 开始工作前，必须确认哪些文档已冻结...
65
+ ```
66
+
67
+ ---
68
+
69
+
7
70
  **核心原则**：忠实于 B3，不新增范围 + 完整记录所有细节。C1 是 AODW 的输入源！
8
71
 
9
72
  ---
package/.agent/workflows/prd-p0-project-info.md CHANGED
@@ -4,6 +4,51 @@ description: P0 项目基本信息填写指引
4
4
 
5
5
  # P0_项目基本信息填写工作流
6
6
 
7
+ ---
8
+
9
+ ## 🚨 本阶段必须遵守的规则
10
+
11
+ > ⚠️ AI 在执行任务前必须逐条确认以下规则。输出时需包含自检清单。
12
+
13
+ | ID | 规则 | 严重程度 | 自检 |
14
+ |----|------|----------|------|
15
+ | G001 | 所有回复必须使用简体中文 | 🔴 严重 | ☐ |
16
+ | G002 | 禁止未经对话就填充文档，必须通过提问引导 PM 填写 | 🔴 严重 | ☐ |
17
+ | G003 | 禁止替 PM 做决策（优先级/范围/目标由 PM 决定） | 🔴 严重 | ☐ |
18
+ | G004 | 禁止'快速完成'跳过流程，每个阶段都要充分对话和审视 | 🔴 严重 | ☐ |
19
+ | D005 | 文档状态变更后必须同步更新 .prd-config.json | 🟠 高 | ☐ |
20
+ | S004 | 新需求正确流程：暂存 A2 → 新迭代 → B1 处理 | 🟠 高 | ☐ |
21
+ | V001 | PM 描述系统结构时，必须生成 A2UI 架构图 | 🟠 高 | ☐ |
22
+ | I001 | 确认一个需求，立即写入文件（铁律） | 🔴 严重 | ☐ |
23
+ | I002 | 禁止聊完全部需求后一次性写入 | 🔴 严重 | ☐ |
24
+ | I003 | 完成章节/确认 3 个需求项/10 轮对话后必须保存 | 🟠 高 | ☐ |
25
+ | I004 | 切换讨论主题前必须保存当前内容 | 🟠 高 | ☐ |
26
+ | C003 | 禁止'只记录 PM 说的，不追问遗漏的' | 🟠 高 | ☐ |
27
+ | W001 | 开始工作前，必须查看 .prd-config.json 了解项目状态 | 🟠 高 | ☐ |
28
+ | W002 | 开始工作前，必须确认哪些文档已冻结 | 🟠 高 | ☐ |
29
+
30
+ **自检清单模板**（AI 输出时必须包含）：
31
+ ```
32
+ ## ✅ 规则自检 (P0)
33
+ - [ ] G001: 所有回复必须使用简体中文...
34
+ - [ ] G002: 禁止未经对话就填充文档，必须通过提问引导 PM 填写...
35
+ - [ ] G003: 禁止替 PM 做决策（优先级/范围/目标由 PM 决定）...
36
+ - [ ] G004: 禁止'快速完成'跳过流程，每个阶段都要充分对话和审视...
37
+ - [ ] D005: 文档状态变更后必须同步更新 .prd-config.json...
38
+ - [ ] S004: 新需求正确流程：暂存 A2 → 新迭代 → B1 处理...
39
+ - [ ] V001: PM 描述系统结构时，必须生成 A2UI 架构图...
40
+ - [ ] I001: 确认一个需求，立即写入文件（铁律）...
41
+ - [ ] I002: 禁止聊完全部需求后一次性写入...
42
+ - [ ] I003: 完成章节/确认 3 个需求项/10 轮对话后必须保存...
43
+ - [ ] I004: 切换讨论主题前必须保存当前内容...
44
+ - [ ] C003: 禁止'只记录 PM 说的，不追问遗漏的'...
45
+ - [ ] W001: 开始工作前，必须查看 .prd-config.json 了解...
46
+ - [ ] W002: 开始工作前，必须确认哪些文档已冻结...
47
+ ```
48
+
49
+ ---
50
+
51
+
7
52
  ## 📌 P0 文档的定位
8
53
 
9
54
  P0_项目基本信息.md 是整个 PRD 体系的**起点文档**，在创建其他任何文档之前必须先完善。
package/.agent/workflows/prd-r1-review.md CHANGED
@@ -1,5 +1,50 @@
1
1
  # R1 规划审视工作流
2
2
 
3
+ ---
4
+
5
+ ## 🚨 本阶段必须遵守的规则
6
+
7
+ > ⚠️ AI 在执行任务前必须逐条确认以下规则。输出时需包含自检清单。
8
+
9
+ | ID | 规则 | 严重程度 | 自检 |
10
+ |----|------|----------|------|
11
+ | G001 | 所有回复必须使用简体中文 | 🔴 严重 | ☐ |
12
+ | G002 | 禁止未经对话就填充文档，必须通过提问引导 PM 填写 | 🔴 严重 | ☐ |
13
+ | G003 | 禁止替 PM 做决策（优先级/范围/目标由 PM 决定） | 🔴 严重 | ☐ |
14
+ | G004 | 禁止'快速完成'跳过流程，每个阶段都要充分对话和审视 | 🔴 严重 | ☐ |
15
+ | D005 | 文档状态变更后必须同步更新 .prd-config.json | 🟠 高 | ☐ |
16
+ | F004 | R1 禁止直接输出'通过'，必须有 5 维度分析 + 评估矩阵 | 🔴 严重 | ☐ |
17
+ | S004 | 新需求正确流程：暂存 A2 → 新迭代 → B1 处理 | 🟠 高 | ☐ |
18
+ | I001 | 确认一个需求，立即写入文件（铁律） | 🔴 严重 | ☐ |
19
+ | I002 | 禁止聊完全部需求后一次性写入 | 🔴 严重 | ☐ |
20
+ | I003 | 完成章节/确认 3 个需求项/10 轮对话后必须保存 | 🟠 高 | ☐ |
21
+ | I004 | 切换讨论主题前必须保存当前内容 | 🟠 高 | ☐ |
22
+ | C003 | 禁止'只记录 PM 说的，不追问遗漏的' | 🟠 高 | ☐ |
23
+ | W001 | 开始工作前，必须查看 .prd-config.json 了解项目状态 | 🟠 高 | ☐ |
24
+ | W002 | 开始工作前，必须确认哪些文档已冻结 | 🟠 高 | ☐ |
25
+
26
+ **自检清单模板**（AI 输出时必须包含）：
27
+ ```
28
+ ## ✅ 规则自检 (R1)
29
+ - [ ] G001: 所有回复必须使用简体中文...
30
+ - [ ] G002: 禁止未经对话就填充文档，必须通过提问引导 PM 填写...
31
+ - [ ] G003: 禁止替 PM 做决策（优先级/范围/目标由 PM 决定）...
32
+ - [ ] G004: 禁止'快速完成'跳过流程，每个阶段都要充分对话和审视...
33
+ - [ ] D005: 文档状态变更后必须同步更新 .prd-config.json...
34
+ - [ ] F004: R1 禁止直接输出'通过'，必须有 5 维度分析 + 评估矩...
35
+ - [ ] S004: 新需求正确流程：暂存 A2 → 新迭代 → B1 处理...
36
+ - [ ] I001: 确认一个需求，立即写入文件（铁律）...
37
+ - [ ] I002: 禁止聊完全部需求后一次性写入...
38
+ - [ ] I003: 完成章节/确认 3 个需求项/10 轮对话后必须保存...
39
+ - [ ] I004: 切换讨论主题前必须保存当前内容...
40
+ - [ ] C003: 禁止'只记录 PM 说的，不追问遗漏的'...
41
+ - [ ] W001: 开始工作前，必须查看 .prd-config.json 了解...
42
+ - [ ] W002: 开始工作前，必须确认哪些文档已冻结...
43
+ ```
44
+
45
+ ---
46
+
47
+
3
48
  **重要说明**：本工作流是关于 **R1 规划审视**（在 B1/B2 之后），不是 **R1 启动条件检查**（在 B1/B2 之前）。
4
49
 
5
50
  - **R1 启动条件检查**：在 `prd iteration new` 时自动创建，用于确认是否允许进入规划阶段（B1/B2 之前）
package/.agent/workflows/prd-r2-review.md CHANGED
@@ -1,5 +1,48 @@
1
1
  # R2 版本审视工作流
2
2
 
3
+ ---
4
+
5
+ ## 🚨 本阶段必须遵守的规则
6
+
7
+ > ⚠️ AI 在执行任务前必须逐条确认以下规则。输出时需包含自检清单。
8
+
9
+ | ID | 规则 | 严重程度 | 自检 |
10
+ |----|------|----------|------|
11
+ | G001 | 所有回复必须使用简体中文 | 🔴 严重 | ☐ |
12
+ | G002 | 禁止未经对话就填充文档，必须通过提问引导 PM 填写 | 🔴 严重 | ☐ |
13
+ | G003 | 禁止替 PM 做决策（优先级/范围/目标由 PM 决定） | 🔴 严重 | ☐ |
14
+ | G004 | 禁止'快速完成'跳过流程，每个阶段都要充分对话和审视 | 🔴 严重 | ☐ |
15
+ | D005 | 文档状态变更后必须同步更新 .prd-config.json | 🟠 高 | ☐ |
16
+ | S004 | 新需求正确流程：暂存 A2 → 新迭代 → B1 处理 | 🟠 高 | ☐ |
17
+ | I001 | 确认一个需求，立即写入文件（铁律） | 🔴 严重 | ☐ |
18
+ | I002 | 禁止聊完全部需求后一次性写入 | 🔴 严重 | ☐ |
19
+ | I003 | 完成章节/确认 3 个需求项/10 轮对话后必须保存 | 🟠 高 | ☐ |
20
+ | I004 | 切换讨论主题前必须保存当前内容 | 🟠 高 | ☐ |
21
+ | C003 | 禁止'只记录 PM 说的，不追问遗漏的' | 🟠 高 | ☐ |
22
+ | W001 | 开始工作前，必须查看 .prd-config.json 了解项目状态 | 🟠 高 | ☐ |
23
+ | W002 | 开始工作前，必须确认哪些文档已冻结 | 🟠 高 | ☐ |
24
+
25
+ **自检清单模板**（AI 输出时必须包含）：
26
+ ```
27
+ ## ✅ 规则自检 (R2)
28
+ - [ ] G001: 所有回复必须使用简体中文...
29
+ - [ ] G002: 禁止未经对话就填充文档，必须通过提问引导 PM 填写...
30
+ - [ ] G003: 禁止替 PM 做决策（优先级/范围/目标由 PM 决定）...
31
+ - [ ] G004: 禁止'快速完成'跳过流程，每个阶段都要充分对话和审视...
32
+ - [ ] D005: 文档状态变更后必须同步更新 .prd-config.json...
33
+ - [ ] S004: 新需求正确流程：暂存 A2 → 新迭代 → B1 处理...
34
+ - [ ] I001: 确认一个需求，立即写入文件（铁律）...
35
+ - [ ] I002: 禁止聊完全部需求后一次性写入...
36
+ - [ ] I003: 完成章节/确认 3 个需求项/10 轮对话后必须保存...
37
+ - [ ] I004: 切换讨论主题前必须保存当前内容...
38
+ - [ ] C003: 禁止'只记录 PM 说的，不追问遗漏的'...
39
+ - [ ] W001: 开始工作前，必须查看 .prd-config.json 了解...
40
+ - [ ] W002: 开始工作前，必须确认哪些文档已冻结...
41
+ ```
42
+
43
+ ---
44
+
45
+
3
46
  本工作流用于执行 R2 版本审视，判断版本需求是否忠实于规划。
4
47
 
5
48
  ---
package/.antigravity/rules.md CHANGED
@@ -2,6 +2,20 @@
2
2
 
3
3
  你是 Google Deepmind 的 Antigravity AI，正在协助 PM 进行产品需求管理。
4
4
 
5
+ > 📖 **规则索引**：完整规则定义见 `rules/index.json`（37 条规则，按 rule_id 标识）
6
+ >
7
+ > 🔍 **规则校验**：运行 `prd check` 验证项目是否符合规则
8
+ >
9
+ > ✅ **自检要求**：AI 在关键操作后必须输出规则自检清单
10
+
11
+ ---
12
+
13
+ ## 📋 规则系统概述
14
+
15
+ 本项目使用结构化规则系统。规则分为 9 类：G(全局)、D(文档)、F(流程)、S(范围)、V(可视化)、I(保存)、U(用户)、C(完整性)、W(启动)。
16
+
17
+ **每个 workflow 文件开头都有该阶段的规则子集表，AI 必须阅读并遵守。**
18
+
5
19
  ---
6
20
 
7
21
  ## 🚨 绝对红线
package/.cursorrules CHANGED
@@ -1,5 +1,31 @@
1
1
  # PRD 工作流 - AI 行为规则
2
2
 
3
+ > 📖 **规则索引**：完整规则定义见 `rules/index.json`（37 条规则，按 rule_id 标识）
4
+ >
5
+ > 🔍 **规则校验**：运行 `prd check` 验证项目是否符合规则
6
+ >
7
+ > ✅ **自检要求**：AI 在关键操作后必须输出规则自检清单
8
+
9
+ ---
10
+
11
+ ## 📋 规则系统概述
12
+
13
+ 本项目使用结构化规则系统管理 AI 行为。规则分为 9 类：
14
+
15
+ | 分类 | 说明 | 校验方式 |
16
+ |------|------|----------|
17
+ | **G - 全局红线** | 基本行为准则 | AI 自检 |
18
+ | **D - 文档状态** | 冻结保护 | `prd check` 程序校验 |
19
+ | **F - 流程顺序** | 阶段前置检查 | `prd check` 程序校验 |
20
+ | **S - 需求范围** | 范围控制 | `prd check` 程序校验 |
21
+ | **V - A2UI可视化** | 文件/命名/Schema | `prd check` 程序校验 |
22
+ | **I - 分段保存** | 即时写入 | AI 自检 |
23
+ | **U - 用户角度** | 用户视角审计 | AI 自检 |
24
+ | **C - 完整性检查** | 5 维度闭环 | AI 自检 |
25
+ | **W - 工作启动** | 开始前检查 | 混合 |
26
+
27
+ **每个 workflow 文件开头都有该阶段的规则子集表，AI 必须阅读并遵守。**
28
+
3
29
  ---
4
30
 
5
31
  ## 🚨 绝对红线（违反任何一条都是严重错误）
package/README.md CHANGED
@@ -55,37 +55,44 @@ C3(版本冻结)
55
55
 
56
56
  ## 🚀 安装
57
57
 
58
- ### 方式1：一键初始化（推荐）✨
58
+ ### 方式1：npx 直接运行（无需安装）✨
59
59
 
60
- 只需一个命令，**自动完成初始化并配置 AI 规则文件**：
60
+ 无需全局安装，直接使用 npx 运行任何命令：
61
61
 
62
62
  ```bash
63
- # 1. 创建并进入项目目录
63
+ # 初始化新项目（推荐）
64
+ npx -y prd-workflow-cli@latest init 我的项目
65
+
66
+ # 或者进入空目录直接初始化
64
67
  mkdir 我的项目 && cd 我的项目
68
+ npx -y prd-workflow-cli@latest
65
69
 
66
- # 2. 一键初始化（自动配置一切！）
67
- npx prd-workflow-cli
68
- ```
70
+ # 查看帮助
71
+ npx prd-workflow-cli@latest --help
69
72
 
70
- 就这样！运行后你会看到：
71
- - ✅ `.agent/workflows/` - PRD 工作流指引
72
- - ✅ `.cursorrules` - Cursor AI 规则
73
- - ✅ `.antigravity/` - Antigravity AI 规则
73
+ # 规则校验 (v1.4.0 新增)
74
+ npx prd-workflow-cli@latest check
74
75
 
75
- > 💡 **现在你的 AI 助手已经知道如何协助你完成 PRD 流程了！**
76
- > 例如：直接告诉 AI "我要创建一个新项目的需求文档"
76
+ # 统计报告 (v1.4.0 新增)
77
+ npx prd-workflow-cli@latest stats
78
+ ```
77
79
 
78
- ### 方式2：全局安装
80
+ > 💡 **建议使用 `@latest` 确保使用最新版本**
81
+ >
82
+ > ⚠️ 不加 `@latest` 可能使用缓存的旧版本
79
83
 
80
- 如果你经常使用，可以全局安装：
84
+ ### 方式2：全局安装（推荐频繁使用者）
81
85
 
82
86
  ```bash
83
87
  npm install -g prd-workflow-cli
84
88
 
85
- # 然后使用
89
+ # 验证安装
90
+ prd --version # 应该显示 1.4.0
91
+
92
+ # 然后直接使用 prd 命令
86
93
  prd init 我的项目
87
- cd 我的项目
88
- npm install # 重要！这一步会安装 AI 规则文件
94
+ prd check
95
+ prd stats
89
96
  ```
90
97
 
91
98
  ### 方式3：从源码安装
@@ -229,6 +236,24 @@ prd iteration list # 查看所有迭代
229
236
  | `prd review r1` | 执行 R1 规划审视 |
230
237
  | `prd review r2` | 执行 R2 版本审视 |
231
238
 
239
+ ### 规则校验 (v1.4.0 新增)
240
+
241
+ | 命令 | 说明 |
242
+ |------|------|
243
+ | `prd check` | 检查项目是否符合 PRD 规则 |
244
+ | `prd check --json` | 输出 JSON 格式（供 AI 读取） |
245
+ | `prd check --no-log` | 不记录日志 |
246
+ | `prd stats` | 显示规则统计报告 |
247
+ | `prd stats --json` | 输出 JSON 格式统计 |
248
+
249
+ ### 其他命令
250
+
251
+ | 命令 | 说明 |
252
+ |------|------|
253
+ | `prd ui [file]` | 启动 A2UI 界面预览服务 |
254
+ | `prd upgrade` | 更新项目中的 workflows 和 AI 规则 |
255
+ | `prd index` | 生成/更新迭代索引 |
256
+
232
257
  ## 🤖 与 AI IDE 集成
233
258
 
234
259
  本工具专门设计用于与 AI 编程助手配合使用。
package/bin/prd-cli.js CHANGED
@@ -111,6 +111,27 @@ program
111
111
  server.start();
112
112
  });
113
113
 
114
+ // 规则校验命令
115
+ program
116
+ .command('check')
117
+ .description('检查当前项目是否符合 PRD 规则')
118
+ .option('--json', '输出 JSON 格式（供 AI 读取）')
119
+ .option('--category <cat>', '只运行指定分类的规则 (G/D/F/S/V/I/U/C/W)')
120
+ .option('--rule <id>', '只运行指定规则 (如 D001)')
121
+ .option('--no-log', '不保存日志到 .prd-logs/')
122
+ .action((options) => {
123
+ require('../commands/check')(options);
124
+ });
125
+
126
+ // 规则统计命令
127
+ program
128
+ .command('stats')
129
+ .description('显示规则校验统计报告（基于历史日志）')
130
+ .option('--json', '输出 JSON 格式')
131
+ .action((options) => {
132
+ require('../commands/stats')(options);
133
+ });
134
+
114
135
  // 帮助信息增强
115
136
  program.on('--help', () => {
116
137
  console.log('');