mcpField
A
agile-router

agile-router

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

agile-router について

agile-routerは、依頼を適切なアジャイル、UX、テスト、プロジェクトメモリのスキルへ案内するエージェントスキルです。依頼の背景と判断手順からスキルを推薦して確認を求め、計画成果物自体は作成しません。

主な機能

  1. 01アジャイルとUXのスキルへ振り分け
  2. 02UI、テスト、メモリのニーズを優先判定
  3. 03計画、セレモニー、進捗管理のスキルを選択
  4. 04実行前に確認を依頼

活用シーン

  1. 01曖昧なプロジェクト依頼に適したスキルの選定
  2. 02スプリントセレモニーや進捗管理スキルの選択
  3. 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 週間の作業でも、ロードマップが役立ちます。判断基準は期間ではなく、進行経路の複雑さです。

プロセス

  1. ユーザーの状況を聞きます。
  2. 該当する領域を特定します。UI/テスト/メモリ、計画、セレモニー、トラッキングのいずれかです。
  3. その領域の意思決定ツリーを適用します。
  4. 簡単な説明を添えて、具体的なスキルを推奨します。
  5. 次に進む前に、ユーザーに確認します。

ルール

  • これはルータースキルです。評価して案内しますが、成果物は作成しません。
  • 問題が明確でない場合は、案内の前に /agile-intake を提案します。
  • 推奨内容の説明には平易な言葉を使います。サイズコードには言及しないでください。
  • 必ず推奨内容をユーザーに確認してください。

利用可能なスキル

スキル目的
/agile-intake曖昧な問題を整理する
/agile-roadmap依存関係を含む複数フェーズの進行経路を計画する(期間を問わない)
/agile-epic取り組みを構成し、ストーリーに分解する
/agile-story局所的な変更の実行計画
/agile-refinement計画成果物を検証し、コードをレビューする
/agile-status進捗を追跡する(チェックポイント、集約、完了)
/agile-sprintスプリント計画のセレモニー
/agile-reviewスプリントレビュー、メトリクス、デモ
/agile-retro改善アクションを伴うふりかえり
/agile-tddTDD のコーチングと任意の適用
/agile-proto静的なブラウザープロトタイプのプロセス(補完:htm-ui スキル)
/agile-design任意のデザインツールで画面、状態、フローを設計する
/agile-onboarding新しいチームメンバーのオンボーディング
/ux-flows / /ux-persona利用フローのカタログとペルソナのウォークスルー
/aim-init / /aim-query / /aim-writeai-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"]

このスキルはルーターです。評価して案内しますが、最終的な成果物は作成しません。具体的な作業には、推奨されたスキルを直接使ってください。

コメント