questioning について
questioning は、焦点を絞った質問を調査し、リサーチ文書を作らずに回答する Claude スキルです。コードベース、ライブラリ、ウェブの調査を導き、次の操作も提示します。
主な機能
- 01調査の種類に応じた質問の分類
- 02コード検索と関連ファイルの確認
- 03ライブラリ文書やウェブ情報の参照
- 04コード参照付きのインライン回答
- 05次の操作の提示
活用シーン
- 01コードベース内の定義の特定
- 02プロジェクト機能の仕組みの把握
- 03根本原因の調査や手法の比較
MCP 対応
ライブラリ文書の取得に context7 MCP を利用できます。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ desplega-ai/ ai-toolbox --skill questioningインストール後、Claude Code で/questioningを入力して読み込まれたか確認します。
同梱ファイルtemplate.md
詳細
質問
リサーチプロセスを使って、質問に直接、簡潔に回答します。デフォルトではドキュメントは作成されません。回答そのものが成果物です。
使用するタイミング
このスキルは、次の場合に有効になります。
- ユーザーが
/questionコマンドを実行したとき - 別のスキルが
desplega:questioningを参照したとき - ユーザーが、リサーチドキュメント全体を必要としない、焦点の絞られた質問をしたとき
基本方針
質問から回答に至るまでの最短ルートです。包括的に記録する /research や、対話しながら検討する /brainstorm とは異なり、/question は要点に直行します。
- 質問を受け取る
- 必要に応じて調査する
- その場で回答する
- 次のステップを提案する
堅苦しい手順はありません。自律性についての確認も、好みの設定も、作業合意も不要です。質問に答えるだけです。
ユーザーに何か尋ねる必要がある場合(引き継ぎや、フォローアップの選択肢など)は、desplega:ask-user の規約に従って AskUserQuestion を使用してください。
プロセス
ステップ 1:質問を分析する
質問を分類して、必要な調査を判断します。
| 質問の種類 | 必要な調査 | 例 |
|---|---|---|
| 事実・場所に関する質問 | コードベースをすばやく検索 | 「認証ミドルウェアはどこで定義されていますか?」 |
| 概念・仕組みに関する質問 | 関連ファイルを読む | 「プラグインシステムはどのようにスキルを検出しますか?」 |
| 理由・根本原因に関する質問 | 詳細な読み込みと履歴の確認 | 「なぜブレインストーミングはデフォルトで冗長なのですか?」 |
| 比較に関する質問 | 複数の領域を読む | 「リサーチスキルと質問スキルの違いは何ですか?」 |
| 外部ライブラリに関する質問 | context7 またはウェブ検索 | 「Bun の SQLite ドライバーはトランザクションをどのように処理しますか?」 |
ステップ 2:調査する
質問の種類に応じて、適切なツールを使用します。サブエージェントの起動は必要な場合に限ります。多くの質問は、いくつかのファイルを直接読むだけで回答できます。
コードベースに関する質問の場合:
- まず、直接言及されているファイルを読む(
limit/offsetを指定せずに Read ツールを使用) - 対象の場所を探す必要がある場合は、codebase-locator エージェントを使用
- 仕組みを理解する必要がある場合は、codebase-analyzer エージェントを使用
- パターンの例が必要な場合は、codebase-pattern-finder エージェントを使用
ライブラリ/フレームワークに関する質問の場合:
- context7 MCP を使用してドキュメントを取得する(
resolve-library-id→query-docs)
外部/ウェブに関する質問の場合:
- ドキュメントや例を調べるには、web-search-researcher エージェントを使用
効率化のルール:1~3 個のファイルを読めば回答できる場合は、そのまま読みます。簡単な確認のためにサブエージェントを起動しないでください。
ステップ 3:回答する
回答はその場でテキストとして提示します(ドキュメントにはしません)。質問に合わせて自然な構成にします。
- 短い回答:ファイルと行番号を参照し、1~3 文で回答
- 中程度の回答:重要な参照情報を含め、1~2 段落で回答
- 詳細な回答:必要に応じて見出しを使って整理しつつ、要点に絞る
リサーチとは異なり、次のことを行ってもかまいません。
- 質問から問題が読み取れる場合は、改善案を提案する
- 「なぜ」という質問には、根本原因を分析する
- 意見を求められた場合は、意見を述べる(「どちらの方法が優れていますか?」)
- 網羅的に中立を保つのではなく、率直に意見を述べる
必ず含めるもの:
- コードベースに関する主張には、具体的な
file:lineの参照 - 回答の理解に役立つ場合は、短いコードスニペット
ステップ 4:引き継ぎ
回答した後、次の質問をします。
| 質問 | 選択肢 |
|---|---|
| "次に何をしますか?" | 1. 別の質問をする、2. この回答を思考メモに保存する、3. このトピックからブレインストーミングを始める(→ /brainstorm)、4. このトピックから調査を始める(→ /research)、5. 完了 |
回答に基づいて、次のようにします。
- 別の質問をする:AskUserQuestion を使って「次の質問は何ですか?」と尋ね、ステップ 1 に戻ります
- この回答を保存する:テンプレート
cc-plugin/base/skills/questioning/template.mdを使って、Q&A をthoughts/<user>/questions/YYYY-MM-DD-<topic>.mdに書き込みます。パスの選択:ユーザー名がわかっている場合はその名前を使い、わからない場合はthoughts/shared/questions/を使います - ブレインストーミング:質問のトピックをコンテキストとして、
/brainstorm <topic>を提案します - 調査:質問のトピックをコンテキストとして、
/research <topic>を提案します - 完了:以降の操作はありません
繰り返しの動作
ユーザーが「別の質問をする」を選択すると、スキルは次のように繰り返します。
- AskUserQuestion を使って次の質問を尋ねます
- 調査して回答します(ステップ 1~3)
- 引き継ぎの選択肢を再度提示します(ステップ 4)
各回は独立しており、ユーザーが明示的に関連付けない限り、質問間で状態は引き継がれません。
学びの記録
任意のサブスキル: このワークフローで重要な洞察、パターン、注意点、決定事項が生まれた場合は、desplega:learning を使って /learning capture で記録することを検討してください。今後のセッションでほかの人の役に立つ学びに焦点を当ててください。
このスキルの対象外
- 調査ではありません:包括的なドキュメント、フロントマターの手順、複数セクションにわたる出力はありません
- ブレインストーミングではありません:ソクラテス式の質疑応答ループや段階的なドキュメント作成はありません
- チャットボットではありません:表面的な回答ではなく、コードベースの根拠を使って各質問を適切に調査します