mcpField
B
brainstorming

brainstorming

github.com/itallstartedwithaideaエージェントワークフロー4482 回インストール29 週間前に更新
リポジトリ

brainstorming について

構造化された質問を通じて、コーディング前に要件を明確にする設計整理スキルです。制約や代替案を検討し、確認用の設計概要をまとめるようエージェントを導きます。

主な機能

  1. 01質問による要件の明確化
  2. 02制約と曖昧さの発見
  3. 03代替案の検討
  4. 04トレードオフの議論
  5. 05確認用設計概要の作成

活用シーン

  1. 01仕様が不十分な機能要望の整理
  2. 02実装前の曖昧さの解消
  3. 03アーキテクチャ案の比較
  4. 04範囲と対象外事項の定義

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/itallstartedwithaidea/agent-skills --skill brainstorming

インストール後、Claude Code で/brainstormingを入力して読み込まれたか確認します。

詳細

ブレインストーミング

googleadsagent.ai™ による Agent Skills™ の一部です

説明

ブレインストーミングは、コードを書く前に起動する、ソクラテス式の設計を洗練するスキルです。構造化された質問、制約の発見、代替案の検討を通じて、漠然とした要件や大まかなアイデアを明確に定義された実装計画へと変換します。エージェントは、問題領域が十分に把握されるまでコードを書くことを拒みます。

このスキルは、「X が欲しい」から「X のコードはこちらです」までの間に、意図的な間を設けます。エッジケース、スケーラビリティに関する懸念、ユーザーエクスペリエンスへの影響、アーキテクチャ上のトレードオフについて的を絞った質問をすることで、エージェントは、そうしなければ実装の途中で判明し、対応に多大なコストがかかる隠れた要件を明らかにします。このプロセスは、シニアエンジニアが方針を決める前に自然に行う要件の掘り下げを再現します。

出力されるのは、明確に整理された設計概要です。これは、何を構築するのか、特定のアプローチを選んだ理由、明示的に先送りした事項について、人間とエージェントが共有する理解です。この成果物は、その後のすべての実装を評価する基準となります。

使用する場面

  • ユーザーが詳細な仕様なしに機能の実装を依頼した場合
  • 有力なアーキテクチャ上の選択肢が複数あり、意味のあるトレードオフが存在する場合
  • 要件に、解釈が分かれる可能性のある曖昧な表現が含まれている場合
  • 作業範囲が不明確、または際限なく広がる可能性がある場合
  • 実装を始める前に検証すべき前提に気付いた場合
  • 未知のシステムや API との統合を伴うタスクの場合

仕組み

graph TD
    A[Receive Rough Idea] --> B[Extract Core Intent]
    B --> C[Ask Clarifying Questions]
    C --> D{Ambiguities Resolved?}
    D -->|No| E[Explore Alternatives]
    E --> F[Present Trade-offs]
    F --> C
    D -->|Yes| G[Synthesize Design Brief]
    G --> H[Confirm with User]
    H -->|Rejected| C
    H -->|Accepted| I[Output Implementation-Ready Spec]

ブレインストーミングのフローは、実装に関する前提を取り除きながら、ユーザーの依頼から中心的な意図を抽出するところから始まります。次にエージェントは、制約を掘り下げ、代替案を検討し、トレードオフを示す質問を繰り返し、重要な曖昧さがすべて解消されるまで進めます。ユーザーがまとめられた設計概要を確認した後にのみ、エージェントは実装可能な仕様を作成します。

実装

activation:
  trigger: "before_code_generation"
  conditions:
    - task_complexity > "trivial"
    - specification_completeness < 0.7

brainstorming_phases:
  - name: "Intent Extraction"
    actions:
      - parse_user_request
      - identify_nouns_as_entities
      - identify_verbs_as_operations
      - flag_ambiguous_terms

  - name: "Constraint Discovery"
    questions:
      - "What does success look like for this feature?"
      - "Who are the users and what are their primary workflows?"
      - "What are the hard constraints (budget, timeline, platform)?"
      - "What existing systems must this integrate with?"

  - name: "Alternative Exploration"
    actions:
      - generate_minimum_3_approaches
      - score_each_on: [complexity, maintainability, performance, time_to_ship]
      - present_comparison_table

  - name: "Design Brief Synthesis"
    output:
      - problem_statement
      - chosen_approach_with_rationale
      - explicit_non_goals
      - acceptance_criteria
      - estimated_task_breakdown

ベストプラクティス

  • ごく簡単な複雑さと評価されたタスク以外では、ブレインストーミングを省略しないでください
  • 分析が行き詰まるのを避けるため、ブレインストーミングのラウンドは 3~5 回に制限してください
  • 推奨案を示す前に、必ず少なくとも 3 つの代替アプローチを提示してください
  • 対象外として明示的に除外した内容は、非目標として記録してください
  • 抽象的な説明ではなく、具体例やシナリオを使用してください
  • すべてのブレインストーミングの最後に、ユーザーが確認する設計概要を文書として作成してください

プラットフォームの互換性

プラットフォームサポート備考
Cursor完全SKILL.md によるネイティブな有効化
VS Code完全Copilot エージェントモード経由
Windsurf完全Cascade ルール経由
Claude Code完全AGENTS.md 経由
Cline完全.clinerules 経由
aider一部conventions ファイル経由

関連スキル

  • 計画の作成 - ブレインストーミングで作成した設計概要を、検証コマンド付きの段階的な実装計画に変換します
  • 計画の実行 - チェックポイントとロールバックを用いたバッチ実行で、承認済みの計画を推進します
  • コードレビュー - 実装がブレインストーミングで作成した設計概要に合致していることを検証する品質ゲートです

キーワード

brainstorming socratic-method design-refinement requirements-gathering before-coding alternative-exploration constraint-discovery specification


© 2026 googleadsagent.ai™ | Agent Skills™ | MIT License

コメント