Grill-Task — 需求澄清 + 字段对齐

Contract

• 输入: TASK_CONFIRM_*.md、paths/knowledge-path.md、用户需求笔记
• 输出: REVIEW_需求确认书.md、REVIEW_字段对齐分析.md
• 门控: python3 scripts/task-confirm-check.py --strict TASK_CONFIRM_*.md REVIEW_需求确认书.md REVIEW_字段对齐分析.md 通过;用户白名单话术签字
• Required rules: stage-gate, no-field-guessing, context-pointer, goal-boundary
• Required paths: knowledge-path, doc-naming-path
• 下一步: /to-brd

适用场景

• 用户提出新需求时
• 需求涉及现有表查询/维护类功能
• 团队对需求理解不一致时

流程步骤

1. 生成《需求确认表》

• 加载 templates/TASK_CONFIRM.md
• 替换项目名、日期,生成 TASK_CONFIRM_{项目名}.md 到工作目录
• 告知用户填写并保存

2. 用户填写后,生成《需求确认书》

• 读取用户填写的 TASK_CONFIRM_*.md
• 加载 templates/REVIEW_需求确认书.md
• 逐项标注 AI 助手的理解,列出待确认的设计假设
• 输出 REVIEW_需求确认书.md

3. 字段对齐分析(涉及现有表时强制)

• 提取需求中提到的所有表名和字段名
• 与 knowledge-path.md 引用的知识库核对
• 输出 REVIEW_字段对齐分析.md,分类标注:
• ✅ 已对齐
• ⚠️ 需 JOIN
• ❓ 待确认(业务同义不同名)
• 🔴 缺失

4. 阶段 2 出口门控(唯一脚本)

• 跑 python3 scripts/task-confirm-check.py --strict TASK_CONFIRM_*.md REVIEW_需求确认书.md REVIEW_字段对齐分析.md
• task-confirm-check.py 是阶段 2 唯一门控脚本
• field-alignment-check.py 不接 TASK_CONFIRM / REVIEW 文档,不得用于阶段 2 出口门控

关键纪律

• 用户填写完 TASK_CONFIRM 后,严禁直接跳进设计
• 必须先出确认书让用户审阅
• 用户确认通过 → 进入 /to-brd
• 字段对齐有 🔴 或 ❓ → task-confirm-check.py --strict 必须失败,严禁进入下一步

调用的 rule

• rules/no-field-guessing — 严禁猜测字段名
• rules/no-self-invent — 严禁自创字段
• rules/context-pointer — 三层知识库加载

关键纪律（2026-06-24 更新）

• ❌ 删除"4 章节"表述——实际为 5 章节（一~五）
• 阶段 2 只允许 scripts/task-confirm-check.py 作为出口门控脚本
• field-alignment-check.py 只校验 PRD/FSD/设计文档字段引用,不接 TASK_CONFIRM / REVIEW
• 🟡 删除：状态字段不再有 🟡 中间态，仅 ⬜/✅ 二态
• 🔒 HARD GATE：用户必须用白名单话术之一明确签字，LLM 不接受隐式同意

结束条件

• [ ] TASK_CONFIRM 状态字段 = ✅ 已确认（二态，无 🟡）
• [ ] TASK_CONFIRM 5 个必备章节（一~五）填完
• [ ] TASK_CONFIRM 无 12 词 TBD（见 scripts/task-confirm-check.py TBD_KEYWORDS）
• [ ] REVIEW_需求确认书 第八节"待明确事项"为空
• [ ] REVIEW_字段对齐分析 对齐结论表中 ❓=0 且 🔴=0（⚠️ 可保留，状态字段可为 ✅ 或 ⚠️）
• [ ] python3 scripts/task-confirm-check.py --strict TASK_CONFIRM_*.md REVIEW_需求确认书.md REVIEW_字段对齐分析.md exit 0
• [ ] 用户白名单话术签字（详见 templates/TASK_CONFIRM.md L48-55）

反模式

• ❌ TASK_CONFIRM 留 TBD 直接进 BRD — TBD 必须先闭环（确认/补资料/豁免）才能签字
• ❌ 把 field-alignment-check.py 当 2→3 门控 — 应是 task-confirm-check.py(同时校验 3 份产物)
• ❌ 接受 "OK/好/继续" 作为签字 — 必须 4 句白名单之一(我已全部确认,可以进入下一步 / 确认通过 / 全部完成,继续 / approved, proceed to next stage)
• ❌ 中间态(🟡)混入二态 — ⬜/✅ 二态,无 🟡;若需"进行中"用 ⬜(未完成)表达
• ❌ 一轮提问就停下 — 必须反复澄清到 5 节全填,无 TBD 才出"需求确认书"
• ❌ 字段对齐直接写"✅ 正确" — 必须给证据:字段路径 + 知识库章节 + 引用 URL