grill-with-docs-smarter について
`/grilling` と `/domain-modeling` を使った設計議論のためのパーソナルスキルです。会話やドキュメント、範囲を限定したウェブ調査で不確実性を解消してから、推奨案を左右する質問を行います。
主な機能
- 01根拠に基づく質問の選別
- 02推論、調査、質問の切り分け
- 03推奨案とトレードオフの提示
- 04ウェブ調査の範囲を限定
- 05依存関係を変える質問を一度に一つ行う
活用シーン
- 01大規模コードベースの設計判断
- 02ライブラリやフレームワークの現状確認
- 03セキュリティ指針、標準、プラットフォーム規則の検討
- 04ドメインモデリング文書の維持
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ gil-1/ skills --skill grill-with-docs-smarterインストール後、Claude Code で/grill-with-docs-smarterを入力して読み込まれたか確認します。
詳細
証拠を優先する質問フィルターを使い、/domain-modeling スキルで /grilling セッションを実行します。
ユーザーに質問する前に、その不確実性を次のどれで解消すべきか判断します。
- 会話、リポジトリ、既存のドキュメントから推測する。
- 現在の外部情報によって推奨事項が変わる可能性があるため、範囲を限定してウェブ調査で確認する。
- エージェントの推奨案を提示する。
- ユーザーにしか答えられないため、質問する。
最初の3つで答えが得られる質問はしないでください。証拠から方針を支持できる場合は、質問する前に推奨案、トレードオフ、却下した代替案を提示します。推奨事項を実質的に変える回答につながる質問だけをしてください。
不確実で、変化しやすい外部情報が設計に重大な影響を与える可能性がある場合は、ウェブ調査を行ってください。対象には、ライブラリやフレームワークの状況、セキュリティに関する指針、標準、料金、プラットフォームのルールが含まれます。調査の範囲を限定し、判断に必要でない限り、簡単なグリルを大規模な調査タスクにしないでください。
ユーザーの制約を満たす、最もシンプルな推奨案を標準とします。複雑さを加えるのは、実際のリスクを減らす場合、必要な選択肢を維持する場合、または規模、セキュリティ、プロダクト上の制約に適合させる場合に限ります。
依存関係を変える質問は、一度に1つだけ行ってください。独立した質問は、まとめて答えるほうがユーザーにとって簡単な場合に限り、最大3つまでまとめてください。
/domain-modeling を通じて、ドキュメントの整備を継続してください。