mcpField
O
overseer-plan

overseer-plan

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

overseer-plan について

overseer-planは、Markdownの計画文書を、追跡可能なOverseerのマイルストーン、タスク、サブタスクに変換します。実行可能な計画や仕様を作業項目に整理するエージェント向けで、作成前に分解内容をレビューします。

主な機能

  1. 01Markdown見出しからタイトルを抽出
  2. 02マイルストーンと子タスクを作成
  3. 03計画を階層的なタスクに分解
  4. 04タスク品質基準を適用
  5. 05Oracleで分解内容をレビュー

活用シーン

  1. 01完成した計画をタスクに変換
  2. 02仕様から実装作業を作成
  3. 03ロードマップやマイルストーンのタスク化

MCP 対応

このスキルはOverseerにタスクを作成し、MCP経由で永続化します。タスク操作にはOverseer MCP codemode APIを使う方法も記載されています。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/dmmulroy/overseer --skill overseer-plan

インストール後、Claude Code で/overseer-planを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
api.md
examples.md
implementation.md

詳細

Markdown ドキュメントを Overseer タスクに変換する

/overseer-plan を使うと、任意の Markdown の計画ドキュメントを追跡可能な Overseer タスクに変換できます。

使用するタイミング

  • Plan モードで計画を完了した後
  • 仕様書や設計ドキュメントを実装タスクに変換するとき
  • ロードマップやマイルストーンドキュメントからタスクを作成するとき

使い方

/overseer-plan <markdown-file-path>
/overseer-plan <file> --priority 1           # Set priority (0-2, 0=highest)
/overseer-plan <file> --parent <task-id>     # Create as child of existing task

動作内容

  1. Markdown ファイルを読み込みます
  2. 最初の # 見出しからタイトルを抽出します（「Plan: 」のプレフィックスを削除します）
  3. Overseer マイルストーンを作成します（--parent が指定されている場合は子タスクを作成します）
  4. 構造を分析して子タスクの分割を検討します
  5. 適切な場合は子タスク（深さ 1）またはサブタスク（深さ 2）を作成します
  6. タスク ID と分割の概要を返します

階層レベル

深さ名前例
0マイルストーン「ユーザー認証システムを追加する」
1タスク「JWT ミドルウェアを実装する」
2サブタスク「トークン検証関数を追加する」

分割の判断基準

次の場合はサブタスクを作成します：

  • 明確に分割可能な作業項目が 3～7 個ある
  • 複数のファイルやコンポーネントにまたがる実装である
  • 明確な順次依存関係がある

次の場合は単一のマイルストーンにまとめます：

  • ステップが 1～2 個のみ
  • 作業項目の相互依存性が高い
  • 計画が探索的、または調査的である

タスクの品質基準

すべてのタスクは、次の条件を満たす必要があります：

  • アトミック：コミット可能な作業単位が 1 つである
  • 検証可能：テスト、またはコンテキスト内に明示的な受け入れ条件（「完了条件：…」）がある
  • 明確：技術的かつ具体的で、命令形の動詞を使っている

すべてのマイルストーンは、次の条件を満たす必要があります：

  • デモ可能：実行またはテスト可能な成果物が得られる
  • 前の成果を基盤にする：前のマイルストーンの出力に依存できる

レビューワークフロー

  1. ドキュメントを分析し、分割案を提示します
  2. Oracle を呼び出し、分割案のレビューと改善案の提案を依頼します
  3. フィードバックを反映します
  4. Overseer に作成します（MCP を介して SQLite に保存されます）

作成後

await tasks.get("<id>");                    // TaskWithContext (full context + learnings)
await tasks.list({ parentId: "<id>" });     // Task[] (children without context chain)
await tasks.start("<id>");                  // Task (VCS required - creates bookmark, records start commit)
await tasks.complete("<id>", { result: "...", learnings: [...] });  // Task (VCS required - commits, bubbles learnings)

VCS が必要です：start と complete の実行には jj または git が必要です（見つからない場合は NotARepository エラーになります）。CRUD 操作は VCS がなくても実行できます。

注：優先度は 1～5 で指定する必要があります。ブロッカーを祖先または子孫にすることはできません。

使用しない場合

  • ドキュメントが未完成、または探索的である
  • 内容が実行可能なアクションにつながらない
  • 意味のある計画内容がない

参照順序

タスクファイル
API の理解@file references/api.md
エージェントの実装@file references/implementation.md
例を見る@file references/examples.md

このリファレンスの内容

ファイル目的
references/api.mdOverseer MCP codemode API の型とメソッド
references/implementation.mdエージェント向けのステップごとの実行手順
references/examples.md詳細な作成例

コメント

Markdown 対応