grill

grill is a skill for Claude Code from Today-Hbw/claude-code-dev-workflow. It costs 19 tokens per session (1,117 once invoked), scanned A, original, MIT.

A question-based method for resolving unclear or missing details in a product requirements document (PRD), which describes what a software product should do.

In plain words
What is it for?
Use it to work through requirements step by step, inspect available code and designs first, recommend answers, and ask the user about genuine gaps.
Why use it?
It helps expose decisions that could otherwise lead to conflicting assumptions or rework.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin. Also seen: names the AskUserQuestion tool.

Part of the dev-flow-lite plugin — 4 skills, 1 command shipped together

Good fit Use it to work through requirements step by step, inspect available code and designs first, recommend answers, and ask the user about genuine gaps.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/today-hbw/claude-code-dev-workflow/grill
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add Today-Hbw/claude-code-dev-workflow --skill grill
Clone the repo
git clone --depth 1 https://github.com/Today-Hbw/claude-code-dev-workflow

Made for: Claude Code.

Or install dev-flow-lite, the plugin that ships this one along with the rest of its 4 skills, 1 command.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for grill

README.md
[![agentmods](https://agentmods.dev/badge/skills/today-hbw/claude-code-dev-workflow/grill/github.svg)](https://agentmods.dev/skills/today-hbw/claude-code-dev-workflow/grill)
Your own site
<a href="https://agentmods.dev/skills/today-hbw/claude-code-dev-workflow/grill"><img src="https://agentmods.dev/badge/skills/today-hbw/claude-code-dev-workflow/grill/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for grill

Your own site · 80×15
<a href="https://agentmods.dev/skills/today-hbw/claude-code-dev-workflow/grill"><img src="https://agentmods.dev/badge/skills/today-hbw/claude-code-dev-workflow/grill.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 19 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,117 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00019 $0.01117
Opus 5.5 $0.00008 $0.00447
Sonnet 5.5 $0.00004 $0.00223
Haiku 4.5 $0.00002 $0.00112

Measured 1mo ago against content hash 749ef9257e0a, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

grill scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugins/dev-flow-lite/skills/grill/SKILL.md · 101 lines

What it actually says

grill · 提问方法论

你的任务

针对 PRD 需求中模糊、缺失、有歧义的部分,沿着决策树逐条向用户提问,直到所有关键不确定点都对齐。

核心方法:决策树遍历

不要按维度平铺提问,而是把 PRD 看作一棵决策树:

PRD
├── 决策 A:数据存在哪?
│   ├── 决策 A1:用新表还是复用旧表?
│   └── 决策 A2:字段如何设计?
├── 决策 B:接口怎么暴露?
│   ├── 决策 B1:新增接口还是扩展现有接口?
│   └── 决策 B2:参数格式?
└── 决策 C:UI 如何呈现?
    └── 决策 C1:字段顺序和默认值?

遍历规则:

  1. 先识别所有决策分支:读完 PRD 后,列出所有需要做出的决策
  2. 按依赖关系排序:先解决前置决策(被其他决策依赖的节点)
  3. 逐个向下走:每次只问一个问题,等用户回答后再问下一个
  4. 回答可能揭示新分支:用户的回答可能引出新的决策节点,动态加入树中

提问原则

  1. 先推荐,再确认:每个问题先给出你的推荐答案和理由,再让用户确认或修改

    我的建议:用新表 `user_preferences` 存储,理由是...
    你觉得这样可以吗?还是有其他考虑?
    
  2. 一次只问一个问题:并行抛出多个问题会让用户混乱。问完一个,等回答,再问下一个。

  3. 先查答案来源,再问用户:能查到答案的问题不要问用户。

    • 视觉规格问题先回 PRD 内嵌截图/原型逐元素核对——图里已标注的按图定死。
    • 实现问题先用 Glob/Grep/Read 查代码库,查到就直接用。
  4. 给出判断依据:推荐答案要说明为什么,不要只说"我建议 X",要说"我建议 X,因为 Y"。

  5. 标记缺口:仅当 PRD 正文和截图/原型都未给出时才算真缺口——标为「缺口」、说明临时方案、继续推进。

提问维度(辅助参考)

决策树遍历是主方法,以下维度帮助你在遍历中发现遗漏的决策节点:

维度 典型决策点
边界条件 空值怎么处理?最大/最小值?超限怎么办?
依赖关系 依赖哪个表/接口/其他任务?先后顺序?
存储结构 数据存在哪?新表还是复用?字段设计?
UI 细节 字段折进已有列还是独立列?按钮文案?入口挂哪个页签?筛选放哪?字段顺序?默认值?
异常处理 失败怎么提示?重试?回滚?
性能 数据量多大?需要分页?有并发问题?
兼容性 需要兼容旧版本吗?接口变更?

提问方式

使用 AskUserQuestion 工具:

问题:<具体决策问题>
选项 A:<你的推荐方案>(附理由)
选项 B:<备选方案 1>
选项 C:<备选方案 2>

提问流程

1. 读完 PRD 后,画出决策树(列出所有决策节点和依赖关系)
   ↓
2. 从根节点开始(最不依赖其他决策的节点)
   ↓
3. 每个节点:先推荐 → 问用户 → 记录回答
   ↓
4. 回答可能揭示新节点 → 动态加入决策树
   ↓
5. 所有节点遍历完毕 → 检查是否有遗漏维度
   ↓
完成 → 进入步骤 3(编码)

注意事项

  • 如果用户说「你自己判断」,给出你的建议方案并记录,不反复追问
  • 不要纠结于小问题,先确保大方向正确
  • 如果需求已经足够清晰,可以快速过一遍确认,不需要强行提问
  • 用户的回答可能推翻之前的理解,及时调整决策树
Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 1mo ago First seen · 101 lines · 19 tokens per session scan A 749ef9257e0a

Subscribe to this mod's changes

grill is a skill published in the GitHub repository Today-Hbw/claude-code-dev-workflow (23 stars, last pushed 2mo ago), licensed MIT. It adds 19 tokens to every session and 1,117 once invoked, about $0.0001 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.