# Grill Task

> 需求澄清 + 字段对齐分析 — 反复提问拉齐用户意图,生成 TASK_CONFIRM 任务确认书与字段对齐分析报告。启动新需求、或需要与现有数据库表对齐字段名时调用本 skill。

- Skill: `blueprintos/grill-task` (Agent Skill)
- Install (CLI): `npx skillmds@latest add blueprintos/grill-task`
- Raw SKILL.md: https://api.skillmd.com/api/skills/blueprintos/grill-task/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: BlueprintOS (https://skillmd.com/u/blueprintos)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/blueprintos/grill-task

---


# 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