prd-workflow-cli 1.1.33 → 1.2.6
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.
- package/.agent/workflows/prd-b1-planning-draft.md +68 -0
- package/.agent/workflows/prd-b2-planning-breakdown.md +44 -0
- package/.agent/workflows/prd-c1-a2ui-guide.md +245 -0
- package/.agent/workflows/prd-c1-requirement-list.md +131 -815
- package/.agent/workflows/prd-p0-project-info.md +44 -0
- package/.antigravity/rules.md +64 -7
- package/.cursorrules +100 -8
- package/a2ui-viewer/index.html +460 -0
- package/bin/prd-cli.js +11 -0
- package/commands/a2ui-server.js +69 -0
- package/commands/init.js +35 -0
- package/commands/upgrade.js +6 -0
- package/package.json +2 -1
|
@@ -169,6 +169,50 @@ AI: "P0 项目基本信息已完善。请检查确认:
|
|
|
169
169
|
|
|
170
170
|
---
|
|
171
171
|
|
|
172
|
+
## 🎨 A2UI 架构图触发规则(P0 阶段)
|
|
173
|
+
|
|
174
|
+
**当 PM 在 P0 阶段描述项目整体结构、模块划分时,AI 必须主动生成架构图。**
|
|
175
|
+
|
|
176
|
+
### 触发信号词
|
|
177
|
+
|
|
178
|
+
| PM 提到的内容 | AI 触发行为 |
|
|
179
|
+
|-------------|-----------|
|
|
180
|
+
| "这个项目包含几个子系统..." | ✅ 主动生成系统架构图 |
|
|
181
|
+
| "涉及到前端、后端、数据库..." | ✅ 主动生成技术架构图 |
|
|
182
|
+
| "干系人之间的关系是..." | ✅ 主动生成干系人关系图 |
|
|
183
|
+
| "项目分为几个阶段..." | ✅ 主动生成项目阶段图 |
|
|
184
|
+
|
|
185
|
+
### AI 执行流程
|
|
186
|
+
|
|
187
|
+
```
|
|
188
|
+
1. PM 描述项目结构/干系人关系
|
|
189
|
+
↓
|
|
190
|
+
2. AI 识别到结构描述
|
|
191
|
+
↓
|
|
192
|
+
3. AI 主动提议:
|
|
193
|
+
"我注意到您在描述项目结构。
|
|
194
|
+
让我生成一个可视化的架构图帮助理解。"
|
|
195
|
+
↓
|
|
196
|
+
4. AI 生成 Diagram JSON 并写入 `.a2ui/current.json`
|
|
197
|
+
↓
|
|
198
|
+
5. AI 提示刷新浏览器查看
|
|
199
|
+
```
|
|
200
|
+
|
|
201
|
+
### 架构图组件
|
|
202
|
+
|
|
203
|
+
使用 `Diagram`, `Layer`, `DiagramGroup`, `Box`, `Arrow` 组件。
|
|
204
|
+
详见:`prd-c1-a2ui-guide.md`
|
|
205
|
+
|
|
206
|
+
### 架构图保存规则
|
|
207
|
+
|
|
208
|
+
**当 PM 确认架构图后,AI 必须正式保存:**
|
|
209
|
+
|
|
210
|
+
- **保存位置**:`00_项目总览/P0_架构图/`
|
|
211
|
+
- **生成文件**:`.json` + `.html`
|
|
212
|
+
- **嵌入文档**:在 P0 文档中添加链接
|
|
213
|
+
|
|
214
|
+
---
|
|
215
|
+
|
|
172
216
|
## ✅ 完成标志
|
|
173
217
|
|
|
174
218
|
当以下条件全部满足时,P0 才算完成:
|
package/.antigravity/rules.md
CHANGED
|
@@ -16,6 +16,7 @@
|
|
|
16
16
|
7. ❌ 禁止 R1 直接输出"通过" → 必须有分析和评估矩阵
|
|
17
17
|
8. ❌ 禁止创建迭代后直接创建 B1 → 必须先填写 R1 启动检查
|
|
18
18
|
9. ❌ 禁止在 C0 无视 B2 的版本划分 → 如果 B2 有多批次,C0 只包含首批
|
|
19
|
+
10. ❌ 禁止忽略架构图生成 → PM 描述系统结构/模块/界面时必须生成 A2UI 图
|
|
19
20
|
```
|
|
20
21
|
|
|
21
22
|
**R1 有两个阶段**:
|
|
@@ -26,6 +27,26 @@
|
|
|
26
27
|
|
|
27
28
|
---
|
|
28
29
|
|
|
30
|
+
## 🎨 A2UI 强制触发规则(极其重要!)
|
|
31
|
+
|
|
32
|
+
**⚠️ AI 绝对禁止忽略架构图/界面原型的生成!**
|
|
33
|
+
|
|
34
|
+
当 PM 在 **P0/B1/B2/C1** 阶段描述以下内容时,AI **必须立即**生成 A2UI 图:
|
|
35
|
+
|
|
36
|
+
| 阶段 | PM 提到的内容 | AI 必须做的 |
|
|
37
|
+
|------|-------------|------------|
|
|
38
|
+
| **P0** | "涉及前端、后端、数据库..." | ✅ 生成技术架构图 |
|
|
39
|
+
| **B1** | "系统包含三个模块..." | ✅ 生成模块架构图 |
|
|
40
|
+
| **B2** | "需求分为几部分..." | ✅ 生成需求结构图 |
|
|
41
|
+
| **C1** | "页面有表单和按钮..." | ✅ 生成界面原型 |
|
|
42
|
+
|
|
43
|
+
**执行步骤**:
|
|
44
|
+
1. 识别结构描述 → 2. 主动提议生成图 → 3. 写入 `.a2ui/current.json` → 4. 提示刷新浏览器
|
|
45
|
+
|
|
46
|
+
详见 `.agent/workflows/prd-c1-a2ui-guide.md`
|
|
47
|
+
|
|
48
|
+
---
|
|
49
|
+
|
|
29
50
|
## ⚠️ 冻结规则(极其重要)
|
|
30
51
|
|
|
31
52
|
### B3 冻结后
|
|
@@ -104,6 +125,28 @@ AI 在 C0 写:"本版本包含所有 B2 需求" ← 严重错误!
|
|
|
104
125
|
|
|
105
126
|
---
|
|
106
127
|
|
|
128
|
+
## 🎨 A2UI 界面原型(C1 阶段职责)
|
|
129
|
+
|
|
130
|
+
**当 PM 在 C1 阶段描述需求时涉及界面/交互/页面/表单等内容,AI 必须主动触发 A2UI 原型生成。**
|
|
131
|
+
|
|
132
|
+
### AI 触发行为
|
|
133
|
+
|
|
134
|
+
1. **识别界面需求**:PM 提到"页面"、"表单"、"按钮"、"用户看到"、"操作流程"等。
|
|
135
|
+
2. **主动生成**:生成符合 Schema 的 JSON 并写入 `.a2ui/current.json`。
|
|
136
|
+
3. **提示预览**:告知 PM 运行 `prd ui` 查看原型。
|
|
137
|
+
4. **迭代修改**:根据 PM 反馈修改 JSON 并让其刷新浏览器。
|
|
138
|
+
5. **正式保存**:PM 确认后,将原型保存到 `02_迭代记录/第XX轮迭代/C1_UI原型/` 目录。
|
|
139
|
+
|
|
140
|
+
### ⚠️ 正式保存规则
|
|
141
|
+
|
|
142
|
+
- **保存时机**:PM 说"这个可以了"、"确认"、"没问题"等。
|
|
143
|
+
- **保存位置**:`02_迭代记录/第XX轮迭代/C1_UI原型/REQ-XXX-界面名称.json`
|
|
144
|
+
- **必须更新索引**:同时更新 `index.md` 文件,记录所有已确认的原型。
|
|
145
|
+
|
|
146
|
+
**详见**:`.agent/workflows/prd-c1-a2ui-guide.md`
|
|
147
|
+
|
|
148
|
+
---
|
|
149
|
+
|
|
107
150
|
## ⚙️ 分段写入规则(从 prd-incremental-save.md 合并)
|
|
108
151
|
|
|
109
152
|
### 铁律:确认一个,写入一个
|
|
@@ -254,13 +297,27 @@ C 阶段(版本)
|
|
|
254
297
|
|
|
255
298
|
需要详细指导时,查看 `.agent/workflows/` 目录:
|
|
256
299
|
|
|
257
|
-
| 阶段 |
|
|
258
|
-
|
|
259
|
-
|
|
|
260
|
-
|
|
|
261
|
-
|
|
|
262
|
-
|
|
|
263
|
-
|
|
|
300
|
+
| 阶段 | 主文件 | 辅助文件 | 使用场景 |
|
|
301
|
+
|------|--------|----------|----------|
|
|
302
|
+
| P0 | `prd-p0-project-info.md` | - | 项目初始化时 |
|
|
303
|
+
| B1 | `prd-b1-planning-draft.md` | - | 填写规划草案时 |
|
|
304
|
+
| B2 | `prd-b2-planning-breakdown.md` | - | 规划拆解时 |
|
|
305
|
+
| C1 | `prd-c1-requirement-list.md` | `prd-c1-a2ui-guide.md` | 填写需求清单时 |
|
|
306
|
+
| R0 | `prd-r0-baseline-review.md` | - | 基线审视时 |
|
|
307
|
+
| R1 | `prd-r1-review.md` | - | 规划审视时 |
|
|
308
|
+
| R2 | `prd-r2-review.md` | - | 版本审视时 |
|
|
309
|
+
|
|
310
|
+
### C1 阶段的文件使用规则
|
|
311
|
+
|
|
312
|
+
| 场景 | 使用文件 |
|
|
313
|
+
|------|----------|
|
|
314
|
+
| C1 整体流程、红线、9 个维度 | `prd-c1-requirement-list.md` |
|
|
315
|
+
| 界面示意 (A2UI) 详细操作 | `prd-c1-a2ui-guide.md` |
|
|
316
|
+
|
|
317
|
+
**AI 行为**:
|
|
318
|
+
1. 进入 C1 阶段时,先读取 `prd-c1-requirement-list.md` 了解核心规则
|
|
319
|
+
2. 当需要生成界面示意时,参考 `prd-c1-a2ui-guide.md` 的详细指导
|
|
320
|
+
3. A2UI 是 C1 的第 6 个维度(推荐),不是必须,但强烈建议执行
|
|
264
321
|
|
|
265
322
|
---
|
|
266
323
|
|
package/.cursorrules
CHANGED
|
@@ -14,6 +14,7 @@
|
|
|
14
14
|
7. ❌ 禁止 R1 直接输出"通过" → 必须有 5 维度分析和评估矩阵
|
|
15
15
|
8. ❌ 禁止创建迭代后直接创建 B1 → 必须先引导 PM 填写 R1 启动检查
|
|
16
16
|
9. ❌ 禁止在 C0 无视 B2 的版本划分 → 如果 B2 有多批次,C0 只包含首批
|
|
17
|
+
10. ❌ 禁止忽略架构图生成 → PM 描述系统结构/模块/界面时必须生成 A2UI 图
|
|
17
18
|
```
|
|
18
19
|
|
|
19
20
|
**R1 有两个阶段**:
|
|
@@ -24,6 +25,42 @@
|
|
|
24
25
|
|
|
25
26
|
---
|
|
26
27
|
|
|
28
|
+
## 🎨 A2UI 强制触发规则(极其重要!)
|
|
29
|
+
|
|
30
|
+
**⚠️ AI 绝对禁止忽略架构图/界面原型的生成!**
|
|
31
|
+
|
|
32
|
+
### 触发条件
|
|
33
|
+
|
|
34
|
+
当 PM 在 **P0/B1/B2/C1** 阶段描述以下内容时,AI **必须立即**生成 A2UI 图:
|
|
35
|
+
|
|
36
|
+
| 阶段 | PM 提到的内容(示例) | AI 必须做的 |
|
|
37
|
+
|------|---------------------|------------|
|
|
38
|
+
| **P0** | "这个项目涉及前端、后端、数据库..." | ✅ 生成技术架构图 |
|
|
39
|
+
| **B1** | "系统包含三个模块..." | ✅ 生成模块架构图 |
|
|
40
|
+
| **B2** | "需求分为这几部分..." / "A 依赖 B..." | ✅ 生成需求结构图/依赖图 |
|
|
41
|
+
| **C1** | "这个页面有表单和按钮..." | ✅ 生成界面原型 |
|
|
42
|
+
|
|
43
|
+
### AI 执行步骤
|
|
44
|
+
|
|
45
|
+
```
|
|
46
|
+
1. 识别到结构/界面描述
|
|
47
|
+
↓
|
|
48
|
+
2. 主动说:"我注意到您在描述系统结构,让我生成一个可视化的图..."
|
|
49
|
+
↓
|
|
50
|
+
3. 生成 Diagram/Box/Arrow JSON 写入 `.a2ui/current.json`
|
|
51
|
+
↓
|
|
52
|
+
4. 提示 PM:"👉 请刷新浏览器 (http://localhost:3333) 查看"
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
### 组件类型
|
|
56
|
+
|
|
57
|
+
- **架构图**:`Diagram`, `Layer`, `DiagramGroup`, `Box`, `Arrow`
|
|
58
|
+
- **界面原型**:`Page`, `Panel`, `Row`, `Col`, `Input`, `Button`, `Text`
|
|
59
|
+
|
|
60
|
+
详见 `.agent/workflows/prd-c1-a2ui-guide.md`
|
|
61
|
+
|
|
62
|
+
---
|
|
63
|
+
|
|
27
64
|
## ⚠️ 冻结规则(极其重要)
|
|
28
65
|
|
|
29
66
|
### B3 冻结后
|
|
@@ -143,6 +180,47 @@ AI: "✅ 第 1 批(v1.0)已完成 C3 冻结,可以交付开发。
|
|
|
143
180
|
|
|
144
181
|
---
|
|
145
182
|
|
|
183
|
+
## 🎨 A2UI 界面原型(C1 阶段职责)
|
|
184
|
+
|
|
185
|
+
**当 PM 在 C1 阶段描述需求时涉及界面/交互/页面/表单等内容,AI 必须主动触发 A2UI 原型生成。**
|
|
186
|
+
|
|
187
|
+
### AI 触发行为
|
|
188
|
+
|
|
189
|
+
1. **识别界面需求**:PM 提到"页面"、"表单"、"按钮"、"用户看到"、"操作流程"等。
|
|
190
|
+
2. **主动生成**:生成符合 Schema 的 JSON 并写入 `.a2ui/current.json`。
|
|
191
|
+
3. **提示预览**:告知 PM 运行 `prd ui` 查看原型。
|
|
192
|
+
4. **迭代修改**:根据 PM 反馈修改 JSON 并让其刷新浏览器。
|
|
193
|
+
5. **正式保存**:PM 确认后,将原型保存到 `02_迭代记录/第XX轮迭代/C1_UI原型/` 目录。
|
|
194
|
+
|
|
195
|
+
### ⚠️ 正式保存规则
|
|
196
|
+
|
|
197
|
+
- **保存时机**:PM 说"这个可以了"、"确认"、"没问题"等。
|
|
198
|
+
- **保存位置**:`02_迭代记录/第XX轮迭代/C1_UI原型/REQ-XXX-界面名称.json`
|
|
199
|
+
- **必须更新索引**:同时更新 `index.md` 文件,记录所有已确认的原型。
|
|
200
|
+
|
|
201
|
+
**详见**:`.agent/workflows/prd-c1-a2ui-guide.md`
|
|
202
|
+
|
|
203
|
+
---
|
|
204
|
+
|
|
205
|
+
## 🏗️ A2UI 架构图(P0/B1/B2 阶段职责)
|
|
206
|
+
|
|
207
|
+
**当 PM 在 P0/B1/B2 阶段描述系统结构、模块关系、功能划分、干系人关系时,AI 必须主动生成架构图。**
|
|
208
|
+
|
|
209
|
+
### AI 触发行为
|
|
210
|
+
|
|
211
|
+
1. **识别架构描述**:PM 提到"系统模块"、"功能结构"、"前端后端"、"用户流程"、"干系人关系"等。
|
|
212
|
+
2. **主动生成**:使用 Diagram/Box/Arrow 组件生成架构图 JSON。
|
|
213
|
+
3. **提示预览**:告知 PM 刷新浏览器查看。
|
|
214
|
+
4. **迭代修改**:根据 PM 反馈调整结构。
|
|
215
|
+
5. **保存到文档**:将架构图嵌入到文档中(iframe 或链接形式)。
|
|
216
|
+
|
|
217
|
+
**详见**:
|
|
218
|
+
- `.agent/workflows/prd-p0-project-info.md`
|
|
219
|
+
- `.agent/workflows/prd-b1-planning-draft.md`
|
|
220
|
+
- `.agent/workflows/prd-b2-planning-breakdown.md`
|
|
221
|
+
|
|
222
|
+
---
|
|
223
|
+
|
|
146
224
|
## ⚙️ 分段写入规则(从 prd-incremental-save.md 合并)
|
|
147
225
|
|
|
148
226
|
### 铁律:确认一个,写入一个
|
|
@@ -337,17 +415,31 @@ C 阶段(版本)
|
|
|
337
415
|
|
|
338
416
|
---
|
|
339
417
|
|
|
340
|
-
##
|
|
418
|
+
## 📚 详细工作流
|
|
341
419
|
|
|
342
420
|
需要详细指导时,查看 `.agent/workflows/` 目录:
|
|
343
421
|
|
|
344
|
-
| 阶段 |
|
|
345
|
-
|
|
346
|
-
|
|
|
347
|
-
|
|
|
348
|
-
|
|
|
349
|
-
|
|
|
350
|
-
|
|
|
422
|
+
| 阶段 | 主文件 | 辅助文件 | 使用场景 |
|
|
423
|
+
|------|--------|----------|----------|
|
|
424
|
+
| P0 | `prd-p0-project-info.md` | - | 项目初始化时 |
|
|
425
|
+
| B1 | `prd-b1-planning-draft.md` | - | 填写规划草案时 |
|
|
426
|
+
| B2 | `prd-b2-planning-breakdown.md` | - | 规划拆解时 |
|
|
427
|
+
| C1 | `prd-c1-requirement-list.md` | `prd-c1-a2ui-guide.md` | 填写需求清单时 |
|
|
428
|
+
| R0 | `prd-r0-baseline-review.md` | - | 基线审视时 |
|
|
429
|
+
| R1 | `prd-r1-review.md` | - | 规划审视时 |
|
|
430
|
+
| R2 | `prd-r2-review.md` | - | 版本审视时 |
|
|
431
|
+
|
|
432
|
+
### C1 阶段的文件使用规则
|
|
433
|
+
|
|
434
|
+
| 场景 | 使用文件 |
|
|
435
|
+
|------|----------|
|
|
436
|
+
| C1 整体流程、红线、9 个维度 | `prd-c1-requirement-list.md` |
|
|
437
|
+
| 界面示意 (A2UI) 详细操作 | `prd-c1-a2ui-guide.md` |
|
|
438
|
+
|
|
439
|
+
**AI 行为**:
|
|
440
|
+
1. 进入 C1 阶段时,先读取 `prd-c1-requirement-list.md` 了解核心规则
|
|
441
|
+
2. 当需要生成界面示意时,参考 `prd-c1-a2ui-guide.md` 的详细指导
|
|
442
|
+
3. A2UI 是 C1 的第 6 个维度(推荐),不是必须,但强烈建议执行
|
|
351
443
|
|
|
352
444
|
---
|
|
353
445
|
|