ask-user-choice

# Ask User Choice Skill

## 目的

このスキルは`AskUserQuestion`ツールの使用を推進し、ユーザーの入力負担を軽減して対話をより効率的にします。テキスト入力が必要な自由回答形式ではなく、ワンクリックで選択できる構造化された選択肢を提供してください。

## 使用タイミング

<trigger>

以下の場合にこのスキルを発動してください：
- ユーザーの入力や好みを取得する
- 曖昧な要件を明確化する
- 実装の選択肢を提示する（ライブラリ、アーキテクチャ、アプローチなど）
- 複数のタスクがある場合に優先順位を決定する
- 作業完了後に次のアクションを提案する

</trigger>

## ベストプラクティス

### 1. 良い質問の構造

各質問には以下を含めること：

- **明確な質問文**: 疑問符で終わり、具体的であること
- **簡潔なheader**: 短いラベル。例：「ライブラリ」「アプローチ」
- **選択肢**: それぞれにラベルと詳細な説明を付ける
- **multiSelect**: **デフォルトで`true`に設定**（柔軟性のため、ユーザーは1つまたは複数選択可能）

### 2. 充実した詳細な説明文を書く

説明文は長くてOK。情報量を充実させること。

良い選択肢の構造：

```json
{
  "label": "短い選択肢名",
  "description": "コンテキスト、トレードオフ、影響を含む詳細な説明。\n\n段落区切りには\\n\\nを使って可読性を向上させる。\n\n十分な情報を提供して、情報に基づいた意思決定を可能にする。"
}
```

- `\n\n`で段落区切りを使う（可読性が大幅に向上）
- コンテキスト、メリット・デメリット、影響を含める
- 詳細を出し惜しみしない - ユーザーは簡潔すぎる説明より包括的な情報を好む
- **Markdown記法の制限**:
  - `**bold**`、`*italic*`、`` `code` ``などは使えない（そのまま表示される）
  - 箇条書き（`-`）は装飾されないがそのまま表示されるので、可読性向上のために使用OK

### 3. multiSelectをデフォルトで使用

**特に理由がない限り`multiSelect: true`をデフォルトに**

✅ **`multiSelect: true`を使用（推奨デフォルト）**:

- ほとんどのシナリオで柔軟性の恩恵がある
- ユーザーは1つだけ選びたければ1つだけ選べる
- 該当する場合は複数の選択肢を組み合わせられる
- よりユーザーフレンドリーで制約が少ない

⚠️ **`multiSelect: false`を使うのは以下の場合のみ**:

- 選択肢が厳密に相互排他的
- 複数選択すると論理的な矛盾が生じる
- 質問の性質上、単一選択が本質的に必要

## 使用例

<examples>

### 例1: 実装アプローチ選択（詳細な説明文付き）

<example>

```json
{
  "question": "どのJavaScriptフレームワークを使用しますか？",
  "header": "Framework",
  "multiSelect": true,
  "options": [
    {
      "label": "React + TypeScript",
      "description": "仮想DOMを使用した高速レンダリングを実現する、最も人気のあるJavaScriptフレームワーク。\n\nTypeScriptと組み合わせることで型安全性が向上し、大規模プロジェクトでも保守性が高まる。\n\nコンポーネントベースの設計で再利用性が高く、豊富なエコシステム（React Router, Redux, Next.js等）が利用できる。\n\n学習コストは中程度で、ドキュメントやコミュニティサポートが充実している。"
    },
    {
      "label": "Vue.js + Composition API",
      "description": "学習曲線が穏やかで初心者にも取り組みやすいフレームワーク。\n\nComposition APIを使用することで、React Hooksに近いロジックの再利用が可能になる。\n\nテンプレート構文が直感的でHTMLに近い書き方ができ、公式の状態管理ライブラリPiniaやルーティングライブラリVue Routerが統合されている。\n\nパフォーマンスも優れており、中小規模から大規模まで幅広く対応できる