AgentSkillsCN

plan

为功能实现生成设计文档与任务分解。可通过“计划”“设计”“拆解”“分析影响”“任务分解”等指令触发。仅用于读取，绝不修改源代码。输出结构化的方案，供人工审核。

SKILL.md
--- frontmatter
name: plan
description: >
  Generates design documents and task breakdowns for feature implementation.
  Triggers: plan, design, decompose, analyze impact, task breakdown.
  Read-only — never modifies source code. Outputs a structured plan for human review.

Plan

機能実装の事前設計を行うスキル。影響調査・タスク分解・並行化分析・テスト戦略を 構造化されたドキュメントとして出力する。ソースコードは一切変更しない。

基本姿勢

  • •読み取り専用（コード変更禁止）
  • •要件が曖昧な場合は選択肢を提示して確認する
  • •出力は人間がレビュー・承認するためのもの。承認なしに実装へ進まない
  • •過度な設計は避け、実装に必要十分な粒度でまとめる

ワークフロー

  1. •要件整理 — ユーザーの要求を構造化し、受け入れ基準を明文化する
  2. •影響調査 — 関連するファイル・ストア・スキーマ・テストを特定する
  3. •タスク分解 — 実装単位に分割し、依存関係を明示する
  4. •並行化分析 — 並行実行可能なタスクと逐次実行が必要なタスクを分類する
  5. •テスト戦略 — ユニットテスト・E2Eテストの対象と方針を定義する
  6. •レビュー提出 — 設計ドキュメントを出力し、人間の承認を待つ

出力フォーマット

markdown
# 設計ドキュメント: [機能名]

## 要件サマリー
- [受け入れ基準の箇条書き]

## 影響調査
| カテゴリ | ファイル | 変更内容 |
| --- | --- | --- |
| スキーマ | src/shared/types/xxx.ts | フィールド追加 |
| ストア | src/stores/xxx-store.ts | アクション追加 |
| ... | ... | ... |

## タスク分解

### Phase 1（並行可能）
- [ ] タスクA — [説明]（変更ファイル: ...）
- [ ] タスクB — [説明]（変更ファイル: ...）

### Phase 2（Phase 1完了後）
- [ ] タスクC — [説明]（変更ファイル: ...、依存: タスクA）

### Phase 3（逐次）
- [ ] タスクD — [説明]（変更ファイル: ...、依存: タスクB, C）

## 依存関係グラフ
タスクA ──┐
          ├──→ タスクC ──→ タスクD
タスクB ──┘

## テスト戦略
### ユニットテスト
- [対象と方針]

### E2Eテスト
- [対象シナリオ]

## リスク・懸念事項
- [特記事項があれば]

調査で使用するツール

  • •Glob / Grep — ファイル・コード検索
  • •Read — ファイル内容の確認
  • •npx depcruise — 依存関係の可視化（必要に応じて）

禁止事項

  • •ソースコードの変更（テストファイルも含む）
  • •設計の承認なしに実装タスクを開始すること
  • •プロジェクト固有のデータ（ID、パスワード等）をドキュメントに含めること