brainstorm

ブレインストーミング

このスキルでは、まずプロジェクトの状態を確認し、その後、的を絞った質問を一度に1つずつ行うことで、ユーザーの大まかなアイデアを明確な設計・仕様にまとめます。

ワークフロー

1. プロジェクトの状況を確認する

   • 作業ディレクトリを確認し、現在の状態、制約、既存のドキュメントやコードを把握します。
   • 次の質問の前提として役立つ場合に限り、確認した内容を2～4文で要約します。

2. 詳細を確認する質問をする（一度に1つ）

   • 1回の応答で質問するのは、必ず1つだけにします。
   • 3～5個の選択肢がある選択式の質問を優先し、役立つ場合は「その他：____」の選択肢を含めます。
   • 選択式の質問では、ユーザーが選びやすいよう、推奨する選択肢を必ず1つだけ示します。
   • Codex の request_user_input では、推奨する選択肢のラベルの末尾に (Recommended) を付けます。Claude の AskUserQuestion では、利用可能な場合は recommended フラグを明示するか、いずれかの選択肢に推奨であることを明記します。
   • 選択肢が誤解を招く場合に限り、自由回答式の質問を使います。
   • 不確実性の高い項目から低い項目へ順に質問します。
   • リポジトリや利用可能なツールを確認すれば簡単に分かることは質問せず、先に調べます。
   • 質問は、対象を絞った意思決定につながるものにします。
   • Claude では、AskUserQuestion を使って質問します。

3. 理解をまとめる

   • アイデアを設計・仕様として説明できる程度に明確にできたら、質問をやめます。
   • 質問から設計の説明に移ることを、明確に伝えます。

4. セクションごとに設計を説明する

   • 設計・仕様を、各約200～300語のセクションに分けて提示します。
   • 各セクションの後に、続きを説明する前に、ここまでの内容で問題ないかを尋ねます。
   • フィードバックを反映し、次のセクションの内容を調整します。

5. Beads と計画への引き継ぎ

   • 最後の仕様セクションが承認されたら、仕様を bead のフィールド（タイトル、説明、設計、受け入れ条件）にまとめます。
   • 次のステップ（Beads や計画）について、複数の選択肢がある質問を1つだけ行い、推奨する選択肢を1つ示します。例：単一の bead を作成する、epic と milestone を作成する、計画のみ進める、一時停止する。
   • Beads が希望されていて、粒度が明確でない場合に限り、単一の bead にするか、epic と milestone の bead にするかを選ぶ質問を1つだけ追加します。
   • 粒度の判断基準：
     • 単一の bead：1～3回の作業で完了し、一貫したフローで、引き継ぎが最小限の場合。
     • epic と milestone：作業が長期にわたる場合、または明確なチェックポイントがある場合（順次進める場合も含む）。手順を順番に行う必要がある場合は、直線的な依存関係を設定します。
   • 計画が希望された場合は、計画のたたき台となる仕様の要約（目標、対象外、UX、データ／ロジック、制約、受け入れ条件）を提示します。
   • 後から計画が作成された場合は、そのリンクを bead の設計フィールドに記載します。

スタイルルール

• 1回のメッセージで質問するのは1つだけにします。
• 長い前置きや複数段落の導入を避け、話を前に進めます。
• 具体的な表現を使い、冗長な説明は避けます。
• このスキルを使う理由などのメタな説明や前置きはしません。
• Beads や計画について尋ねるときは、選択式の質問を1つだけ使います。bead の粒度について確認が必要な場合に限り、追加で質問します。
• 選択式の質問では、推奨する選択肢を必ず1つだけ明示します。