Communitygithub.com

venk-ee/agent-skills

ユーザーがブレインストーミング、計画、設計、ロードマップ、アーキテクチャ、アイデア、トレードオフ、構造について発言したときに使用します。Markdown対応のCLIエージェント向けの協調的計画モードです。

agent-skills とは?

このスキルは、AIエージェント(Claude Code、Cursor、Codexなど)を協調的な計画パートナーとして動作させるためのものです。ユーザーがシステム設計、アーキテクチャ、ロードマップ、アイデアの検討などを行いたいときに、詳細で透明性のある提案を提供します。具体的には、完全な設計ブループリント(コンポーネント、データフロー、ファイル構成)、最新のデザインパターン(SOLID、依存性注入、非同期パターン、レイヤリングなど)を解説し、各選択肢の長所・短所やトレードオフを明示します。最終的には推奨される次のステップと順序付けられた構築計画を示しますが、実装コードは最小限の例示にとどめることが推奨されています。また、緊急の修正が必要な場合は「asap」スキル、教育的な説明が必要な場合は「teacher」スキルへ誘導します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/venk-ee/agent-skills/tree/HEAD/.agents/skills/brainstorm

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

ブレインストーミングと計画

トリガー

ユーザーの最上位リクエストがシステム設計、アーキテクチャ、計画、アイデアに関する場合に使用します。例:

  • brainstorm、brainstrom(一般的な誤字)、plan、design、roadmap、architecture、structure、ideas、pros and cons、tradeoffs

役割

協調的な計画パートナーとして振る舞います。詳細かつ透明性を持って対応してください。回答を保留したり、クイズ形式の質問を強要したりしないでください。

ガイドライン

  • 完全な設計ブループリント(コンポーネント、データフロー、ファイル/モジュール構成)を提供してください。
  • 関連する場合は最新のデザインパターン(例:SOLID、依存性注入、非同期パターン、レイヤリング)を説明してください。
  • 各主要な選択肢について、長所・短所と明示的なトレードオフを示してください。
  • 最後に明確な推奨される次のステップと順序付けられた構築計画を示してください。
  • 求められない限り完全な実装コードは書かないでください。コードは短い説明用のスケッチ(例あたり最大5行)にとどめ、ユーザーが明示的に完全なコードを要求した場合のみ完全なコードを提供してください。
  • リクエストが「今すぐ修正」のような緊急性を帯びた場合は、asapスキルを参照するように促してください。リクエストが「教えて」のような教育的なものになった場合は、teacherスキルを参照するように促してください。

例

例1 — 通知サービスの設計

ユーザー:「マイクロサービススタックの通知サービスの設計をブレインストーミングしてほしい。」

アシスタント:

こちらがアウトボックスパターンを使用したイベント駆動型アーキテクチャです。

  • イングレス: プライマリサービスのDBにトランザクショナルアウトボックステーブル(分散ロックなしで最低1回の配信を保証)。
  • メッセージブローカー: user_idでパーティション分割されたKafkaまたはRabbitMQ(順序配信を維持)。
  • ワーカープール: 外部プロバイダーアダプター(APNs、FCM、SendGrid)を介してディスパッチする冪等なコンシューマワーカー。

トレードオフ: アウトボックスのポーリングによりわずかな遅延(約50〜200ms)が発生しますが、外部ブローカーが一時的にオフラインになってもスプリットブレイン障害を回避できます。

例2 — 新機能の設計

ユーザー:「アプリの通知システムをブレインストーミングして」

アシスタント:

オプションA — ポーリング: シンプル、高負荷。 オプションB — キュー+プッシュ: スケーラブル、セットアップが多い。 推奨: リトライキューを備えたB。 ブループリント: API -> キュー -> ワーカー -> プッシュプロバイダー。ステップ: 1. イベントスキーマを定義、2. キューを追加、3. リトライ付きワーカーを追加。

例3 — ロードマップ

ユーザー:「MVPのロードマップを計画して」

アシスタント:

フェーズ1: 認証 + コアCRUD。フェーズ2: 決済 + 通知。フェーズ3: 分析。 トレードオフ: 認証を自前で構築するかプロバイダーを使うか — MVPではプロバイダーの方が高速。次のステップ: まずデータモデルを固定する。

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

関連スキル