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:依頼中）
---
## 🟢 完了タスク
- [x] タスク名 `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`
- [x] タスク名 `cc:完了` (2024-01-15)
# 間違った例
- [ ] タスク名 cc:WIP # バッククォートなし
- [ ] タスク名 `cc: WIP` # スペースありタスク操作
タスクの追加
## 追加前
## 🟡 未着手のタスク
- [ ] 既存タスク `cc:TODO`
## 追加後
## 🟡 未着手のタスク
- [ ] 既存タスク `cc:TODO`
- [ ] 新規タスク `cc:TODO`
- 詳細説明（あれば）タスクの状態変更
## 変更前
- [ ] タスク名 `cc:TODO`
## 変更後
- [ ] タスク名 `cc:WIP`タスクの完了
## 変更前
- [ ] タスク名 `cc:WIP`
## 変更後
- [x] タスク名 `cc:完了` (2024-01-15)タスクのアーカイブ
完了から 7日以上経過したタスクはアーカイブセクションに移動：
## 📦 アーカイブ
### 2024年1月
- [x] タスク1 `pm:確認済` (2024-01-10)
- [x] タスク2 `pm:確認済` (2024-01-08)自動整形ルール
Plans.md を更新する際は以下を遵守：
- 最終更新を必ず記載: ヘッダーの日時を更新
- セクション順序を維持: 進行中 → 未着手 → 完了 → アーカイブ
- 空セクションは残す: タスクがなくてもセクションヘッダーは削除しない
- インデントを統一: 2スペースまたは4スペース
便利なパターン
サブタスク
- [ ] 親タスク `cc:WIP`
- [x] サブタスク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] がなくても従来形式で問題なく動作する。