mcpField
P
project-planner

project-planner

github.com/0xdarkmatterエージェントワークフロー7853 回インストール2 週間前に更新
リポジトリ

project-planner について

docs/PLAN.mdの状態を確認し、/saveや/syncの利用時期を提案する軽量なエージェントスキルです。計画の欠落や古さを検出しますが、自身で変更は行いません。

主な機能

  1. 01計画ファイルの欠落検出
  2. 02Gitの活動に基づく計画の古さ確認
  3. 03未コミット作業の確認
  4. 04/saveと/syncコマンドの提案

活用シーン

  1. 01計画ファイルがない状態での作業開始
  2. 02プロジェクトセッションの再開
  3. 03計画に照らした変更の確認
  4. 04更新が必要な計画の特定

インストール

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

$npx skills add https://github.com/0xdarkmatter/claude-mods --skill project-planner

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

同梱ファイル

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

assets/
.gitkeep
references/
.gitkeep
scripts/
.gitkeep

詳細

プロジェクトプランナースキル

docs/PLAN.md の軽量な認識レイヤーです。計画に注意が必要なタイミングを検出し、/save と /sync コマンドを案内します。

目的

このスキルは計画を直接管理しません。以下を行います。

  • docs/PLAN.md が存在するかどうかを検出します
  • 古くなった計画（最近更新されていない一方で、git にアクティビティがある状態）を特定します
  • 適切なセッションコマンドを提案します

計画に関するすべての操作は、/save（保存）と /sync（復元／状態確認）を通じて行います。

検出ロジック

計画がない場合
No docs/PLAN.md found
-> Suggest: /save to create initial plan from conversation
計画が古くなっている場合
docs/PLAN.md last modified: 5 days ago
git log shows: 12 commits since then
-> Suggest: /sync --git to update from commits
未コミットの作業がある場合
git status shows: 5 modified files
docs/PLAN.md "In Progress" section outdated
-> Suggest: /sync --status to review
セッション開始時
Resuming work on project with docs/PLAN.md
-> Suggest: /sync to restore state

クイックリファレンス

状況提案
計画がない目標について話し合った後に /save
計画が古くなっている/sync --git
計画を確認したい/sync --status
進捗を更新する/save "notes"
新たに始める/save --archive

古さの判定基準

計画は、次の場合に古くなっていると見なされます。

  • 最終更新から 3 日を超えている AND
  • 最終更新以降に git のコミットがある AND
  • コミットが計画のトピックに関連している（feat:、fix:、refactor:）

計画は、次の場合にレビューが必要です。

  • セッションが開始されたばかり
  • 重要な未コミットの変更がある
  • ユーザーが進捗や完了について言及した

注記

  • このスキルは提案のみを行い、変更は行いません
  • /sync は状態を読み取り、/save は状態を書き込みます
  • 唯一の信頼できる情報源：docs/PLAN.md

コメント

Markdown 対応