本文へ移動
cccskills
無料GitHub で公開

roadmap-manager

ロードマップ(`.agent/roadmap.md`)を運用するスキル。タスクの追加・変更・削除・次タスク着手・完了同期を一貫して扱い、ExecPlan未作成タスクは着手前に計画を作成する。

インストール方法を見る

含まれるファイル(1)

  • SKILL.md4.5 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Roadmap Manager

.agent/roadmap.md をSSOTとして、ロードマップの保守と実行を行う。 実装規約は AGENTS.md を最優先とする。

記述フォーマット(固定)

ロードマップ項目は必ず次の形で記述する。

### <タスク名>
- Status: `NEXT | WIP | DONE | BLOCKED`
- 着手予定日: `YYYY-MM-DD` または `未定`
- 完了日: `YYYY-MM-DD` または `未完了`
- 目的:
- 背景/課題:
- 到達条件(Definition of Done):
- 非対象(やらないこと):
- 依存関係:
- ExecPlan: `.agent/plans/YYYY-MM-DD-task-name.md` または `なし`
- メモ/判断ログ:

運用制約:

  • ロードマップでは実装手順の箇条書きを持たない(手順はExecPlanへ集約)
  • 進捗管理は Status を正とし、チェックボックスは互換表示が必要な場合のみ使う
  • 追加・更新・削除時は上記全項目を欠落させない
  • 日付欄が未確定の場合は 未定 / 未完了 を使う

実行ルール

  1. 正本は .agent/roadmap.md のみを更新する。
  2. 並び順は依存順を維持し、タスク追加時も依存関係が読める位置へ配置する。
  3. 着手系操作では、対象タスクに ExecPlan が無ければ先に作成する。
  4. タスクの実装と検証が完了した時点では、完了を告げてユーザー確認を求める。完了処理の詳細は .agent/PLANS.md の「完了処理プロトコル」を正本とする。
  5. 変更系操作(追加/変更/削除)では、関連する ExecPlan パスも同時に整合させる。
  6. 最終更新 は変更が発生した日付へ更新する。

コマンド

/roadmap-next

  1. 依存順で次の未完了タスクを1件選定する。
  2. ExecPlan: 行を確認し、無いか値が なし であれば .agent/PLANS.md 準拠で新規作成して行を更新する。
  3. ExecPlan の Progress 初期行を更新して着手する。

/roadmap-add <セクション> <タスク>

  1. 指定セクション配下へ固定フォーマットでタスクを追加する。
  2. 実装タスクの場合は ExecPlan: 行を追加し、対応プランを作成する。
  3. 依存順が崩れないかを確認する。

/roadmap-update <対象> <変更内容>

  1. 対象タスクの 着手予定日 完了日 目的 背景/課題 到達条件 非対象 依存関係 メモ/判断ログ を更新する。
  2. 既存 ExecPlan の目的・検証条件と矛盾しないよう同期する。
  3. 変更後も固定フォーマットが保たれていることを確認する。

/roadmap-remove <対象>

  1. 対象タスクをロードマップから削除する。
  2. 対応 ExecPlan が存在する場合は削除せず、Outcomes & Retrospective に中止理由を追記してアーカイブ扱いにする。
  3. 親子関係と番号構造を整える。

/roadmap-sync

  1. 実装・検証結果に基づき、対象項目の Status を NEXT/WIP/DONE/BLOCKED へ更新する。
  2. Status: DONE に変更する項目だけは、事前にユーザー確認が取れていることを確認する。
  3. Status: DONE に変更する項目は、.agent/PLANS.md の「完了処理プロトコル」に従う。
  4. 互換表示としてチェックボックスが残っている場合のみ整合させる。
  5. スキル自己成長タスクでは、完了同期後に docker compose exec <app-service> php evo skill:complete --plan=<plan_id> --run-id=<run_id> --strict を実行し、集計更新は skill:sync を正本とする。

/roadmap-normalize

  1. 旧ToDo形式の項目を固定フォーマットへ変換する。
  2. 変換時に実装手順を 到達条件 と メモ/判断ログ へ再配置し、詳細は ExecPlan 参照へ寄せる。
  3. 変換後に Status と ExecPlan の欠落がないことを確認する。

参照順(最小)

  1. AGENTS.md
  2. .agent/roadmap.md
  3. .agent/PLANS.md
  4. assets/docs/architecture.md(影響が大きい場合)

意思決定の閾値

自律判断可能:

  • 依存順を維持した文言修正
  • 完了チェック同期
  • ExecPlan の有無判定と新規作成

要相談:

  • 優先順位の大幅変更
  • セクション再編(章立て変更)
  • 複数タスクの一括削除

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

adaptive-validation-runner

無料日本語概要

改修後の動作確認を、AIが自分で環境を立てて最後まで進めるための検証スキル。CLI(curl / php evo / DB)を優先し、画面操作でしか判定できないときだけ Playwright(既定はヘッドレス)に切り替える。Docker の検証環境の起動、インストール、テスト用ユーザー作成、mailpit でのメール確認、main との比較、後片付けまでを扱う。「動作確認」「自走で確認」「実環境で確かめる」「ブラウザで確認」「再現を確認」「Playwright」と依頼されたとき、または修正のあとに実機での裏付けが必要なときに使う。

modxcms-jp/evolution-jp332026年10月10日 更新

agent-orchestrator

無料日本語概要

`.agent/agents/` のエージェント定義を入口に、タスクを調査・計画・実装・レビュー・検証へ分担するスキル。ユーザーが「エージェント」「マルチエージェント」「orchestrator」「役割分担」「複数担当」などを求めたとき、または大きな変更で担当境界を決める必要があるときに使う。

modxcms-jp/evolution-jp332026年10月10日 更新

doc-maintainer

無料日本語概要

AI向けマークダウンドキュメント(SKILL.md、AGENTS.md、.agent/*.md など)の健全性チェックと修正を支援するスキル。「ドキュメントの整合性を確認」「SSOT違反を探す」「スキル定義をメンテしたい」「PRの概要を更新したい」と依頼されたときに使用する。

modxcms-jp/evolution-jp332026年10月10日 更新

exec-plan

無料日本語概要

ExecPlan(実行計画)の作成・検証・更新を支援するスキル。複雑なタスク(新機能開発、リファクタリング、バグ修正)の設計フェーズで使用します。`/create-plan`でプラン作成を開始。

modxcms-jp/evolution-jp332026年10月10日 更新

issue-resolver

無料日本語概要

不具合報告(GitHub Issue、フォーラム投稿、社内報告)を起点に、調査・再現・修正・検証・記録までを一貫実行するスキル。症状の切り分け、原因仮説の整理、最小再現、修正実装、ExecPlan作成、PR下書き、ナレッジ追記が必要なときに使う。

modxcms-jp/evolution-jp332026年10月10日 更新

project-worker

無料日本語概要

Evolution CMS JP Editionの開発タスクを実行するためのワークフロー、コマンド(/work, /start-session等)、およびコーディング規約ガイド。開発作業を開始する際に使用します。

modxcms-jp/evolution-jp332026年10月10日 更新

modxcms-jp のスキルをすべて見る

このスキルの問題を報告する