$npx -y skills add BlueprintOS/analysis-to-delivery --skill grill-task需求澄清 + 字段对齐分析 — 反复提问拉齐用户意图,生成 TASK_CONFIRM 任务确认书与字段对齐分析报告。启动新需求、或需要与现有数据库表对齐字段名时调用本 skill。
| 1 | # Grill-Task — 需求澄清 + 字段对齐 |
| 2 | |
| 3 | ## Contract |
| 4 | |
| 5 | - 输入: `TASK_CONFIRM_*.md`、`paths/knowledge-path.md`、用户需求笔记 |
| 6 | - 输出: `REVIEW_需求确认书.md`、`REVIEW_字段对齐分析.md` |
| 7 | - 门控: `python3 scripts/task-confirm-check.py --strict TASK_CONFIRM_*.md REVIEW_需求确认书.md REVIEW_字段对齐分析.md` 通过;用户白名单话术签字 |
| 8 | - Required rules: `stage-gate`, `no-field-guessing`, `context-pointer`, `goal-boundary` |
| 9 | - Required paths: `knowledge-path`, `doc-naming-path` |
| 10 | - 下一步: `/to-brd` |
| 11 | |
| 12 | ## 适用场景 |
| 13 | |
| 14 | - 用户提出新需求时 |
| 15 | - 需求涉及现有表查询/维护类功能 |
| 16 | - 团队对需求理解不一致时 |
| 17 | |
| 18 | ## 流程步骤 |
| 19 | |
| 20 | ### 1. 生成《需求确认表》 |
| 21 | |
| 22 | - 加载 `templates/TASK_CONFIRM.md` |
| 23 | - 替换项目名、日期,生成 `TASK_CONFIRM_{项目名}.md` 到工作目录 |
| 24 | - 告知用户填写并保存 |
| 25 | |
| 26 | ### 2. 用户填写后,生成《需求确认书》 |
| 27 | |
| 28 | - 读取用户填写的 `TASK_CONFIRM_*.md` |
| 29 | - 加载 `templates/REVIEW_需求确认书.md` |
| 30 | - 逐项标注 AI 助手的理解,列出待确认的设计假设 |
| 31 | - 输出 `REVIEW_需求确认书.md` |
| 32 | |
| 33 | ### 3. 字段对齐分析(涉及现有表时强制) |
| 34 | |
| 35 | - 提取需求中提到的所有表名和字段名 |
| 36 | - 与 `knowledge-path.md` 引用的知识库核对 |
| 37 | - 输出 `REVIEW_字段对齐分析.md`,分类标注: |
| 38 | - ✅ 已对齐 |
| 39 | - ⚠️ 需 JOIN |
| 40 | - ❓ 待确认(业务同义不同名) |
| 41 | - 🔴 缺失 |
| 42 | |
| 43 | ### 4. 阶段 2 出口门控(唯一脚本) |
| 44 | |
| 45 | - 跑 `python3 scripts/task-confirm-check.py --strict TASK_CONFIRM_*.md REVIEW_需求确认书.md REVIEW_字段对齐分析.md` |
| 46 | - `task-confirm-check.py` 是阶段 2 唯一门控脚本 |
| 47 | - `field-alignment-check.py` 不接 TASK_CONFIRM / REVIEW 文档,不得用于阶段 2 出口门控 |
| 48 | |
| 49 | ## 关键纪律 |
| 50 | |
| 51 | - 用户填写完 TASK_CONFIRM 后,**严禁直接跳进设计** |
| 52 | - 必须先出确认书让用户审阅 |
| 53 | - 用户确认通过 → 进入 `/to-brd` |
| 54 | - 字段对齐有 🔴 或 ❓ → `task-confirm-check.py --strict` 必须失败,严禁进入下一步 |
| 55 | |
| 56 | ## 调用的 rule |
| 57 | |
| 58 | - `rules/no-field-guessing` — 严禁猜测字段名 |
| 59 | - `rules/no-self-invent` — 严禁自创字段 |
| 60 | - `rules/context-pointer` — 三层知识库加载 |
| 61 | |
| 62 | ## 关键纪律(2026-06-24 更新) |
| 63 | |
| 64 | - ❌ 删除"4 章节"表述——实际为 5 章节(一~五) |
| 65 | - 阶段 2 只允许 `scripts/task-confirm-check.py` 作为出口门控脚本 |
| 66 | - `field-alignment-check.py` 只校验 PRD/FSD/设计文档字段引用,不接 TASK_CONFIRM / REVIEW |
| 67 | - 🟡 删除:状态字段不再有 🟡 中间态,仅 ⬜/✅ 二态 |
| 68 | - 🔒 HARD GATE:用户必须用白名单话术之一明确签字,LLM 不接受隐式同意 |
| 69 | |
| 70 | ## 结束条件 |
| 71 | |
| 72 | - [ ] TASK_CONFIRM 状态字段 = ✅ 已确认(二态,无 🟡) |
| 73 | - [ ] TASK_CONFIRM 5 个必备章节(一~五)填完 |
| 74 | - [ ] TASK_CONFIRM 无 12 词 TBD(见 `scripts/task-confirm-check.py` TBD_KEYWORDS) |
| 75 | - [ ] REVIEW_需求确认书 第八节"待明确事项"为空 |
| 76 | - [ ] REVIEW_字段对齐分析 对齐结论表中 ❓=0 且 🔴=0(⚠️ 可保留,状态字段可为 ✅ 或 ⚠️) |
| 77 | - [ ] `python3 scripts/task-confirm-check.py --strict TASK_CONFIRM_*.md REVIEW_需求确认书.md REVIEW_字段对齐分析.md` exit 0 |
| 78 | - [ ] 用户白名单话术签字(详见 `templates/TASK_CONFIRM.md` L48-55) |
| 79 | |
| 80 | ## 反模式 |
| 81 | |
| 82 | - ❌ TASK_CONFIRM 留 TBD 直接进 BRD — TBD 必须先闭环(确认/补资料/豁免)才能签字 |
| 83 | - ❌ 把 `field-alignment-check.py` 当 2→3 门控 — 应是 `task-confirm-check.py`(同时校验 3 份产物) |
| 84 | - ❌ 接受 "OK/好/继续" 作为签字 — 必须 4 句白名单之一(我已全部确认,可以进入下一步 / 确认通过 / 全部完成,继续 / approved, proceed to next stage) |
| 85 | - ❌ 中间态(🟡)混入二态 — ⬜/✅ 二态,无 🟡;若需"进行中"用 ⬜(未完成)表达 |
| 86 | - ❌ 一轮提问就停下 — 必须反复澄清到 5 节全填,无 TBD 才出"需求确认书" |
| 87 | - ❌ 字段对齐直接写"✅ 正确" — 必须给证据:字段路径 + 知识库章节 + 引用 URL |