mcpField
C
clarifying-question-discipline

clarifying-question-discipline

github.com/fudesign2008エージェントワークフロー671 回インストール1 日前に更新
リポジトリ

clarifying-question-discipline について

未決の判断事項を一問ずつ確認する、エージェントワークフロー向けのスキルです。行動前の共通理解と、確認可能な事実を先に調査することを重視します。

主な機能

  1. 01複数ラウンドでも一回に一問
  2. 02理由付きの推奨選択肢
  3. 03質問前に確認可能な事実を調査
  4. 04共通理解を得てから行動
  5. 05調査を優先する指針

活用シーン

  1. 01実装前の要件確認
  2. 02依存関係に沿った判断事項の整理
  3. 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問+明確になるまで複数回という標語を優先し、「質問してすぐ解決する」と受け取られる表現は使わないでください。
  2. 先に確認し、回答は後で — 重要な不明点が残っている間は、解決策や結論、完全な回答を急いで提示しないでください。ユーザーが追加の確認を明示的に省略するよう求めた場合に限り、早めに進めても構いません(残りの事項については、想定したデフォルトを記録してください)。
  3. 推奨する回答 — 妥当なデフォルトがある場合、各質問には推奨する選択肢または明示したデフォルトと、その理由を1行で添えてください。ユーザーは選択肢の文字(「A」など)だけで回答しても構いません。
  4. 事実と決定事項 — 環境(リポジトリ、参照ファイル、過去のメッセージ、ツール)から確認できる事実は調べてください。質問枠を使わないでください。決定事項はユーザーが決めるものです。一つずつユーザーに質問し、回答を待ってください。
  5. 質問の前に状況を把握する — 最初の確認質問をする前に(また、行き詰まったときにも)、関連するファイル、ドキュメント、最近のコミットをざっと確認してください。依頼が互いに独立した複数のサブシステムにまたがる場合は、まず範囲の分解を支援してください。プロジェクトを分割すべき状況で、詳細を詰めるためにやり取りを費やさないでください。
  6. 共通認識の確認 — ユーザーが計画、設計、実装方針について共通認識に達したことを確認するか、追加の確認を明示的に省略しない限り、その方針に基づいて行動しないでください。

例外なし:この規律は常に適用されます。任意の拡張スキルがインストールされているかどうかには左右されません。

次に尋ねる質問の選択:まず意思決定ツリーの依存関係に従ってください。複数の起点となる未決定事項がある場合は、目的 → 制約 → 成功基準の順に優先してください。

質問の形式(プラットフォームに依存しない)

意図を説明し、エージェントに適切なネイティブ機能を選ばせてください。プラットフォーム固有のツールを指定したり、「プラットフォームXではA、YではB」と列挙したりしないでください。

  • 構造化された単一選択式を優先してください(質問1つ+選択肢+推奨回答)。選択肢を固定すると確実性を装うことになる場合は、自由回答でも構いません。
  • 構造化UIを利用できない場合は、通常の文章を使ってください。
[One sentence stating the question clearly]
- A option one
- B option two
Recommended: A (brief rationale)

調査を先に行う

  1. 助言する前に調査してください。調査なしに意見を述べないでください。
  2. 根拠に基づいて説明し、根拠のない仮説は避けてください。

ホストとの統合(接点は3つのみ)

この規律全体はここにのみ記載し、参照するワークフローに含める接点は次の3つだけにしてください。

  1. 目立つ参照 — このスキルの名前と、1ターンに1問+明確になるまで複数回+先に確認を示すタグ付きの1行を記載します。推奨例:⚠️ Follow clarifying-question-discipline (one question per turn; multi-round until clear; clarify first, do not rush to answer). ホストは、必要に応じてロケールに合わせた同等の1行を追加しても構いません。ホスト内で意思決定ツリーのルール全体を繰り返さないでください。
  2. 質問時の数量 — ユーザーに質問する各ステップで、今回のターンでは最も重要な質問を1つだけ尋ね、回答を受けてから次の質問をすることを明記します。
  3. 危険信号 — 複数の質問や未決事項を一度に列挙すること、確認中に回答を急ぐこと。

依存関係を宣言しないスキルでは、全文版をインラインで記載します(参照+質問数+危険信号+プラットフォームに依存しない表現)。

コメント