AgentSkillsCN

plans-management

管理Plans.md任务与标记操作。当用户提到添加任务、更新Plans.md、标记任务已完成，或更改任务状态时，可使用此技能。切勿将其用于：实施工作、代码审查，或非Plans文件的操作。

SKILL.md
--- frontmatter
name: plans-management
description: "Manages Plans.md tasks and marker operations. Use when user mentions adding tasks, updating Plans.md, marking complete, or changing task status. Do NOT load for: implementation work, reviews, or non-Plans file operations."
allowed-tools: ["Read", "Write", "Edit"]
user-invocable: false

Plans Management Skill

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

トリガーフレーズ

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

  • •「タスクを追加して」
  • •「Plans.md を更新して」
  • •「完了マークをつけて」
  • •「タスクの状態を変更して」
  • •"add a task"
  • •"update plans"
  • •"mark as complete"

概要

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

Plans.md の構造

markdown
# 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:WIPClaude Codeタスク着手時
cc:TODO → cc:WIPClaude Codeタスク着手時
cc:WIP → cc:完了Claude Code作業完了時
cc:完了 → pm:確認済（互換: cursor:確認済）PMレビュー完了時
* → blockedどちらでもブロック発生時

マーカーのフォーマット

markdown
# 正しい例
- [ ] タスク名 `cc:WIP`
- [x] タスク名 `cc:完了` (2024-01-15)

# 間違った例
- [ ] タスク名 cc:WIP      # バッククォートなし
- [ ] タスク名 `cc: WIP`   # スペースあり

タスク操作

タスクの追加

markdown
## 追加前
## 🟡 未着手のタスク

- [ ] 既存タスク `cc:TODO`

## 追加後
## 🟡 未着手のタスク

- [ ] 既存タスク `cc:TODO`
- [ ] 新規タスク `cc:TODO`
  - 詳細説明（あれば）

タスクの状態変更

markdown
## 変更前
- [ ] タスク名 `cc:TODO`

## 変更後
- [ ] タスク名 `cc:WIP`

タスクの完了

markdown
## 変更前
- [ ] タスク名 `cc:WIP`

## 変更後
- [x] タスク名 `cc:完了` (2024-01-15)

タスクのアーカイブ

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

markdown
## 📦 アーカイブ

### 2024年1月
- [x] タスク1 `pm:確認済` (2024-01-10)
- [x] タスク2 `pm:確認済` (2024-01-08)

自動整形ルール

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

  1. •最終更新を必ず記載: ヘッダーの日時を更新
  2. •セクション順序を維持: 進行中 → 未着手 → 完了 → アーカイブ
  3. •空セクションは残す: タスクがなくてもセクションヘッダーは削除しない
  4. •インデントを統一: 2スペースまたは4スペース

便利なパターン

サブタスク

markdown
- [ ] 親タスク `cc:WIP`
  - [x] サブタスク1
  - [ ] サブタスク2
  - [ ] サブタスク3

ブロック理由の記載

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

優先度の表現

markdown
- [ ] 🔥 緊急タスク `pm:依頼中`（互換: cursor:依頼中）
- [ ] ⭐ 重要タスク `cc:TODO`
- [ ] タスク `cc:TODO`

関連コマンド

  • •/sync-status - 現在の状態サマリーを出力
  • •/handoff-to-cursor - 完了報告時に Plans.md を自動更新

注意事項

  • •Plans.md は単一ソース: タスク情報を他のファイルに分散させない
  • •こまめに更新: 作業開始時・終了時に必ず更新
  • •Cursor との同期: 長時間経過したら /sync-status で確認

拡張記法（オプション）

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

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

markdown
- [ ] 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 実行時に他タスクと同時実行

依存解析の例

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

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