plan
Installation
SKILL.md
GitHub issue ( $ARGUMENTS ) から実装計画と動作確認チェックリストを作成する。
本スキルは 意思決定 + 計画策定 に責務を持つ。/research が列挙した候補から実装方法を選択し、受け入れ条件をタスクにマッピングして TDD で計画化し、AC を検証可能にする動作確認チェックリストまで作成する(チェックリストを計画段階で作ることで、/review-plan が実装前にカバレッジを検証できる)。
記述の原則: 探索の代替を書き、付加的な説明は書かない
plan.md は /implement が持つ唯一の文脈(あとは自力の grep だけ)。したがって plan.md の良さは分量ではなく、/implement が自力で探さずに済む情報がどれだけ入っているかで決まる。
| 書く(探索の代替になる) | 書かない / 最小限にする(探索を減らさない) |
|---|---|
| 変更対象の正確なファイルパス | 方式選択の長い理由づけ(1〜3 行で足りる) |
| 追加・変更する関数 / メソッド / シンボル名とシグネチャ | 却下した代替案の詳細(research.md にある) |
参照すべき既存実装の具体的な場所(path:行 または関数名) |
issue 本文の言い直し |
| 具体的なテストケース(入力と期待結果) | コードの振る舞いを散文で描写した説明 |
| データ形状・エラー処理・命名・配置の決定事項 | 一般的なベストプラクティスの解説 |
理由は 2 つ。