claude/skills/implementation-planning-tasks/SKILL.md
承認済みの設計書(DESIGN.md)からTDD準拠のTODO.mdを作成します。analyzing-requirementsスキルで設計が完了・承認された後に使用します。developingスキルで実装できる形式のタスクリストを生成します。
npx skillsauth add skanehira/dotfiles implementation-planning-tasksInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Claude指示: タスク分解を開始する前に、必ず以下のルールファイルをReadツールで読み込んでください。
rules/core/tdd.mdrules/core/design.mdrules/core/commit.md承認済みの設計書(DESIGN.md)を読み込み、TDD(テスト駆動開発)に準拠したTODO.mdを作成する。生成されるTODO.mdはdevelopingスキルで直接使用できる形式となる。
前提条件: analyzing-requirementsスキルで作成されたDESIGN.mdが存在し、ユーザーに承認されていること。
DESIGN.mdを読み込み、全体を確認する:
Read(file_path="docs/DESIGN.md")
設計書の全セクションを把握し、タスク分解に必要な情報を抽出する。
設計書から実装タスクを抽出し、TDDサイクルに従って分解する:
以下の形式でTODO.mdを生成する:
# TODO: [プロジェクト名]
作成日: [日付]
生成元: planning-tasks
設計書: docs/DESIGN.md
## 概要
[設計書から抽出した目的と範囲]
## 実装タスク
### フェーズ1: 基盤構築
- [ ] プロジェクト構造のセットアップ
- [ ] 依存パッケージのインストール
- [ ] 開発環境の設定
### フェーズ2: [機能名A] の実装
- [ ] [RED] [機能A]の動作テストを作成
- [ ] [GREEN] テストを通過させる最小限の実装
- [ ] [REFACTOR] コード品質の改善
- [ ] [REVIEW] フェーズ実装の簡易セルフレビューと修正
- [ ] [CHECK] lint/format/build の実行と確認
### フェーズ3: [機能名B] の実装
- [ ] [RED] [機能B]の動作テストを作成
- [ ] [GREEN] テストを通過させる最小限の実装
- [ ] [REFACTOR] コード品質の改善
- [ ] [REVIEW] フェーズ実装の簡易セルフレビューと修正
- [ ] [CHECK] lint/format/build の実行と確認
### フェーズN: 品質保証
- [ ] [STRUCTURAL] コード整理(動作変更なし)
- [ ] 全テスト実行と確認
- [ ] [REVIEW] フェーズ実装の簡易セルフレビューと修正
- [ ] [CHECK] lint/format/build の実行と確認
## 実装ノート
### MUSTルール遵守事項
- TDD: RED → GREEN → REFACTOR → REVIEW → CHECK サイクルを厳守
- REVIEW: 各フェーズ完了時に簡易セルフレビューを実施し、問題があればその場で修正
- CHECK: REVIEW後に lint/format/build を実行して最終確認
- Tidy First: 構造変更と動作変更を分離
- コミット: [BEHAVIORAL] または [STRUCTURAL] プレフィックス必須
- [BEHAVIORAL]: 動作を変更するコミット(機能追加、バグ修正、テスト追加)
- [STRUCTURAL]: 動作を変更しないコミット(リファクタリング、フォーマット、コメント追加)
### 参照ドキュメント
- 設計書: docs/DESIGN.md
- MUSTルール: 参照 shared/references/must-rules.md
TODO.mdをdocsディレクトリに出力する:
Write(
file_path="docs/TODO.md",
content=todoContent
)
生成したTODO.mdをセルフレビューし、ぬけもれがなくなるまで修正を繰り返す。
CRITICAL: このプロセスは問題がゼロになるまで繰り返すこと。途中で打ち切らない。
1. DESIGN.mdを再度読み込む(最新の内容を確認)
2. TODO.mdを読み返す
3. DESIGN.mdの各セクションを1つずつ確認し、対応するタスクがあるか照合
4. 以下のチェックリストで問題を洗い出す
5. 問題があれば修正してファイルを更新
6. 問題がゼロになるまで1-5を繰り返す
DESIGN.mdのセクション別照合
機能要件の照合
非機能要件の照合
設計との整合性(ぬけもれチェック重点項目)
TDD準拠
実装可能性
問題を発見した場合:
以下のすべてを満たすまでレビューを終了しない:
問題が解消しない場合(同じ問題が繰り返し発生する等)は、AskUserQuestionツールでユーザーに確認する。
セルフレビュー完了後、ユーザーに確認する:
AskUserQuestion({
questions: [
{
question: "TODO.mdを確認しました。このタスクリストで実装を開始しますか?",
header: "実装開始",
options: [
{ label: "開始する", description: "developingスキルで実装を開始" },
{ label: "却下", description: "コマンドを終了" }
],
multiSelect: false
}
]
})
ユーザーが修正内容を入力した場合(Other選択):
### [エンティティ名] CRUD実装
- [ ] [RED] Create機能のテスト作成
- [ ] [GREEN] Create機能の実装
- [ ] [RED] Read機能のテスト作成
- [ ] [GREEN] Read機能の実装
- [ ] [RED] Update機能のテスト作成
- [ ] [GREEN] Update機能の実装
- [ ] [RED] Delete機能のテスト作成
- [ ] [GREEN] Delete機能の実装
- [ ] [REFACTOR] CRUD処理の共通化
- [ ] [REVIEW] フェーズ実装の簡易セルフレビューと修正
- [ ] [CHECK] lint/format/build の実行と確認
### [エンドポイント名] API実装
- [ ] [RED] 正常系レスポンスのテスト作成
- [ ] [GREEN] 正常系の実装
- [ ] [RED] バリデーションエラーのテスト作成
- [ ] [GREEN] バリデーションの実装
- [ ] [RED] エラーハンドリングのテスト作成
- [ ] [GREEN] エラーハンドリングの実装
- [ ] [REFACTOR] レスポンス形式の統一
- [ ] [REVIEW] フェーズ実装の簡易セルフレビューと修正
- [ ] [CHECK] lint/format/build の実行と確認
### [コンポーネント名] 実装
- [ ] [RED] レンダリングテスト作成
- [ ] [GREEN] 基本UIの実装
- [ ] [RED] インタラクションテスト作成
- [ ] [GREEN] イベントハンドラの実装
- [ ] [RED] エッジケーステスト作成
- [ ] [GREEN] エッジケース対応
- [ ] [REFACTOR] スタイルとロジックの分離
- [ ] [REVIEW] フェーズ実装の簡易セルフレビューと修正
- [ ] [CHECK] lint/format/build の実行と確認
tools
ローカルのコミット履歴と差分からDraft PRを作成する。ブランチ未作成・コミット未作成の状態でも、必要に応じてブランチ作成とコミットを行ってからPRを作成する。`.github/` にPRテンプレートがあれば内容を埋めて、なければ作業内容から本文を生成し、`AskUserQuestion`で作成可否を確認してから `gh pr create --draft` を実行する。「PRを出したい」「draft PRを作成」「プルリクを作って」「PR本文を生成」などのリクエストで起動。
tools
複数サブエージェントに異なる立場を与えて議論を反復し、相違が収束するまで議題を検証して結論を提示する。設計妥当性検証・実装方針比較・原因分析のセカンドオピニオン・アイデアの壁打ちに使用。「議論したい」「壁打ちしたい」「セカンドオピニオン」「複数視点で検証したい」などで起動。
tools
変更内容を分析し、Conventional Commit形式でコミットする (pushはユーザが手動)
development
React 19 + Vite+ (`vp`) + TypeScript + Tailwind CSS v4 + React Router v7 (HashRouter) でモバイル向け静的SPAデモサイトをTDDで構築し、Cloudflare Workers (Static Assets) へ自動デプロイするまでの標準ワークフローを提供する。テンプレートリポジトリ `skanehira/demo-site-template` を `gh repo create --template` で clone することで scaffold を省略する。`localStorage` でフロントエンドのみ完結する"フロントのみ完結デモ"に特化。デザインコンセプトの確立には `frontend-design` スキルを呼び出して連携する。起動トリガー:「デモサイトを作りたい」「モバイル向け静的デモ」「SPAを作ってCloudflareにデプロイ」「静的プロトタイプを公開」「localStorage でフロントだけ完結」。ユースケース:(1)クライアント提案用のUI/UXたたき台、(2)新機能のプロトタイプ、(3)モバイル向けランディング。ツールチェーンは Vite+ (`vp`) で統合(内部 PM は pnpm)。