kaji: Skill for Claude Code

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 不変条件

1. 全 aspect の未決分岐を shared understanding に達するまで追跡する。
2. 決定間の依存順に decision tree の branch を 1 つずつ解決する。
3. 1 回に提示する質問は必ず 1 問とし、回答を受けるまで次を提示しない。
4. コード、docs、既存 Issue / PR で回答できる事項は先に調査し、人間へ聞かない。
5. 各質問に推奨回答と短い理由を付ける。

加えて、人間の確認なしに決定事項を確定または Issue へ書き戻さない。

relentless は質問を省略しないという意味であり、攻撃的に問い詰めることではない。 前置きを短くし、判断コストを下げる協働的な質問にする。

実行手順

Step 1: Issue と正本を読む

1. Issue 本文と全コメントを読む。
2. _shared/critical-decision-checklist.md を読む。
3. Issue が参照するコード、docs、既存 Issue / PR、外部仕様を調査する。
4. 事実、人間が既に決定した事項、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 を更新する。