skill-router

スキルルーター

リクエストを分析し、現在のホストで利用可能なスキルの中から、最も適合する範囲の狭いスキルをおすすめします。現在のセッションで確認できない Claude Code、Codex、Gemini、DeepSeek Harness の機能を前提にしないでください。

このスキルが有効になるとき

次のような場合に、このスキルが有効になります。

• 「どのスキルを使えばよいですか？」や「〜に役立つスキルはありますか？」と尋ねる
• どのスキルかを指定せずに「スキルを使って」と言う
• 必要なことはあるものの、どのスキルが適しているか分からない
• 「スキルルーター」や「スキルを探すのを手伝って」と言う

利用可能なスキル一覧

メタ・ワークフロー

スキル	最適な用途
skill-router	タスクに適したスキルを見つけて選ぶ
create-pr	バイリンガルのドキュメントチェックを伴うプルリクエストの作成
session-logger	セッションの要約とアクティビティログの保存
workflow-orchestrator	複数のスキルを使うワークフローとトリガーの調整
self-improving-agent	完了したスキルワークフローから学習
auto-trigger	スキル間のトリガー関係の宣言

コア開発

スキル	最適な用途
commit-helper	Git のコミットメッセージの作成とコミットのフォーマット
code-reviewer	PR、コード変更、品質チェックのレビュー
debugger	バグ、エラー、予期しない動作の診断
refactoring-specialist	コード構造の改善と技術的負債の削減

ドキュメント・テスト

スキル	最適な用途
documentation-engineer	README、技術ドキュメント、コードドキュメントの作成
api-documenter	OpenAPI／Swagger 仕様の作成
test-automator	テストの作成とテストフレームワークのセットアップ
qa-expert	テスト戦略、品質ゲート、QA プロセス

アーキテクチャ・DevOps

スキル	最適な用途
api-designer	REST／GraphQL API の設計と API アーキテクチャ
security-auditor	セキュリティ監査、脆弱性レビュー、OWASP Top 10
performance-engineer	パフォーマンスの最適化と速度分析
deployment-engineer	CI/CD パイプラインとデプロイの自動化

計画・分析

スキル	最適な用途
prd-planner	ファイルベースの永続的な計画を伴う PRD の作成
prd-implementation-precheck	実装前の PRD／仕様の事前チェック
architecting-solutions	PRD を伴わないソリューション設計、アーキテクチャ、要件分析
planning-with-files	複数段階のタスク計画と、ファイルベースの永続的な整理
long-task-coordinator	状態と復旧手順を明確にする必要がある、複数セッションにまたがる作業、委任された作業、または再開可能な作業

デザイン・UX

スキル	最適な用途
figma-designer	Figma デザインの分析と、実装可能なビジュアル仕様／PRD の作成

ルーティング手順

ステップ 1：意図の分析

ユーザーのリクエストを分析し、次の点を特定します。

• タスクの種類：ユーザーが達成したいこと
• コンテキスト：作業領域（ウェブ、モバイル、データなど）
• 複雑さ：単純なタスクか、複雑なワークフローか

ステップ 2：スキルの照合

次の方法を使って、特定した意図に最も関連するスキルを照合します。

• キーワード照合：リクエストのキーワードをスキルの説明と比較する
• 意味的な類似性：リクエストの背景にある意味を理解する
• コンテキストの把握：プロジェクトの状態とこれまでの操作を考慮する

ステップ 3：対話による確認

リクエストが曖昧な場合は、次のような質問でユーザーを案内します。

• 主な目標は何ですか？
• どのような出力を希望していますか？
• 制約や希望事項はありますか？

ステップ 4：おすすめと実行

次の情報を添えて、おすすめのスキルを提示します。

• スキル名と簡単な説明
• 現在のリクエストに適している理由
• 続行するか、別の候補を尋ねるかの選択肢

ルーティングの例

例 1：意図が明確な場合

ユーザー：「このプルリクエストをレビューしてほしいです」

ルーターの分析：

• キーワード：「レビュー」「プルリクエスト」
• 意図：コードレビュー
• おすすめ： code-reviewer

例 2：意図が曖昧な場合

ユーザー：「プロジェクトを手伝ってくれるスキルを使ってください」

ルーターからの質問：

1. どのような種類のタスクに取り組んでいますか？
2. 設計、コーディング、テスト、ドキュメント作成のどれを行っていますか？

回答に基づいて → 適切なスキルを提案します

例 3：複数のスキルを使うシナリオ

ユーザー：「新しい API を構築していて、一連のワークフロー全体についてサポートが必要です」

ルーターからの提案： 複数のスキルを順番に使うことを検討してください：

1. api-designer - API の構造を設計します
2. api-documenter - OpenAPI を使ってエンドポイントをドキュメント化します
3. test-automator - API テストを設定します
4. code-reviewer - 実装をレビューします

対話形式の質問テンプレート

ユーザーの意図が不明確な場合は、次の質問パターンを使います：

目標の確認

• 「このタスクで何を達成しようとしていますか？」
• 「理想的な結果はどのようなものですか？」

分野の特定

• 「これはどの分野に関係しますか：開発、テスト、ドキュメント作成、デプロイのどれですか？」
• 「コード、API、インフラストラクチャ、またはその他のものに取り組んでいますか？」

段階の確認

• 「現在どの段階ですか：計画、実装、テスト、保守のどれですか？」

希望の確認

• 「手早く解決したいですか、それとも包括的な方法を希望しますか？」
• 「使用している特定のツールやフレームワークはありますか？」

ベストプラクティス

1. 大まかに始めてから、絞り込む

• 一般的なカテゴリに関する質問から始めます
• 回答に基づいて、具体的な内容を掘り下げます

2. 推奨する理由を説明する

• 特定のスキルを推奨する理由をユーザーに伝えます
• 透明性を保つことで信頼を築きます

3. 代替案を提示する

• 最もおすすめするものを提示します
• 該当する場合は、代替案を 1～2 個挙げます

4. 例外的なケースに対応する

• 完全に適合するスキルがない場合は、最も近いものを提案します
• 特定のスキルを使わないほうがよい場合は、そのままサポートすることを申し出ます

5. コンテキストから学ぶ

• 以前のやり取りを考慮します
• 今後のルーティングに活かせるよう、ユーザーの好みを記憶します

高度なルーティングパターン

セマンティックルーティング

キーワードが直接一致しない場合は、意味的類似性を使います：

• 「コードを整理して」 → refactoring-specialist
• 「アプリをもっと速くして」 → performance-engineer
• 「セキュリティ上の問題がないか確認して」 → security-auditor
• 「中断したワークフローを再開して」 → long-task-coordinator

複数スキルのオーケストレーション

複雑なワークフローでは、スキルの組み合わせを提案します：

• 新機能：architecting-solutions → debugger → code-reviewer
• API プロジェクト：api-designer → api-documenter → test-automator
• 本番環境への準備：security-auditor → performance-engineer → deployment-engineer

信頼度

推奨の信頼度を示します：

• 高：キーワードが直接一致し、意図が明確
• 中：意味的類似性があり、妥当な推測が可能
• 低：リクエストが曖昧で、確認が必要

エラーからの復旧

推奨したスキルが適合しない場合：

1. ミスマッチを認めます
2. 理解を深めるため、追加の質問をします
3. 代替案を提示します
4. 必要に応じて、一般的なサポートに切り替えます

出力形式

スキルを推奨する際は、次の形式を使います：

## Recommended Skill: {skill-name}

{brief description of why this skill fits}

**What it does:** {one-sentence skill description}

**Best for:** {specific use cases}

---

Would you like me to activate this skill, or would you prefer to see other options?

参考資料

• AI エージェントのルーティング：チュートリアルとベストプラクティス
• マルチエージェントシステムにおける意図認識と自動ルーティング
• マルチ LLM ルーティング戦略（AWS）