ask-user

ユーザーに質問する

ワークフロー中にユーザーへ質問する方法を定めた、シンプルなヘルパーです。他のスキル（計画、調査、ブレインストーミング、実装）では、AskUserQuestion の規約を重複して定義する代わりに、このスキルを参照します。

基本ルール

AskUserQuestion ツールを使ってください。チャットで箇条書きのテキストとして質問してはいけません。

チャットで質問すると、自由形式の文章で答えるよう求めているように見えます。AskUserQuestion を使えば、ユーザーは各判断をワンクリックで選択でき、回答も構造化されます。常にこのツールを優先してください。

使用する場合

• ユーザーの曖昧な入力を明確にする
• 実現可能な設計案から選ぶ
• 行動に移す前に、重要な前提を確認する
• フェーズの区切り、計画の構成、破壊的な操作について承認を得る
• ワークフローの好み（例：フェーズごとにコミットするか）を確認する

使用しない場合

• 修辞的な質問や、考えを声に出しているだけの場合
• 些細で元に戻せる操作について許可を求める場合（そのまま実行してください）
• 「計画の準備はできましたか？」「続けてもよいですか？」など。これらは判断を求める質問ではなく、チェックポイントです。成果物を提示して、そこで止めてください。

規約

質問の形式

• 1文で、末尾を ? にする
• ユーザーが前の内容までスクロールしなくても分かるよう、十分な文脈を含める
• まだ見えていない成果物に言及しない（「計画はよさそうですか？」など。ユーザーにはまだ見えていない可能性があります）

選択肢

• 相互排他的な選択肢を2～4個用意する
• 各選択肢は1～5語のラベルと、トレードオフや影響を説明する1文で構成する
• 推奨案がある場合は先頭に置き、ラベルの末尾に (Recommended) を付ける
• 「その他」は含めないでください。ツールが自動で追加します。

ヘッダーチップ

• 最大12文字で、選択の軸を示す名前にする（例：Auth method、Approach、Scope）

複数選択

選択肢が相互排他的でない場合（例：「有効にする機能はどれですか？」）に限り、multiSelect: true を使います。デフォルトは単一選択です。

質問のまとめ方

同じチェックポイントで、互いに独立した質問が複数ある場合は、複数回に分けず、1回の AskUserQuestion 呼び出しにまとめてください（最大4問）。

良い例

question: "Which storage backend should the worker use?"
header: "Storage"
options:
  - label: "Postgres (Recommended)"
    description: "Existing infra, transactional, easy to query. Adds one new schema."
  - label: "Redis"
    description: "Faster but requires new ops. Lossy on eviction — bad fit for audit data."
  - label: "S3 + manifest"
    description: "Cheapest at scale but adds latency and a sync layer."

悪い例

"What do you think?"                      → too vague, no options
"Should I continue? (yes/no)"             → checkpoint, not a decision; just stop
"Pick one: A, B, C, D, E, F, G"           → too many options; collapse or split
"Want me to also fix the typo?"           → trivial reversible action; just do it