agile-router について
agile-routerは、依頼を適切なアジャイル、UX、テスト、プロジェクトメモリのスキルへ案内するエージェントスキルです。依頼の背景と判断手順からスキルを推薦して確認を求め、計画成果物自体は作成しません。
主な機能
- 01アジャイルとUXのスキルへ振り分け
- 02UI、テスト、メモリのニーズを優先判定
- 03計画、セレモニー、進捗管理のスキルを選択
- 04実行前に確認を依頼
活用シーン
- 01曖昧なプロジェクト依頼に適したスキルの選定
- 02スプリントセレモニーや進捗管理スキルの選択
- 03デザイン、プロトタイプ、TDD作業の振り分け
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ djalmajr/ skills --skill agile-routerインストール後、Claude Code で/agile-routerを入力して読み込まれたか確認します。
詳細
ルーター
適切なアジャイルスキルを判断し、正しいスキルに案内するには、このスキルを使用します。
スラッシュコマンドで受け取った初期コンテキスト:$ARGUMENTS
$ARGUMENTS に値が入っている場合は、それをコンテキストとして適切なスキルを判断します。
空の場合は、何を手伝えばよいかユーザーに尋ねます。
プロンプト
プロジェクト全体の規約である CLAUDE.md / AGENTS.md(「スキルのプロンプト規約」)に従います。以下の判断ポイントでは、ハーネスの構造化質問ツール(Claude Code の AskUserQuestion、Codex の ask_user_question、または OpenCode の question)を使用します。
| 判断ポイント | 構造化する理由 | 推奨される選択肢 |
|---|---|---|
| 曖昧な場合に推奨するスキル | 作業の行き先を決めるため | 推奨を明示したうえで、候補を2~4個提示する |
自由形式のプロンプト(構造化ツールなし):
- 問題の説明(ルーターが判断するため)
一時停止なしモード:ユーザーがスキルの途中での確認を明示的に無効にしている場合は、最も確度の高い候補を選んで進めます。質問する代わりに、判断内容と理由を伝えます。
対象範囲
このスキルの対象領域は次のとおりです。まず UI/テスト/メモリを解決してから、プランニングに進みます。
| 領域 | 質問 | スキル |
|---|---|---|
| UI/フロー | 画面、モックアップ、またはユーザージャーニーを検証する必要がありますか? | /agile-proto(補完:htm-ui スキル)、/agile-design、/ux-flows、/ux-persona |
| テスト | TDD、カバレッジ、またはレッド・グリーンが必要ですか? | /agile-tdd |
| メモリ | プロジェクトの知識を接続または検索しますか? | /aim-init、/aim-query、/aim-write |
| 作成するもの | この作業に適したプランニング成果物は何ですか? | /agile-intake、/agile-roadmap、/agile-epic、/agile-story |
| 実施するセレモニー | スプリントサイクルのどの段階ですか? | /agile-sprint、/agile-review、/agile-retro |
| 追跡するもの | 進捗をどのように報告しますか? | /agile-status(チェックポイント、集約、完了) |
判断ツリー
最初に:UI、テスト、またはメモリ?
- クリック可能なブラウザプロトタイプ/バックエンドなしでフローを検証する →
/agile-proto(補完:htm-uiスキル) - デザインツール(Paper、Figma、Pen.dev、Penpot など)で画面と状態を扱う →
/agile-design - ユーザーとしてアプリ(または配信中のプロトタイプ)を操作する →
/ux-flows、/ux-persona - TDD、カバレッジ、レッド・グリーン、テストの強制 →
/agile-tdd - ai-memory の接続、想起、永続的な注釈 →
/aim-init、/aim-query、/aim-write - それ以外 → 以下のプランニング、セレモニー、または追跡に進む
プランニング:どの成果物が必要ですか?
flowchart TD
A[New problem or request] --> B{Is the problem clear?}
B -- No --> C["/agile-intake"]
B -- Yes --> D{Multi-phase trajectory<br/>with dependencies?}
D -- Yes --> I["/agile-roadmap"]
I --> G["/agile-epic"]
D -- "No, single initiative" --> E{What size?}
E -- "Small, localized" --> F["/agile-story"]
E -- "Medium/large, needs decomposition" --> G
C --> H{Intake recommends...}
H -- Multi-phase trajectory --> I
H -- Single initiative --> G
H -- Small/clear --> F
/agile-roadmapに関する注意: ロードマップは期間(例:「3~12か月」)ではなく、進行の複雑さによって定義されます。4週間の取り組みでも、依存関係のある複数の段階を順に進める場合は、ロードマップを作成すると役立ちます。
/agile-epicに関する注意: エピックの概要とストーリーへの分解の両方を扱います。独立したストーリースキルはありません。受け入れ条件をより充実させる必要がある中規模の作業では、構成を整理するために/agile-epicを使うか、単一の垂直方向のデリバリーであれば直接/agile-storyを使います。
セレモニー:サイクルのどの段階ですか?
- スプリントを開始しますか? →
/agile-sprint - スプリントが終了したところですか? →
/agile-review(デリバリーをデモ)を実施し、その後/agile-retro(プロセスを振り返る)を実施します - バックログ項目が不明確ですか? →
/agile-epic(分解)または/agile-refinementの実施(検証) - メトリクスが必要ですか? →
/agile-review(メトリクスはレビュー成果物のセクションです)
追跡:進捗をどのように報告しますか?
- 日々の簡易チェックポイントですか? →
/agile-status(チェックポイントモード) - 期間またはマイルストーンの集約ですか? →
/agile-status(集約モード) - デリバリーが完了しましたか? →
/agile-status(完了モード)
ライトサイジング
AI エージェント向けの内部リファレンス — ユーザーには公開されません。 推奨内容を伝えるときは、平易な言葉を使ってください。
| サイズ | 説明 | 成果物 | スキル |
|---|---|---|---|
| 特小 | 局所的な調整、1 ファイル、低リスク | タスク | /agile-story |
| 小 | 小規模な提供、少数のファイル、簡単な検証 | タスク | /agile-story |
| 中 | 垂直的な提供、複数のファイル、中程度の検証 | エピックストーリーファイルまたはタスク | /agile-epic または /agile-story |
| 大 | 複数のストーリーを連携させる必要があり、分解が必要 | エピック | /agile-epic |
| 特大 | 複数のストーリーにまたがる取り組み、調整が必要 | エピック | /agile-epic |
ロードマップとエピックの使い分け
サイズだけでは、ロードマップとエピックのどちらにするかは決められません。次のチェックリストを使ってください。
2 項目以上に当てはまる場合は /agile-roadmap を使います(期間を問いません)。
- 複数の取り組みを順序立てる必要がある(すべてを並行して進められない)
- 今日の判断が将来の判断に影響する(局所的な最適化が技術的負債になる可能性がある)
- 個々のステップを承認する前に、関係者が全体の道筋を把握する必要がある
- 外部依存関係がある(他チーム、ベンダー、期限)
- 全体の複雑さが単一のエピックに収まらない
次の場合は /agile-epic を使います。
- 範囲が明確な、単一の連携された取り組みである
- 親となる計画を必要とせずにストーリーに分解できる
- 1 回の提供ウェーブに収まる(目標が異なる明確なフェーズがない)
アンチパターン: ロードマップを「長期的な戦略計画」と決めつけないでください。5 つのフェーズがあり、順序が厳密に決まった 4 週間の作業でも、ロードマップが役立ちます。判断基準は期間ではなく、進行経路の複雑さです。
プロセス
- ユーザーの状況を聞きます。
- 該当する領域を特定します。UI/テスト/メモリ、計画、セレモニー、トラッキングのいずれかです。
- その領域の意思決定ツリーを適用します。
- 簡単な説明を添えて、具体的なスキルを推奨します。
- 次に進む前に、ユーザーに確認します。
ルール
- これはルータースキルです。評価して案内しますが、成果物は作成しません。
- 問題が明確でない場合は、案内の前に
/agile-intakeを提案します。 - 推奨内容の説明には平易な言葉を使います。サイズコードには言及しないでください。
- 必ず推奨内容をユーザーに確認してください。
利用可能なスキル
| スキル | 目的 |
|---|---|
/agile-intake | 曖昧な問題を整理する |
/agile-roadmap | 依存関係を含む複数フェーズの進行経路を計画する(期間を問わない) |
/agile-epic | 取り組みを構成し、ストーリーに分解する |
/agile-story | 局所的な変更の実行計画 |
/agile-refinement | 計画成果物を検証し、コードをレビューする |
/agile-status | 進捗を追跡する(チェックポイント、集約、完了) |
/agile-sprint | スプリント計画のセレモニー |
/agile-review | スプリントレビュー、メトリクス、デモ |
/agile-retro | 改善アクションを伴うふりかえり |
/agile-tdd | TDD のコーチングと任意の適用 |
/agile-proto | 静的なブラウザープロトタイプのプロセス(補完:htm-ui スキル) |
/agile-design | 任意のデザインツールで画面、状態、フローを設計する |
/agile-onboarding | 新しいチームメンバーのオンボーディング |
/ux-flows / /ux-persona | 利用フローのカタログとペルソナのウォークスルー |
/aim-init / /aim-query / /aim-write | ai-memory を接続して使用する |
/agile-router | このスキル — 使用するスキルの案内 |
フローとの関係
flowchart LR
A["/agile-intake"] --> B["/agile-roadmap"]
B --> C["/agile-epic"]
C --> D["/agile-story"]
D --> E[execution]
E --> F["/agile-status"]
F --> G["/agile-review"]
G --> H["/agile-retro"]
このスキルはルーターです。評価して案内しますが、最終的な成果物は作成しません。具体的な作業には、推奨されたスキルを直接使ってください。