Plans Management Skill

Plans.md のタスク管理とマーカー運用を行うスキル。

トリガーフレーズ

このスキルは以下のフレーズで起動します：

• 「タスクを追加して」

• 「Plans.md を更新して」

• 「完了マークをつけて」

• 「タスクの状態を変更して」

• "add a task"

• "update plans"

• "mark as complete"

概要

このスキルは Plans.md の編集・更新を支援します。 タスクの追加、状態変更、アーカイブを一貫したフォーマットで行います。

Plans.md の構造

Plans.md - タスク管理

最終更新: YYYY-MM-DD HH:MM 更新者: Claude Code / PM（Cursor/PM Claude）

🔴 進行中のタスク

• タスク名 cc:WIP
  • 詳細説明
  • 関連ファイル: path/to/file.ts

🟡 未着手のタスク

• タスク名 cc:TODO
• タスク名 pm:依頼中（互換: cursor:依頼中）

🟢 完了タスク

• タスク名 pm:確認済 (YYYY-MM-DD)

📦 アーカイブ

<!-- 古い完了タスクはここに移動 -->

マーカー運用ルール

状態変更のルール

変更 実行者 条件

pm:依頼中 （互換: cursor:依頼中） → cc:WIP

Claude Code タスク着手時

cc:TODO → cc:WIP

Claude Code タスク着手時

cc:WIP → cc:完了

Claude Code 作業完了時

cc:完了 → pm:確認済 （互換: cursor:確認済） PM レビュー完了時

→ blocked

どちらでも ブロック発生時

マーカーのフォーマット

正しい例

• タスク名 cc:WIP
• タスク名 cc:完了 (2024-01-15)

間違った例

• タスク名 cc:WIP # バッククォートなし
• タスク名 cc: WIP # スペースあり

タスク操作

タスクの追加

追加前

🟡 未着手のタスク

• 既存タスク cc:TODO

追加後

🟡 未着手のタスク

• 既存タスク cc:TODO
• 新規タスク cc:TODO
  • 詳細説明（あれば）

タスクの状態変更

変更前

• タスク名 cc:TODO

変更後

• タスク名 cc:WIP

タスクの完了

変更前

• タスク名 cc:WIP

変更後

• タスク名 cc:完了 (2024-01-15)

タスクのアーカイブ

完了から 7日以上経過したタスクはアーカイブセクションに移動：

📦 アーカイブ

2024年1月

• タスク1 pm:確認済 (2024-01-10)
• タスク2 pm:確認済 (2024-01-08)

自動整形ルール

Plans.md を更新する際は以下を遵守：

• 最終更新を必ず記載: ヘッダーの日時を更新

• セクション順序を維持: 進行中 → 未着手 → 完了 → アーカイブ

• 空セクションは残す: タスクがなくてもセクションヘッダーは削除しない

• インデントを統一: 2スペースまたは4スペース

便利なパターン

サブタスク

• 親タスク cc:WIP
  • サブタスク1
  • サブタスク2
  • サブタスク3

ブロック理由の記載

• タスク名 blocked
  • ブロック理由: API キーの発行待ち
  • 担当: @username
  • 期限: 2024-01-20

優先度の表現

• 🔥 緊急タスク pm:依頼中（互換: cursor:依頼中）
• ⭐ 重要タスク cc:TODO
• タスク cc:TODO

関連コマンド

• /sync-status

• 現在の状態サマリーを出力

• /handoff-to-cursor

• 完了報告時に Plans.md を自動更新

注意事項

• Plans.md は単一ソース: タスク情報を他のファイルに分散させない

• こまめに更新: 作業開始時・終了時に必ず更新

• Cursor との同期: 長時間経過したら /sync-status で確認

拡張記法（オプション）

大規模プロジェクトでは以下の記法をオプションで使用可能：

タスク ID / 依存関係 / 並列可

• T001: 認証機能 cc:TODO
• T002: ユーザーAPI cc:TODO depends:T001
• T003: 商品API cc:TODO [P]
• T004: 注文API cc:TODO depends:T001,T003

記法 意味 用途

T001:

タスクID 参照・依存指定に利用

depends:ID

依存タスク depends:T001,T002 （カンマ区切り）

[P]

並列可（Parallelizable） /work 実行時に他タスクと同時実行

依存解析の例

T001 (認証) ─────────────┐ ↓ T003 (商品API) [P] ─────> T004 (注文API) ↑ T002 (ユーザーAPI) ─────┘

後方互換: ID/depends/[P] がなくても従来形式で問題なく動作する。