grill-me
Skill16 starsChanged 2 days agoApache-2.0View on GitHub
Issue 作成後・workflow 起動前に人間が明示起動する要件 interview。one-way door を含みうる重要な Issue で、未決の decision tree を 1 問ずつ推奨案付きで確認し、決定事項と provenance を Issue に固定するときだけ使用する。軽微な Issue や workflow 実行中には自動起動しない。
193 other projects use a version of this.
Adopted by
Most recently taken up by
- bamlab/flashlighttheir own version, first seen Nov 16, 2026
- philoserf/claude-code-configtheir own version, first seen Nov 15, 2026
- niki914/zafirotheir own version, first seen Nov 15, 2026
- quickchatai/quickreviewtheir own version, first seen Nov 15, 2026
- HiteSit/real-scientist-skillstheir own version, first seen Nov 15, 2026
- alexj11324/Mikkatheir own version, first seen Nov 15, 2026
Used with
Projects with it also use brief-to-tasks, writing-beats and 10 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
julianoczkowskiSkillbrief-to-tasks
Break a design brief into an ordered checklist of independently buildable tasks using vertical slices. Saves as a markdown checklist. Use when user wants to break down work, create tasks from a brief, plan implementation order, or mentions "tasks" or "breakdown".
Also in 7 projects that use this
LesaniSkillwriting-beats
Shape an article as a journey of beats, choose-your-own-adventure style. The user picks a starting beat from the raw material, you write only that beat, then offer options for where to pivot next, beat by beat, until the article reaches a natural end. Use when the user has raw material and wants to assemble it as a narrative rather than an argument.
Also in 74 projects that use this
simo97Skillmigrate-to-shoehorn
Migrate test files from `as` type assertions to @total-typescript/shoehorn. Use when user mentions shoehorn, wants to replace `as` in tests, or needs partial test data.
Also in 78 projects that use this
simo97Skillrequest-refactor-plan
Use this skill when user wants to create a refactor plan.
Also in 45 projects that use this
LesaniSkillwriting-shape
Take a markdown file of raw material and shape it into an article through a conversational session — drafting candidate openings, growing the piece paragraph by paragraph, arguing about format (lists, tables, callouts, quotes) at each step. Use when the user has a pile of notes, fragments, or a rough draft and wants help turning it into something publishable.
Also in 73 projects that use this
RoentekSkillloop-me
Grill me about specs for the workflows I want to build, within this workspace.
Also in 64 projects that use this
- +1 more from simo97
- +1 more from Lesani
Other versions193 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 193
- mattpocock/skills★ 325ksame name
- The-Vibe-Company/quivr★ 40ksame name
- QuivrHQ/quivr★ 40ksame name
- langfuse/langfuse★ 37ksame name
- nrwl/nx★ 29ksame name
- windmill-labs/windmill★ 19ksame name
- GreyDGL/PentestGPT★ 16ksame name
- humanlayer/humanlayer★ 13ksame name
- jaredpalmer/kev★ 9.8ksame name
- openstatusHQ/openstatus★ 9.3ksame name
183 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository46 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- llms.txtllms.txt
- baseline-precheckSkill
- herdr-kaji-launchSkill
- i-dev-final-checkSkill
- i-doc-final-checkSkill
- i-doc-fixSkill
- i-doc-reviewSkill
- i-doc-updateSkill
- i-doc-verifySkill
- incident-cycleSkill
- incident-fixSkill
- incident-investigateSkill
- incident-reportSkill
- incident-reviewSkill
- incident-verifySkill
- i-prSkill
- issue-closeSkill
- issue-createSkill
- issue-designSkill
- issue-fix-codeSkill
- issue-fix-designSkill
- issue-fix-readySkill
- issue-implementSkill
- issue-review-codeSkill
- issue-review-designSkill
- issue-review-readySkill
- issue-small-change-executeSkill
- issue-small-change-reviewSkill
- issue-startSkill
- issue-verify-codeSkill
- issue-verify-designSkill
- kaji-run-verifySkill
- pr-fixSkill
- pr-verifySkill
- releaseSkill
- release-starterSkill
- review-cycleSkill
- review-pollSkill
- reviewSkill
- review-starter-updateSkill
- run-watchedSkill
- series-createSkill
- update-starterSkill
- watch-triageSkill
The file
Files
Grill Me
重要判断を workflow の有人区間で前倒しして確定する。質問数を減らすことではなく、 shared understanding に達するまで未決分岐を残さないことを優先する。ただし、調査で 判明する事実や後段で安く直せる詳細を人間へ質問しない。
位置と責務境界
issue-create → (/grill-me: 任意・明示起動・有人) → issue-review-ready → issue-start → ….kaji/wf/**/*.yamlの step には追加しない。headless workflow に同期対話を持ち込まない。issue-review-readyを代替しない。interview 後も独立した readiness gate を通す。- 明示起動専用とする。対応 runtime が
agents/openai.yamlを読む場合はpolicy.allow_implicit_invocation: falseに従い、それ以外でもこの使用条件を守る。 - 判断軸、可逆性、停止条件、provenance の正本は _shared/critical-decision-checklist.md とする。
入力
$ARGUMENTS = <issue_id>人間が対話に参加できる状態で /grill-me <issue_id> と明示起動する。Issue ID がない、
Issue を取得できない、または回答者が不在なら、Issue を変更せず停止する。
Interview の 5 不変条件
- 全 aspect の未決分岐を shared understanding に達するまで追跡する。
- 決定間の依存順に decision tree の branch を 1 つずつ解決する。
- 1 回に提示する質問は必ず 1 問とし、回答を受けるまで次を提示しない。
- コード、docs、既存 Issue / PR で回答できる事項は先に調査し、人間へ聞かない。
- 各質問に推奨回答と短い理由を付ける。
加えて、人間の確認なしに決定事項を確定または Issue へ書き戻さない。
relentless は質問を省略しないという意味であり、攻撃的に問い詰めることではない。
前置きを短くし、判断コストを下げる協働的な質問にする。
実行手順
Step 1: Issue と正本を読む
- Issue 本文と全コメントを読む。
- _shared/critical-decision-checklist.md を読む。
- Issue が参照するコード、docs、既存 Issue / PR、外部仕様を調査する。
- 事実、人間が既に決定した事項、AI の仮定、真に未決の事項を分離する。
source of truth 同士が矛盾する場合は、都合のよい方を選ばず未決分岐に戻す。
Step 2: 要否門番を通す
次のいずれかを含みうる場合は interview を続ける。
- ユーザー価値、主要ユースケース、画面・操作構造
- 公開 CLI / API、永続化形式、migration、rollback
- source of truth の指定または競合
- 既存利用者、外部連携、運用、権限、監視への影響
- 非互換変更、quality gate の省略、曖昧なスコープ境界
typo、リンク修正、既存文言の明確化、形式調整など、one-way door がないと調査で 確認できた軽微な Issue はスキップする。Issue を変更せず、次の 1 行だけを返す。
軽微な変更で one-way door がないため grill-me は不要です。/issue-review-ready <issue_id> へ進んでください。迷う場合は interview を続ける。
Step 3: decision tree を作る
チェックリストの判断軸を使い、調査後も残る未決事項を依存順に並べる。
- one-way door を先に解決する。
- two-way door は、人間の選好が必要な場合だけ質問する。その他は AI の仮定、根拠、 後段の検査先として記録候補にする。
- 既に出典付きで決定済みの事項を聞き直さない。ただし、新しい情報との矛盾は質問する。
- 固定質問リストを機械的に読み上げず、回答によって後続 branch を更新する。
Step 4: 1 問ずつ interview する
各 turn では次の形で、1 つの決定だけを問う。1 問の選択肢を示すことはよいが、別の 決定を同じ質問へ混ぜない。
質問: <人間にしか決められない 1 つの判断>
推奨: <推奨回答>
理由: <短い根拠と主な trade-off>- 回答が曖昧なら、その判断だけを明確にする follow-up を 1 問出す。
- 回答を受けたら decision tree を更新し、次に依存する 1 問だけを出す。
- 新しい選択肢や影響が判明したら、調査できる事実を先に調べてから質問へ戻る。
- shared understanding は、全 one-way door が出典付きで確定し、残る two-way door の 仮定と検査先を双方が説明できる状態とする。
Step 5: 書き戻し前の確認を 1 問する
確定した人間判断、残す AI 仮定、source of truth、スコープ外を短く要約する。その要約を Issue へ固定してよいか、最後の 1 問として確認する。修正を求められたら該当 branch に 戻り、確認なしに書き込まない。
Step 6: Issue 本文と provenance に固定する
- 現在の Issue 本文を再取得する。
- 既存本文を保持し、
## 決定事項を追加する。既に同見出しがある場合は重複追加せず、 確認済み内容へ更新する。 - 人間決定は
判断 / 方針 / 出典、two-way door は仮定 / 根拠 / 後段の検査先が分かる形にする。 kaji issue edit <issue_id> --commit --body-file <file>で本文を更新する。- 別の
## grill-me provenanceコメントに、調査した一次情報、質問ごとの決定理由、 変更された選択肢、残した仮定を記録する。 - 本文とコメントを再取得し、決定事項と provenance が永続化されたことを確認する。
一時ファイルが必要なら tracked path を使わず、mktemp "${TMPDIR:-/tmp}/kaji-grill-me.XXXXXX"
のような portable template で $TMPDIR または /tmp に作成し、使用後に削除する。GNU 固有の
mktemp --tmpdir は BSD/macOS で失敗するため使わない。秘密情報や不要な逐語 transcript は
永続化しない。
Step 7: handoff する
更新した決定事項と provenance の要点を報告し、次を案内する。
/issue-review-ready <issue_id>非目標
- 全 Issue での強制実行
- 複数質問の同時提示
- workflow YAML への step 追加
- workflow 開始後の人間判断の代行
- Issue 作成後の workflow 自動起動
- 再利用需要がない段階での interview engine 分割
出典
interview の 5 不変条件は Matt Pocock の
skills にある grill-me / grilling の考え方と、
kamo2 Issue 1404 /
PR 1408 における適用例を参考にし、kaji の重要判断正本と
Issue provenance 運用へ合わせて再構成した。
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

