prd-workflow-cli 1.1.25

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.
@@ -0,0 +1,907 @@
1
+ ---
2
+ description: C1 版本需求清单填写工作流
3
+ ---
4
+
5
+ # C1 版本需求清单填写工作流
6
+
7
+ **核心原则**:忠实于 B3,不新增范围 + 完整记录所有细节。C1 是 AODW 的输入源!
8
+
9
+ ---
10
+
11
+ ## 🚨 C1 创建时的强制启动检查
12
+
13
+ **⚠️ AI 绝对禁止在未与 PM 对话的情况下填充 C1 内容!**
14
+
15
+ ### 当检测到 C1 文档被创建时
16
+
17
+ **AI 必须执行以下流程:**
18
+
19
+ ```
20
+ AI: "✅ C1_版本需求清单.md 已创建。
21
+
22
+ 在填写 C1 之前,我需要确认并细化每个需求。
23
+
24
+ 🚨 重要原则:
25
+ - C1 只能包含 B3 冻结的首版范围
26
+ - AI 必须逐项询问需求细节
27
+ - 禁止省略细节或边界情况
28
+ - 必须完整记录 PM 说的所有内容
29
+
30
+ 首先,让我确认 B3 首版包含的需求项...
31
+
32
+ [读取 B3 首版范围]
33
+
34
+ 确认 C1 将基于这些需求展开,不会新增。对吗?"
35
+ ```
36
+
37
+ ---
38
+
39
+ ## AI 行为红线(C1 创建时)
40
+
41
+ **AI 在 C1 创建后绝对禁止:**
42
+
43
+ 1. ❌ **未经对话就填充需求细节**
44
+ - 禁止直接写需求描述、验收标准等
45
+ - 必须逐项询问 PM
46
+
47
+ 2. ❌ **省略或简化需求细节**
48
+ - 不能只写标题和简单描述
49
+ - 必须包含 8 个维度的完整信息
50
+
51
+ 3. ❌ **新增 B3 范围外的需求**
52
+ - 必须严格映射 B3 首版需求
53
+ - 发现新增需求时必须提醒 PM
54
+
55
+ 4. ❌ **不记录 PM 的特殊说明**
56
+ - PM 的强调和注意事项必须全部记录
57
+ - 不能遗漏任何细节
58
+
59
+ 5. ❌ **允许 PM 跳过必填内容(重要!)**
60
+ - **禁止接受"跳过"、"先不填"、"之后再说"等请求**
61
+ - 必须坚持完成必填内容后才能进入下一项
62
+
63
+ **AI 必须做到:**
64
+
65
+ 1. ✅ 严格检查 C1 与 B3 的映射关系
66
+ 2. ✅ 逐项询问需求的 8 个维度
67
+ 3. ✅ 完整记录所有细节(背景/规则/边界/性能...)
68
+ 4. ✅ 分段确认后才写入
69
+ 5. ✅ **拒绝跳过必填内容**
70
+
71
+ ---
72
+
73
+ ## 🚨 禁止跳过必填内容(关键规则!)
74
+
75
+ ### 问题背景
76
+
77
+ PM 在填写 C1 时,可能会说:
78
+ - "这个跳过吧"
79
+ - "先不填,之后再说"
80
+ - "这个我不太清楚,跳过"
81
+ - "太细了,不需要"
82
+
83
+ **如果 AI 允许跳过,会导致:**
84
+ - 需求文档不完整
85
+ - 研发无法执行
86
+ - 交付后反复返工
87
+ - 用户不满意
88
+
89
+ ### AI 必须拒绝跳过的必填内容
90
+
91
+ **C1 的 8 个维度中,以下 5 个是必填的:**
92
+
93
+ | 维度 | 是否必填 | 不填的后果 |
94
+ |-----|---------|-----------|
95
+ | 1. 需求背景 | ✅ 必填 | 研发不理解为什么做 |
96
+ | 2. 需求描述 | ✅ 必填 | 根本不知道做什么 |
97
+ | 3. 业务规则 | ✅ 必填 | 实现逻辑会出错 |
98
+ | 4. 验收标准 | ✅ 必填 | 无法判断是否完成 |
99
+ | 5. 边界情况 | ✅ 必填 | 异常处理会遗漏 |
100
+ | 6. 非功能需求 | ⚠️ 视情况 | 性能问题可后补 |
101
+ | 7. 特殊说明 | ⚠️ 视情况 | 可以没有 |
102
+ | 8. 附加信息 | ⚠️ 视情况 | 可以简化 |
103
+
104
+ ### AI 拒绝跳过的对话示例
105
+
106
+ ```
107
+ PM: "验收标准这个跳过吧,太细了"
108
+
109
+ ❌ 错误的 AI 反应:
110
+ AI: "好的,跳过验收标准,继续下一项..."
111
+
112
+ ✅ 正确的 AI 反应:
113
+ AI: "⚠️ 验收标准是必填项,不能跳过。
114
+
115
+ 原因:
116
+ 1. 没有验收标准,无法判断需求是否完成
117
+ 2. 研发和测试会反复问'这个算完成吗?'
118
+ 3. 上线后可能因理解不一致产生争议
119
+
120
+ 验收标准不需要很复杂,只需要回答:
121
+ - 做到什么程度算'完成'?
122
+ - 用什么方法可以验证?
123
+
124
+ 请给出至少 2-3 条验收标准。"
125
+ ```
126
+
127
+ ```
128
+ PM: "边界情况我不太清楚,先跳过"
129
+
130
+ ✅ 正确的 AI 反应:
131
+ AI: "⚠️ 边界情况是必填项,不能跳过。
132
+
133
+ 我理解您可能还没想清楚,让我帮您梳理。
134
+
135
+ 常见的边界情况包括:
136
+ 1. 网络断开时怎么办?
137
+ 2. 数据为空或异常时怎么处理?
138
+ 3. 用户快速重复操作时怎么办?
139
+ 4. 没有权限时怎么提示?
140
+
141
+ 请针对这个需求,逐个告诉我您的预期。
142
+ 如果某一项确实不适用,可以标注'不适用'并说明原因。"
143
+ ```
144
+
145
+ ```
146
+ PM: "这个需求背景很明显,不用写了吧"
147
+
148
+ ✅ 正确的 AI 反应:
149
+ AI: "⚠️ 需求背景是必填项。
150
+
151
+ 虽然您觉得'很明显',但研发和测试可能不清楚:
152
+ - 这个需求解决什么问题?
153
+ - 为什么现在要做?
154
+ - A2 中对应哪条用户反馈?
155
+
156
+ 请用 1-2 句话说明背景,我来记录。"
157
+ ```
158
+
159
+ ### PM 坚持要跳过时的处理
160
+
161
+ **如果 PM 多次坚持要跳过必填内容:**
162
+
163
+ ```
164
+ PM: "我说了跳过,你就跳过!"
165
+
166
+ AI: "⚠️ 我理解您希望加快进度,但必填内容缺失会导致严重问题。
167
+
168
+ ❌ 如果现在跳过:
169
+ - 研发可能做错(没有明确规则)
170
+ - 测试无法验收(没有验收标准)
171
+ - 上线后可能返工(用户不满意)
172
+
173
+ ✅ 两个选择:
174
+ 1. 花 2 分钟快速说明,我帮您记录
175
+ 2. 暂停 C1,先确认需求细节后再继续
176
+
177
+ 请选择。
178
+
179
+ 注意:跳过必填内容会在 R2 审视时被标记为'不通过'。"
180
+ ```
181
+
182
+ ### 记录跳过行为
183
+
184
+ **如果 PM 最终坚持跳过,AI 必须:**
185
+
186
+ 1. **在文档中标注缺失**
187
+ ```markdown
188
+ ### 验收标准
189
+
190
+ ⚠️ **待补充** - PM 要求暂时跳过
191
+ - [ ] 需要在 R2 审视前补充完整
192
+ ```
193
+
194
+ 2. **在汇总中警告**
195
+ ```
196
+ AI: "⚠️ 警告:C1 有 2 处必填内容缺失:
197
+ - 需求 #3:验收标准(必填)
198
+ - 需求 #5:边界情况(必填)
199
+
200
+ 这会导致 R2 审视不通过。
201
+ 请在提交 R2 之前补充。"
202
+ ```
203
+
204
+ 3. **在 R2 审视时严格扣分**
205
+ - 每缺失一个必填维度,需求粒度成熟度扣 20%
206
+
207
+ ---
208
+
209
+ ## 🚨 新增需求检测机制(从 prd-change-control.md 合并)
210
+
211
+ ### 触发检查的信号词
212
+
213
+ **当 PM 说以下话时,AI 必须立即检查是否是 B3 范围外的新增需求:**
214
+
215
+ | PM 说的话 | 触发检查 |
216
+ |----------|---------|
217
+ | "我还要加一个需求" | ✅ 必须检查 |
218
+ | "对了,还需要..." | ✅ 必须检查 |
219
+ | "另外还有一个功能..." | ✅ 必须检查 |
220
+ | "顺便把...也做了" | ✅ 必须检查 |
221
+ | "能不能再加一个..." | ✅ 必须检查 |
222
+ | "我想到一个新的..." | ✅ 必须检查 |
223
+
224
+ ### AI 检查流程(4步)
225
+
226
+ **第1步:暂停并确认**
227
+ ```
228
+ AI: "您提到的'批量启动'功能,我需要确认一下:
229
+ 这个功能在 B3 冻结的规划中吗?"
230
+ ```
231
+
232
+ **第2步:检查 B3**
233
+ ```
234
+ AI: [读取 B3 文件]
235
+ "我检查了 B3_规划冻结归档.md,
236
+ 在规划范围中没有找到'批量启动'相关内容。"
237
+ ```
238
+
239
+ **第3步:提示违规**
240
+ ```
241
+ AI: "⚠️ 根据规范,这是一个规划外的新增需求。
242
+ C1 阶段禁止引入 B3 范围外的功能。"
243
+ ```
244
+
245
+ **第4步:提供选择(注意:没有"加入本次"选项)**
246
+ ```
247
+ AI: "如果要处理这个需求,您有两个选择:
248
+ 1. 📝 暂存到 A2(推荐)→ 下一轮迭代处理
249
+ 2. 🔄 解冻 B3 → 重新走 R1 审视流程
250
+
251
+ 请问您选择哪个?"
252
+ ```
253
+
254
+ ### 区分"允许的补充"和"禁止的新增"
255
+
256
+ **✅ 这些是允许的补充:**
257
+ - 细化验收标准("启动时校验必填项" → 具体哪些必填)
258
+ - 补充边界情况("如果网络断开怎么办")
259
+ - 明确交互细节("弹窗还是 toast")
260
+
261
+ **❌ 这些是禁止的新增:**
262
+ - 新功能("加一个批量启动")
263
+ - 扩展范围("不只是目标,关键成果也要")
264
+ - 新的业务逻辑("再加一个审批流程")
265
+
266
+ ---
267
+
268
+ ## C1 的本质:忠实于 B3,不新增范围 + 完整记录所有细节
269
+
270
+ ### ⚠️ 关键原则:C1 是 AODW 的输入源
271
+
272
+ **C1 必须记录 PM 说的所有内容,包括:**
273
+ - 需求的背景和原因
274
+ - 业务规则和约束
275
+ - 边界情况和异常处理
276
+ - PM 的特殊说明和强调
277
+ - 实现时的注意事项
278
+
279
+ **如果 C1 丢失细节,后续 AODW 会出现需求理解偏差!**
280
+
281
+ ---
282
+
283
+ ## Step 1: 严格映射检查
284
+
285
+ **AI 的第一个问题(必须问)**:
286
+
287
+ ```
288
+ AI: "在填写 C1 之前,我需要确认:
289
+
290
+ C1 只能包含 B3 首版范围内的需求项。
291
+
292
+ 让我先列出 B3 的首版需求:
293
+ [列出 B3 的首版需求]
294
+
295
+ C1 将基于这些需求展开,不会新增。确认吗?"
296
+ ```
297
+
298
+ ### AI 必须拒绝新增
299
+
300
+ ```
301
+ PM: "对了,还想加一个批量启动功能..."
302
+
303
+ AI: "⚠️ 请注意:
304
+
305
+ '批量启动'在 B3 的规划范围内吗?
306
+
307
+ [检查 B3]
308
+
309
+ 我检查了 B3,没有找到'批量启动'。
310
+
311
+ 根据规范,C 阶段禁止新增规划外需求。
312
+
313
+ 请选择:
314
+ 1. 📝 暂存到 A2(推荐)- 保存到下一轮迭代
315
+ 2. 🔄 解冻 B3 - 重新审视后再冻结
316
+
317
+ 您选择哪个?"
318
+ ```
319
+
320
+ ---
321
+
322
+ ## 🔴 关键规则:超范围需求的处理(新增需求暂存机制)
323
+
324
+ **当 C1 讨论中产生新需求但不属于当前版本时,必须严格执行以下流程:**
325
+
326
+ ### 🚨 AI 强制行为
327
+
328
+ **当 PM 提出新需求时,AI 必须:**
329
+
330
+ 1. **立即检查 B3 范围**
331
+ 2. **如果超出范围,明确告知:此需求不能加入本次迭代**
332
+ 3. **给出唯一选择:暂存到 A2(等待下一轮迭代)**
333
+ 4. **或者解冻 B3 重新规划(这是一个重大决策)**
334
+
335
+ ### ❌ 极其错误的 AI 行为
336
+
337
+ ```
338
+ AI: "这是新需求。需要加入本次迭代还是放到下一迭代?"
339
+ ```
340
+
341
+ **这是绝对禁止的!**
342
+
343
+ **原因**:C1 阶段只能基于 B3 冻结的内容,**根本不存在"加入本次迭代"的选项**!
344
+
345
+ ### ✅ 正确的 AI 行为
346
+
347
+ ```
348
+ PM: "对了,还需要一个 BP 看板来显示超时待办"
349
+
350
+ AI: "⚠️ 范围检查:
351
+
352
+ 'BP 看板显示超时待办' 不在 B3 首版范围内。
353
+
354
+ ❌ 根据规范,C1 阶段不能新增需求到本次迭代。
355
+
356
+ 您有两个选择:
357
+
358
+ 1. 📝 暂存到 A2(推荐)
359
+ - 记录到 A2 的"待下版事项"
360
+ - 下一轮迭代时纳入 B1 规划
361
+ - 当前版本继续按 B3 执行
362
+
363
+ 2. 🔄 解冻 B3,重新规划(谨慎)
364
+ - 需要重新执行 R1 审视
365
+ - 整个规划周期重来
366
+ - 仅限于发现重大遗漏时使用
367
+
368
+ 请选择处理方式。"
369
+ ```
370
+
371
+ ### 暂存到 A2 的执行流程
372
+
373
+ ```
374
+ PM: "暂存到 A2 吧"
375
+
376
+ AI: "好的,我将此需求记录到 A2。
377
+
378
+ 📝 写入位置:01_产品基线/A2_存量反馈与数据汇总.md
379
+ 📍 章节:五、待下版事项
380
+
381
+ 内容:
382
+ ---
383
+ ### 待下版事项:BP 看板显示超时待办
384
+ - **来源**:C1 讨论过程(当前第 01 轮迭代)
385
+ - **原因**:超出 B3 首版范围,延后处理
386
+ - **优先级**:[待定]
387
+ - **详细描述**:[PM 的需求描述]
388
+ - **记录时间**:[当前时间]
389
+ ---
390
+
391
+ ✅ 已写入 A2。此需求将在下一轮迭代时纳入 B1 规划。
392
+
393
+ 现在继续 C1 当前版本的需求讨论。"
394
+ ```
395
+
396
+ ### A2 暂存的记录格式
397
+
398
+ **AI 必须按以下格式写入 A2:**
399
+
400
+ ```markdown
401
+ ## 四、已知未解决事项
402
+
403
+ ### 待下版事项 #1:批量导入功能
404
+
405
+ **来源**:C1 讨论过程(第 01 轮迭代,2025-12-22)
406
+ **原因**:超出 B3 首版范围
407
+
408
+ **优先级**:
409
+ - [ ] P0 - 紧急
410
+ - [x] P1 - 重要
411
+ - [ ] P2 - 一般
412
+
413
+ **详细描述**:
414
+ 用户需要批量导入数据,而不是逐条手动创建。
415
+ 目前只支持单条创建,批量操作需求来自多个用户反馈。
416
+
417
+ **PM 补充说明**:
418
+ (在 C1 讨论中 PM 的原话)
419
+
420
+ **关联需求**:
421
+ 与 REQ-003 数据管理有关
422
+
423
+ **记录时间**:2025-12-22 15:30
424
+ **记录人**:AI 辅助记录
425
+ ```
426
+
427
+ ### ⚠️ AI 禁止行为
428
+
429
+ 在 C1 讨论中,AI 绝对禁止:
430
+
431
+ 1. ❌ **将超范围需求直接写入 C1**
432
+ 2. ❌ **忽略新需求不做任何处理**
433
+ 3. ❌ **让 PM 自己记住下次要做什么**
434
+ 4. ❌ **只口头说"下次做"但不写入 A2**
435
+
436
+ ### ✅ AI 必须做到
437
+
438
+ 1. ✅ **发现超范围需求立即提醒**
439
+ 2. ✅ **引导 PM 做出明确选择**
440
+ 3. ✅ **选择暂存后立即写入 A2**
441
+ 4. ✅ **写入后确认并继续当前版本讨论**
442
+
443
+ ---
444
+
445
+ ## Step 2: 逐项细化(完整记录所有细节)
446
+
447
+ **AI 对每个 B3 需求项的处理方式:**
448
+
449
+ ### 2.1 需求背景和目的
450
+
451
+ ```
452
+ AI: "B3 需求项 #1:进度指示器
453
+
454
+ 首先,让我了解背景:
455
+
456
+ 1. 为什么需要这个功能?解决什么问题?
457
+ 2. 当前用户遇到了什么困难?
458
+ 3. 这个需求对应 A2 中的哪些反馈?
459
+
460
+ 请详细说明,我会全部记录到 C1 中。"
461
+ ```
462
+
463
+ ### 2.2 需求描述(用户视角)
464
+
465
+ ```
466
+ AI: "现在描述需求本身:
467
+
468
+ 1. 用户看到的具体表现是什么?
469
+ - 界面上会出现什么?
470
+ - 用户如何与之交互?
471
+
472
+ 2. 操作流程是怎样的?
473
+ - 第一步?
474
+ - 第二步?
475
+ - 最后一步?
476
+
477
+ 请尽可能详细,这些细节会直接影响后续设计和开发。"
478
+ ```
479
+
480
+ ### 2.3 核心业务规则
481
+
482
+ ```
483
+ AI: "这个需求有哪些业务规则?
484
+
485
+ 例如:
486
+ - 什么情况下显示?什么情况下不显示?
487
+ - 数据如何计算?
488
+ - 时间限制?权限限制?
489
+
490
+ 请逐条说明,我会全部记录。"
491
+ ```
492
+
493
+ ### 2.4 验收标准(可测试)
494
+
495
+ ```
496
+ AI: "如何验证这个需求完成了?
497
+
498
+ 请给出可测试的验收标准:
499
+ - 标准 1:具体要达到什么状态
500
+ - 标准 2:如何验证
501
+ - 标准 3:边界条件
502
+
503
+ 避免模糊表述如'体验好''用户满意'。"
504
+ ```
505
+
506
+ ### 2.5 边界情况和异常处理
507
+
508
+ ```
509
+ AI: "现在考虑边界情况:
510
+
511
+ 1. 网络断开时怎么办?
512
+ 2. 数据异常(如为空、过大)时怎么处理?
513
+ 3. 并发操作时的表现?
514
+ 4. 权限不足时?
515
+
516
+ 请说明每种情况的预期行为,我会记录到 C1。"
517
+ ```
518
+
519
+ ### 2.6 特殊说明和注意事项
520
+
521
+ ```
522
+ AI: "还有什么特殊说明吗?
523
+
524
+ 比如:
525
+ - 性能要求(必须在 X 秒内响应)
526
+ - 兼容性要求(支持哪些浏览器/版本)
527
+ - 与其他功能的交互
528
+ - 实现时的特别注意事项
529
+
530
+ 请补充,我会全部记录。"
531
+ ```
532
+
533
+ ---
534
+
535
+ ## Step 3: 完整记录示例
536
+
537
+ **AI 写入 C1 的格式应该是:**
538
+
539
+ ```markdown
540
+ ### 需求 #1:进度指示器
541
+
542
+ **需求编号**:REQ-001
543
+ **来源**:B3 需求项 #1
544
+ **优先级**:P0
545
+
546
+ ---
547
+
548
+ #### 1. 需求背景
549
+
550
+ **解决的问题**:
551
+ 用户在创建 BP 时不知道当前进度,经常中途放弃。根据 A2 反馈
552
+ #3、#7、#12,用户表示"不知道还要填多少""填到哪一步了"。
553
+
554
+ **目标**:
555
+ 让用户清楚知道当前在第几步,还剩几步,减少放弃率。
556
+
557
+ **数据支撑**:
558
+ - 当前创建放弃率 40%
559
+ - 期望降至 10% 以下
560
+
561
+ ---
562
+
563
+ #### 2. 需求描述
564
+
565
+ **用户视角**:
566
+ 1. 用户进入 BP 创建流程时,页面顶部显示进度条
567
+ 2. 进度条显示:当前步骤 / 总步骤数(如"第 2 步,共 5 步")
568
+ 3. 已完成步骤显示绿色,当前步骤高亮,未完成步骤灰色
569
+ 4. 每完成一步,进度条自动前进
570
+
571
+ **操作流程**:
572
+ 1. 用户点击"创建 BP"按钮
573
+ 2. 系统展示进度条(初始:第 1 步,共 5 步)
574
+ 3. 用户填写第 1 步信息并点击"下一步"
575
+ 4. 进度条更新为"第 2 步,共 5 步",第 1 步显示绿色✅
576
+ 5. 重复直到第 5 步完成
577
+
578
+ ---
579
+
580
+ #### 3. 核心业务规则
581
+
582
+ 1. **步骤计算规则**:
583
+ - 总步骤数 = 基本信息 + 目标设定 + 关键成果 + 行动计划 + 确认提交 = 5 步
584
+ - 如果用户跳过"关键成果"(选填),总步骤数调整为 4 步
585
+
586
+ 2. **显示规则**:
587
+ - 进度条始终显示在页面顶部固定位置
588
+ - 在移动端缩小为圆形进度环(显示"2/5")
589
+
590
+ 3. **保存规则**:
591
+ - 进度随自动保存同步更新
592
+ - 用户退出后再进入,进度条恢复到上次位置
593
+
594
+ ---
595
+
596
+ #### 4. 验收标准
597
+
598
+ - [ ] **标准 1**:进入创建流程,立即显示进度条"第 1 步,共 5 步"
599
+ - [ ] **标准 2**:点击"下一步",进度条正确更新到"第 2 步"
600
+ - [ ] **标准 3**:已完成步骤显示绿色✅,当前步骤高亮,未完成步骤灰色
601
+ - [ ] **标准 4**:跳过选填步骤时,总步骤数正确调整
602
+ - [ ] **标准 5**:退出后再进入,进度条恢复到上次保存的位置
603
+ - [ ] **标准 6**:移动端显示圆形进度环
604
+
605
+ ---
606
+
607
+ #### 5. 边界情况处理
608
+
609
+ 1. **网络断开**:
610
+ - 进度条显示本地缓存的进度
611
+ - 顶部显示"离线模式"提示
612
+
613
+ 2. **数据异常**:
614
+ - 如果获取不到步骤数,默认显示"进行中..."
615
+ - 不阻塞用户继续操作
616
+
617
+ 3. **并发编辑**:
618
+ - 如果多人同时编辑同一 BP(极少见),以最后保存为准
619
+ - 进度条显示当前用户的进度
620
+
621
+ 4. **权限变更**:
622
+ - 如果创建过程中权限被收回,进度条置灰
623
+ - 显示提示"您已无权限继续创建"
624
+
625
+ ---
626
+
627
+ #### 6. 非功能需求
628
+
629
+ **性能要求**:
630
+ - 进度条更新必须在 100ms 内完成(用户无感知延迟)
631
+
632
+ **兼容性要求**:
633
+ - 支持 Chrome 90+、Safari 14+、Edge 90+
634
+ - 移动端支持 iOS 13+ 和 Android 9+
635
+
636
+ **无障碍要求**:
637
+ - 进度条必须有 ARIA 标签,支持屏幕阅读器
638
+
639
+ ---
640
+
641
+ #### 7. 特殊说明
642
+
643
+ **PM 强调**:
644
+ - 进度指示器是 CSF(关键成功因素),必须在首版实现
645
+ - 设计时参考"飞书文档创建"的进度条样式
646
+ - 不要做太炫酷的动画,简洁优先
647
+
648
+ **与其他功能的关联**:
649
+ - 依赖"自动保存"功能(REQ-005)
650
+ - 需要与"断点续作"(REQ-003)联动
651
+
652
+ **技术注意事项**:
653
+ - 前端需要状态管理来追踪当前步骤
654
+ - 后端需要提供"获取当前进度"API
655
+
656
+ ---
657
+
658
+ #### 8. 附加信息
659
+
660
+ **来源追溯**:
661
+ - B3 需求项 #1
662
+ - A2 用户反馈 #3、#7、#12
663
+
664
+ **讨论记录**:
665
+ - PM 在 2025-12-19 讨论中强调必须支持移动端
666
+ - 设计团队建议采用固定顶部方案
667
+
668
+ ---
669
+ ```
670
+
671
+ ---
672
+
673
+ ## Step 4: 确保完整性 - AI 检查清单
674
+
675
+ **AI 在写入每个需求前必须检查:**
676
+
677
+ ```
678
+ AI: "让我检查需求 #1 的完整性:
679
+
680
+ ✅ 完整性检查:
681
+ - [ ] 需求背景已记录(为什么要做)
682
+ - [ ] 需求描述已记录(做什么)
683
+ - [ ] 业务规则已记录(怎么做)
684
+ - [ ] 验收标准已记录(如何验证)
685
+ - [ ] 边界情况已记录(异常处理)
686
+ - [ ] 非功能需求已记录(性能/兼容性)
687
+ - [ ] PM 特殊说明已记录(重点/注意事项)
688
+ - [ ] 来源可追溯(到 B3)
689
+
690
+ 缺失项:[列出缺失的]
691
+
692
+ 请补充缺失的信息。"
693
+ ```
694
+
695
+ ---
696
+
697
+ ## Step 5: 分段写入 C1
698
+
699
+ **每确认 1 个需求的完整信息,就写入一次:**
700
+
701
+ ```
702
+ AI: "需求 #1 的所有细节已确认完整。
703
+
704
+ 我现在写入 C1,包括:
705
+ - 背景和目的
706
+ - 详细描述
707
+ - 业务规则
708
+ - 验收标准
709
+ - 边界情况
710
+ - 非功能需求
711
+ - 您的特殊说明
712
+
713
+ [执行写入]
714
+
715
+ 已写入。请检查此需求是否完整准确。"
716
+
717
+ PM: [确认]
718
+
719
+ AI: "确认。继续细化需求 #2..."
720
+ ```
721
+
722
+ ---
723
+
724
+ ## ⚠️ AI 绝对禁止在 C1 中
725
+
726
+ 1. ❌ 只写标题和简单描述,丢失 PM 说的细节
727
+ 2. ❌ 省略业务规则或边界情况
728
+ 3. ❌ 不记录 PM 的特殊强调
729
+ 4. ❌ 验收标准太模糊(如"体验好")
730
+ 5. ❌ 不记录需求背景和原因
731
+
732
+ ---
733
+
734
+ ## ✅ AI 必须在 C1 中做到
735
+
736
+ 1. ✅ 完整记录 PM 阐述的所有内容
737
+ 2. ✅ 8 个维度都填写完整(背景/描述/规则/验收/边界/性能/说明/追溯)
738
+ 3. ✅ 确保后续 AODW 能直接使用这些信息
739
+ 4. ✅ 每个细节都不遗漏
740
+ 5. ✅ 结构化整理,而非杂乱的对话记录
741
+
742
+ ---
743
+
744
+ ## Step 6: 归档对话(AI 必须执行)
745
+
746
+ **⚠️ AI 绝对禁止不归档对话!**
747
+
748
+ ### 归档时机
749
+
750
+ **每完成 1 个需求的 8 个维度填写,AI 必须立即归档:**
751
+
752
+ | 完成环节 | 归档内容 |
753
+ |---------|---------|
754
+ | 需求背景 | PM 的说明、AI 的追问、背景澄清过程 |
755
+ | 需求描述 | PM 的详细描述、AI 的总结确认 |
756
+ | 业务规则 | PM 列举的规则、AI 的逐条记录 |
757
+ | 验收标准 | PM 的标准、AI 的可测试性检查 |
758
+ | 边界情况 | PM 对各种情况的说明、AI 的补充提问 |
759
+ | 非功能需求 | 性能、兼容性、安全等要求 |
760
+ | 特殊说明 | PM 的强调和注意事项(完整保留原话)|
761
+ | 附加信息 | 来源追溯、讨论记录 |
762
+
763
+ ### 归档位置
764
+
765
+ - **基线阶段**:`98_对话归档/C1_对话记录.md`
766
+ - **迭代阶段**:`98_对话归档/第01轮迭代/C1_对话记录.md`
767
+
768
+ ### 归档格式
769
+
770
+ 使用模板:`templates/dialog-template.md`
771
+
772
+ **归档示例**:
773
+
774
+ ```markdown
775
+ ## 💬 对话 #1
776
+
777
+ **时间**: 2025-12-19 17:00:00
778
+ **讨论主题**: REQ-001 进度指示器 - 8 个维度细化
779
+
780
+ ### 🤖 AI 询问(维度 1:需求背景)
781
+ > B3 需求项 #1:进度指示器
782
+ >
783
+ > 首先,让我了解背景:
784
+ > 1. 为什么需要这个功能?解决什么问题?
785
+ > 2. 当前用户遇到了什么困难?
786
+ > 3. 这个需求对应 A2 中的哪些反馈?
787
+
788
+ ### 🧑 PM 回答
789
+ > 用户在创建 BP 时不知道当前进度,经常中途放弃。
790
+ > A2 反馈 #3、#7、#12 都提到"不知道还要填多少"。
791
+ > 当前创建放弃率 40%,期望降至 10% 以下。
792
+
793
+ ### 📝 AI 记录
794
+ > 已记录需求背景到 C1
795
+
796
+ ---
797
+
798
+ ### 🤖 AI 询问(维度 2:需求描述)
799
+ > 现在描述需求本身:
800
+ > 1. 用户看到的具体表现是什么?
801
+ > 2. 操作流程是怎样的?
802
+
803
+ ### 🧑 PM 回答
804
+ > 页面顶部显示进度条,显示"第 X 步,共 Y 步"。
805
+ > 已完成的显示绿色,当前步骤高亮,未完成灰色。
806
+ > 用户点击"下一步"时自动前进。
807
+ > 移动端显示圆形进度环。
808
+
809
+ ### 📝 AI 记录
810
+ > 已记录需求描述到 C1
811
+
812
+ ---
813
+
814
+ ### 🤖 AI 询问(维度 3:业务规则)
815
+ > 这个需求有哪些业务规则?
816
+
817
+ ### 🧑 PM 回答
818
+ > 总步骤数 = 5 步(基本信息 + 目标 + 成果 + 计划 + 确认)
819
+ > 如果跳过选填项,总步骤数调整
820
+ > 进度随自动保存同步更新
821
+
822
+ ### 📝 AI 记录
823
+ > 已记录业务规则到 C1
824
+
825
+ ---
826
+
827
+ ### 🤖 AI 询问(维度 7:特殊说明)
828
+ > PM,还有什么特殊说明吗?
829
+
830
+ ### 🧑 PM 强调
831
+ > 这是 CSF,必须首版实现!
832
+ > 参考飞书文档创建的进度条样式!
833
+ > 不要做太炫酷的动画,简洁优先!
834
+
835
+ ### 📝 AI 记录
836
+ > 已完整记录 PM 的 3 个强调到 C1 特殊说明
837
+
838
+ ---
839
+
840
+ ### ✅ 需求完整性检查
841
+ > ✅ 8 个维度全部记录完整
842
+ > ✅ PM 的原话已保留
843
+ > ✅ 所有细节已记录
844
+
845
+ ### 📝 AI 执行
846
+ > 已将 REQ-001 的完整信息写入 C1
847
+
848
+ ---
849
+ ```
850
+
851
+ ### AI 归档检查清单
852
+
853
+ 在写入 C1 每个需求前,AI 必须确认:
854
+
855
+ - [ ] 已记录 8 个维度的完整讨论过程
856
+ - [ ] 已记录 AI 对每个维度的逐项询问
857
+ - [ ] 已记录 PM 的完整回答(保留原话)
858
+ - [ ] 已记录 PM 的特殊说明和强调
859
+ - [ ] 已标注需求编号和时间戳
860
+ - [ ] 已写入对话归档文件
861
+
862
+ ---
863
+
864
+ ## 🔄 C1 完成后的下一步
865
+
866
+ ```
867
+ AI: "C1_版本需求清单已完成。
868
+
869
+ 统计:
870
+ - 总需求项:[N] 个
871
+ - 已细化:[N] 个
872
+ - 平均完成度:100%
873
+
874
+ 检查清单:
875
+ - [✓] 所有需求都有完整的 8 个维度
876
+ - [✓] 所有验收标准都可测试
877
+ - [✓] 所有边界情况都已说明
878
+ - [✓] PM 的特殊说明都已记录
879
+
880
+ 下一步:
881
+ 1. 执行 R2 版本审视
882
+ 运行:prd review r2
883
+
884
+ 2. 或者先修改 C1
885
+ 如需修改,请告诉我要调整的需求
886
+
887
+ 您选择哪个?"
888
+ ```
889
+
890
+ ---
891
+
892
+ ## 📋 C1 需求的 8 个维度
893
+
894
+ 为确保完整性,每个需求必须包含:
895
+
896
+ 1. **需求背景** - 为什么要做,解决什么问题
897
+ 2. **需求描述** - 用户视角的详细说明
898
+ 3. **业务规则** - 业务逻辑和约束
899
+ 4. **验收标准** - 可测试的完成标准
900
+ 5. **边界情况** - 异常处理和特殊场景
901
+ 6. **非功能需求** - 性能、兼容性、安全等
902
+ 7. **特殊说明** - PM 强调和注意事项
903
+ 8. **附加信息** - 来源追溯、讨论记录
904
+
905
+ ---
906
+
907
+ **记住:C1 是产品需求的最终形态,是交付给后续所有环节(AODW/研发/测试)的唯一依据!**