Grill task

Skill BlueprintOS/analysis-to-delivery/skills/user-invoked/grill-task

通用需求到开发设计工作流 — 26 个独立可组合 skill,跨行业(医药/SaaS/移动),3 个完整示例,5 个 CI workflow,Mermaid/Drawio 流程图工具链,VSCode 集成

Install

npx -y skills add BlueprintOS/analysis-to-delivery --skill grill-task

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

24 stars24 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

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

SKILL.md

4.3 KB, as published. Nobody here has run it

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