docs: 定义需求记录术语 (#10)

2026-08-10 11:51:14 +08:00
parent ea39122174
commit f78f2f92f5
1 changed files with 5 additions and 0 deletions
@@ -11,6 +11,9 @@
 | Epic | 完整产品目标和长期路线 | 可以直接实施的单个任务 |
 | MVP | 第一个可交付范围及集成边界 | 任意里程碑名称 |
 | 单元任务 | 唯一正式实施单位，可独立测试和回退 | 临时聊天待办 |
+| 关键原始需求 | 能表达用户目的、场景和限制的少量原话或脱敏摘要 | 完整聊天记录 |
+| 正式任务需求 | 用户确认后写入单元工单的目标、非目标、方案和验收标准 | Agent 未确认的理解 |
+| 需求变化记录 | 实施期间影响范围或验收的变化、原因及用户确认 | 每一句普通讨论 |
 | 事实来源 | 某类信息被正式维护的位置 | 多处内容可以随意覆盖 |
 | Wiki 主源 | 长期开发文档首先修改的位置 | 本地 docs 的备份副本 |
 | docs 镜像 | 从 Wiki 单向生成的浏览副本 | 可以直接编辑并反向同步的文档 |
@@ -35,6 +38,8 @@
 - 建立后续工单不要求已有工单全部完成；实施前必须检查工单声明的前置依赖。
 - 前置工单未完成且存在实际依赖时保持“待实施”；允许并行时必须写明原因。
 - 需求、接口、数据、安全边界或验收标准变化时先更新工单。
+- 工单只保存关键原始需求、确认后的正式需求和重要变化，不保存完整聊天或 Agent 内部推理。
+- 长期有效的产品需求和业务规则进入 Wiki；Gitea 工单全文不导出到本地。
 - 长期文档必须先修改 Wiki，再导出本地镜像。
 - 测试结果必须真实；未执行的验证必须明确记录。
 - 用户未明确验收前，工单保持开启。