mcpField
D
deep-grill

deep-grill

github.com/nxxxsooo生産性645 回インストール5 週間前に更新
リポジトリ

deep-grill について

deep-grillは、証拠に基づいてアイデアや計画を分岐ごとに検討する対話型スキルです。要件の明確化や既存案の検証に使え、確認済みのProduct Briefまたは監査結果を作成します。

主な機能

  1. 01発見モードと監査モード
  2. 02証拠に基づく分岐の調査
  3. 03優先度に沿ったユーザーへの質問
  4. 04Product Briefまたは監査結果の作成
  5. 05ネイティブ質問とテキスト形式に対応

活用シーン

  1. 01初期の製品アイデアの整理
  2. 02作成済みの設計や計画の検証
  3. 03ユーザーの優先事項に依存する判断

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/nxxxsooo/deep-grill --skill deep-grill

インストール後、Claude Code で/deep-grillを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

LICENSE
.gitignore
README.zh-CN.md
THIRD_PARTY_NOTICES.md
NOTICE
README.md
agents/
openai.yaml
references/
grilling-upstream.md
scripts/
check-readme-sync.py

詳細

Deep Grill

探索モードまたは監査モードのいずれかで、根拠に基づくブランチループを1回実行します。事実はエージェントが扱い、目標、優先順位、リスク許容度、好み、決定権はユーザーが持ちます。

モードを選択する

入力が未整理のアイデアである場合、ユーザーが質問や明確化を求めている場合、loop に完成したプロダクトブリーフがないまま作業が渡される場合、または実質的に異なるアプローチがユーザー自身の判断に依存する場合は、探索モードを使用します。その出力は、確認済みのプロダクトブリーフです。

ユーザーがまとまった計画、設計、判断、または暗黙のアプローチを提示し、自律的な検証、判定、または修正を求めている場合は、監査モードを使用します。その出力は監査判定です。

最初の時点でモードが不明確な場合は、もっとも妥当な最小限のアプローチを示して監査します。続行するとユーザー自身が決めるべき重要な判断を作り出してしまう場合に限り、探索モードに切り替えます。探索モードでは質問ラウンドの間に監査パスを実行できます。2つのモードは同じツリーを共有し、別の質問スキルに作業を引き継ぐことはありません。

セッションを継続する

deep-grill の開始後は、質問ラウンドへの各回答を同じセッションの続きとして扱います。会話と成果物から現在のブランチツリーを再構築し、回答を反映して続行します。ユーザーが deep-grill や loop を再度呼び出す必要はありません。

ユーザーがプロダクトブリーフまたは監査判定を確認した場合、停止を求めた場合、タスクを明確に変更した場合、または deep-grill の完了後に別の次フェーズを許可した場合に、セッションを終了します。

ブランチを進める

重要なブランチを依存関係の順に整理します。フロンティアとは、前提条件がすべて確定しているブランチの集合です。

利用可能な環境、情報源、テスト、範囲を限定した実験を使って、事実に関するブランチを調査します。暫定的な回答ごとに、もっとも有力な反論と具体的な失敗シナリオを用いて、その回答を維持、修正、または却下します。根拠が不十分な場合は、その旨を示し、事実を捏造するのではなく検証方法を提示します。未解決の事実確認が妨げるのは、その確認に依存するブランチだけです。

エージェントが決定権を持たないフロンティアの判断についてのみ、ユーザーに質問します。回答または根拠に変化があるたびに、フロンティアを再計算します。影響度、不確実性、可逆性を優先し、効果が薄れてきたら終了します。

ネイティブの質問機能を使う

最初のユーザー判断を提示する前に、アクティブなクライアントのツールメタデータを確認し、そのネイティブの質問インターフェースが現在呼び出し可能なのか、現在のモードでは利用できないのか、またはサポートされていないのかを判定します。

  • 呼び出し可能な場合は、そのラウンドでネイティブの質問呼び出しを1回行い、ツールが対応する範囲でフロンティアの判断をできるだけ多く含めます。
  • 現在のモードでは利用できない場合、またはサポートされていない場合は、同じ簡潔なローカライズ済みの文章による質問を直ちに行います。保留中のフロンティアと推奨選択肢を維持し、通常の返信から続行します。
  • ユーザーが文章での質問を明示的に選んだ場合は、同じフロンティアと推奨選択肢の構成を、簡潔な番号付きの文章で維持します。

ネイティブの質問と文章による代替質問では、それぞれ1つの判断を尋ね、相互排他的な選択肢を2つまたは3つ提示します。推奨する選択肢を先頭に置いて明示し、主なトレードオフを1文で説明し、自由記述も可能にします。正常に完了したネイティブの質問呼び出しを Markdown で繰り返してはいけません。

探索の出力

ユーザー自身が決める必要のある重要なブランチがすべて確定したら、該当する項目を含む簡潔なプロダクトブリーフを作成します。

Product / offer:
Target user and context:
Problem and desired outcome:
Constraints and must-preserve behavior:
Non-goals:
Confirmed decisions:
Evidence and assumptions:
Success scenarios:
Residual risks:

呼び出し可能な場合はネイティブの質問インターフェースを通じて、そうでない場合は同じモードのルールに従った簡潔なローカライズ済みの文章による代替質問を使って、ユーザーにブリーフの確認を求めます。確認が完了し、未解決の主要なプロダクト判断がなくなった時点で、ブリーフは deep-design に進める状態になります。

監査結果

対象、判定、推奨する改訂、裏付けとなる証拠、最も有力な反論、失敗シナリオ、証拠の限界、残存リスク、未解決の項目、未検証の範囲を報告します。監査内に、ネイティブの質問形式と文章による代替ルールを用いて、範囲を限定したユーザーの選択肢を1つまたは2つ含めます。意思決定ツリーが形成された場合は、別の尋問スキルを推奨するのではなく、発見モードを続けてください。

ユーザーが確認するか、次のフェーズを別途承認するまでは、Product Brief または判定を実装したり、それらに基づいて他の操作を行ったりしないでください。

発見モードに組み込まれた、上流の対話型グリリングの契約は、references/grilling-upstream.md に保持されています。

コメント