Skip to content
cccskills
FreePublished on GitHub

roadmap-manager

ロードマップ(`.agent/roadmap.md`)を運用するスキル。タスクの追加・変更・削除、次タスクの選定(`/next-task`)、完了同期(`/roadmap-sync`)を扱い、着手時に改修規模で ExecPlan の要否を判断する。選んだタスクの実装から PR までは exec-plan-runner に渡す。

「次のタスク」「/next-task」「ロードマップに追加」「ロードマップを同期」と依頼されたときに使う。

The English summary is being prepared. Showing the original description.

See how to install

Files included (1)

  • SKILL.md6.7 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Roadmap Manager

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

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

記述フォーマット(項目と各欄の書き方)は .agent/roadmap.md の「記述フォーマット(固定)」を正とする。ここには写さない。

運用制約:

  • ロードマップでは実装手順の箇条書きを持たない(手順はExecPlanへ集約)
  • 進捗管理は Status を正とし、チェックボックスは互換表示が必要な場合のみ使う
  • 追加・更新・削除時は、標準の形(不具合修正のまとめは短い形)の全項目を欠落させない
  • 日付欄が未確定の場合は 未定 / 未完了 を使う
  • 非公開で扱うセキュリティ修正はロードマップの項目にしない(.agent/roadmap.md の「現在地」を参照)

実行ルール

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

コマンド

/next-task [--run]

  1. Issue: の Issue がすべて閉じたのに完了同期していない項目があれば、先に exec-plan-runner スキルの /finish-task を提案する(完了処理はユーザー確認のあとにだけ行う)。
  2. 依存順で次の未完了タスクを1件選定する。次の項目は対象外とする。
    • Status: BLOCKED の項目、依存先が DONE でない項目、非公開で扱うセキュリティ修正
    • 進行中の項目: Issue: の開いている Issue のすべてに、紐づくブランチ(gh issue develop --list <番号>)か PR がある
  3. ExecPlan: が 着手時に判断 か未記入なら、.agent/roadmap.md の目安で要否を決める。この時点ではファイルを書き換えない。
  4. 選んだ項目、ExecPlan の要否とその理由、次に実行するコマンドを示す。--run が無ければ、ここで止まる。
  5. --run があれば、exec-plan-runner スキルに渡す。--run は、下の「作ると決めた」場合の /create-plan によるブランチ作成とコミットの明示指示も兼ねる(exec-plan の「明示指示が必要」の規則)。
    • ExecPlan がある: /run-plan <ExecPlan のパス>
    • 不要(またはそう決めた): 開いている Issue のうち、紐づくブランチも PR も無いものを Issue: に書かれた順(優先順)に 1 件ずつ /run-issue <番号> で進める。ExecPlan: 行の書き換えは、runner が最初の PR に含める
    • 作ると決めた: runner の「作業場所」の手順で、Issue: の先頭に書かれた Issue のブランチとワークツリーを作る。そこで exec-plan スキルの /create-plan を行い、.agent/roadmap.md の ExecPlan: 行も更新する。ブランチを ExecPlan の Artifacts and Notes に記録してコミットし、push せずに作成を告げて止まる(本人が計画を確かめてから /run-plan で進める)

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

  1. 指定セクション配下へ固定フォーマットでタスクを追加する。
  2. Issue: に対応する Issue 番号を書く(無ければ 未起票)。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. スキル自己成長タスクでは、完了同期後に .agent/PLANS.md の「完了処理プロトコル」step 8 に従う。skill:complete 実行後は learning.json / proposal.json の内容を示し、この学びをスキルへ反映しますか? はい・いいえ と確認してから次へ進む。

/roadmap-normalize

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

参照順(最小)

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

意思決定の閾値

自律判断可能:

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

要相談:

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

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

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

The English summary is being prepared. Showing the original description.

modxcms-jp/evolution-jp33Updated Oct 18, 2026

非公開のセキュリティアドバイザリ(下書き)で扱う修正を、人の確認を待たずに「準備 → 実装 → 範囲の照合 → 検証 → 自己レビュー → 一時的な非公開フォークへの push → フォーク内の PR」まで進めるスキル。`/run-advisory <GHSA-ID> <計画のパス>` を提供する。ユーザーが「/run-advisory」「アドバイザリを自走で直して」「非公開フォークで修正を進めて」と依頼したときに使う。公開の Issue や ExecPlan を回すなら exec-plan-runner を使う。

The English summary is being prepared. Showing the original description.

modxcms-jp/evolution-jp33Updated Oct 18, 2026

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

The English summary is being prepared. Showing the original description.

modxcms-jp/evolution-jp33Updated Oct 18, 2026

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

The English summary is being prepared. Showing the original description.

modxcms-jp/evolution-jp33Updated Oct 18, 2026

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

The English summary is being prepared. Showing the original description.

modxcms-jp/evolution-jp33Updated Oct 18, 2026

Issue または ExecPlan を、人の確認を待たずに「準備 → 実装 → 範囲の照合 → 検証 → 自己レビュー → push → PR」まで進めるスキル。`/run-issue <番号>`・`/run-plan <ExecPlan のパス>`・`/finish-task` を提供する。ユーザーが「/run-issue」「/run-plan」「Issue を自走で直して」「ExecPlan を最後まで進めて」「0 節の Issue を順に片付けて」と依頼したときに使う。ExecPlan を作るだけなら exec-plan、次のタスクを選ぶだけなら roadmap-manager を使う。

The English summary is being prepared. Showing the original description.

modxcms-jp/evolution-jp33Updated Oct 18, 2026

See all skills by modxcms-jp

Report a problem with this skill