clarifying-question-discipline について
未決の判断事項を一問ずつ確認する、エージェントワークフロー向けのスキルです。行動前の共通理解と、確認可能な事実を先に調査することを重視します。
主な機能
- 01複数ラウンドでも一回に一問
- 02理由付きの推奨選択肢
- 03質問前に確認可能な事実を調査
- 04共通理解を得てから行動
- 05調査を優先する指針
活用シーン
- 01実装前の要件確認
- 02依存関係に沿った判断事項の整理
- 03質問前のリポジトリ調査
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ fudesign2008/ open-skills --skill clarifying-question-disciplineインストール後、Claude Code で/clarifying-question-disciplineを入力して読み込まれたか確認します。
詳細
確認質問の規律
内部共有スキルです。ホストは frontmatter の
dependenciesでこのスキルを宣言し、見つからない場合は起動時に処理を中断します。黙ってフォールバックすることはありません。
共通認識に至るまで、未決定の事項についてユーザーに徹底的に質問してください。意思決定ツリーの各分岐をたどり、依存関係を一つずつ解決して、先の回答を後の質問に反映してください。一度に複数の質問をすると、ユーザーは混乱します。
厳守事項
- 1回のメッセージにつき質問は1つ — 次の質問をする前に回答を待ってください。明確になるまで複数回やり取りします。これは「セッション全体で質問は1つだけ」という意味ではありません。1ターンに1問+明確になるまで複数回という標語を優先し、「質問してすぐ解決する」と受け取られる表現は使わないでください。
- 先に確認し、回答は後で — 重要な不明点が残っている間は、解決策や結論、完全な回答を急いで提示しないでください。ユーザーが追加の確認を明示的に省略するよう求めた場合に限り、早めに進めても構いません(残りの事項については、想定したデフォルトを記録してください)。
- 推奨する回答 — 妥当なデフォルトがある場合、各質問には推奨する選択肢または明示したデフォルトと、その理由を1行で添えてください。ユーザーは選択肢の文字(「A」など)だけで回答しても構いません。
- 事実と決定事項 — 環境(リポジトリ、参照ファイル、過去のメッセージ、ツール)から確認できる事実は調べてください。質問枠を使わないでください。決定事項はユーザーが決めるものです。一つずつユーザーに質問し、回答を待ってください。
- 質問の前に状況を把握する — 最初の確認質問をする前に(また、行き詰まったときにも)、関連するファイル、ドキュメント、最近のコミットをざっと確認してください。依頼が互いに独立した複数のサブシステムにまたがる場合は、まず範囲の分解を支援してください。プロジェクトを分割すべき状況で、詳細を詰めるためにやり取りを費やさないでください。
- 共通認識の確認 — ユーザーが計画、設計、実装方針について共通認識に達したことを確認するか、追加の確認を明示的に省略しない限り、その方針に基づいて行動しないでください。
例外なし:この規律は常に適用されます。任意の拡張スキルがインストールされているかどうかには左右されません。
次に尋ねる質問の選択:まず意思決定ツリーの依存関係に従ってください。複数の起点となる未決定事項がある場合は、目的 → 制約 → 成功基準の順に優先してください。
質問の形式(プラットフォームに依存しない)
意図を説明し、エージェントに適切なネイティブ機能を選ばせてください。プラットフォーム固有のツールを指定したり、「プラットフォームXではA、YではB」と列挙したりしないでください。
- 構造化された単一選択式を優先してください(質問1つ+選択肢+推奨回答)。選択肢を固定すると確実性を装うことになる場合は、自由回答でも構いません。
- 構造化UIを利用できない場合は、通常の文章を使ってください。
[One sentence stating the question clearly]
- A option one
- B option two
Recommended: A (brief rationale)
調査を先に行う
- 助言する前に調査してください。調査なしに意見を述べないでください。
- 根拠に基づいて説明し、根拠のない仮説は避けてください。
ホストとの統合(接点は3つのみ)
この規律全体はここにのみ記載し、参照するワークフローに含める接点は次の3つだけにしてください。
- 目立つ参照 — このスキルの名前と、1ターンに1問+明確になるまで複数回+先に確認を示すタグ付きの1行を記載します。推奨例:
⚠️ Follow clarifying-question-discipline (one question per turn; multi-round until clear; clarify first, do not rush to answer).ホストは、必要に応じてロケールに合わせた同等の1行を追加しても構いません。ホスト内で意思決定ツリーのルール全体を繰り返さないでください。 - 質問時の数量 — ユーザーに質問する各ステップで、今回のターンでは最も重要な質問を1つだけ尋ね、回答を受けてから次の質問をすることを明記します。
- 危険信号 — 複数の質問や未決事項を一度に列挙すること、確認中に回答を急ぐこと。
依存関係を宣言しないスキルでは、全文版をインラインで記載します(参照+質問数+危険信号+プラットフォームに依存しない表現)。
コメント
Markdown 対応