Initial commit

skills/task-executor/README.md

@@ -0,0 +1,187 @@
+# Task Executor スキル
+
+docs/tasks.mdに記載されたタスクを自動的に実行するClaude Codeスキルです。
+
+## 概要
+
+Task Executorスキルは、プロジェクトのdocs/tasks.mdファイルからタスクを読み取り、サブエージェントを使用して自動的に実装を行います。並列実行可能なタスクは並列で処理し、各タスク完了後に適切なコミットを作成します。
+
+## 主な機能
+
+- docs/tasks.mdからのタスク自動読み取り
+- サブエージェントを使用した自動実装
+- 並列実行可能なタスクの並列処理
+- タスクごとの自動コミット作成
+- 重要な変更前の安全なコミット作成
+- タスク完了時のtasks.md自動更新
+- 絵文字を使用しないクリーンなメッセージ
+
+## 使用方法
+
+### 基本的な使い方
+
+```
+次のタスクを実行してください
+```
+
+または
+
+```
+tasks.mdのタスクを進めてください
+```
+
+### 複数タスクの実行
+
+```
+tasks.mdのすべてのTODOタスクを実行してください
+```
+
+## タスクの実行フロー
+
+1. docs/tasks.mdを読み取り、TODO状態のタスクを特定
+2. 依存関係を確認し、実行可能なタスクを決定
+3. 並列実行可能なタスクをグループ化
+4. サブエージェントを起動してタスクを実行
+5. タスク完了後、コミットを作成
+6. tasks.mdを更新して完了をマーク
+7. 次のタスクへ進む
+
+## tasks.mdの形式
+
+このスキルは、sdd-docsスキルで作成されたtasks.mdファイルを想定しています：
+
+```markdown
+#### タスク1.1: ユーザー認証APIエンドポイントの実装
+
+**説明**:
+`src/api/auth.ts`に以下のエンドポイントを実装する：
+- POST /api/auth/login - ユーザーログイン処理
+- POST /api/auth/logout - ログアウト処理
+
+**技術的文脈**:
+- フレームワーク: Next.js 14
+- 認証: JWT + bcrypt
+
+**受入基準**:
+- [ ] login/logoutエンドポイントが実装されている
+- [ ] JWTトークンが正しく生成・検証される
+- [ ] すべてのテストが通過する
+
+**依存関係**: なし
+**推定工数**: 30分（AIエージェント作業時間）
+**ステータス**: `TODO`
+```
+
+## コミット管理
+
+### タスクごとのコミット
+
+各タスク完了後、以下の形式でコミットを作成します：
+
+```
+[Task 1.1] ユーザー認証APIエンドポイントの実装
+
+POST /api/auth/login と POST /api/auth/logout エンドポイントを実装。
+JWTトークンを使用した認証方式を採用し、bcryptでパスワードをハッシュ化。
+
+関連: docs/tasks.md Task 1.1
+```
+
+### 重要な変更前のコミット
+
+アーキテクチャの大幅な変更や大規模なリファクタリングの前には、安全なポイントとしてコミットを作成します：
+
+```
+[Task 2.3] 認証システムリファクタリング前の安全なポイント
+
+大規模なリファクタリングを開始する前の安定した状態を保存。
+```
+
+## tasks.mdの更新
+
+タスク完了後、以下のように更新されます：
+
+```markdown
+#### タスク1.1: ユーザー認証APIエンドポイントの実装
+
+**説明**: [元の説明]
+**受入基準**: [元の受入基準]
+**ステータス**: `DONE`
+**完了サマリー**: login/logoutエンドポイントをJWT認証で実装、すべてのテスト通過
+```
+
+## 並列実行
+
+依存関係のないタスクは自動的に並列実行されます：
+
+```
+以下のタスクを並列実行します：
+
+- Task 1.1: ユーザー認証APIエンドポイントの実装
+- Task 1.2: データモデルの定義
+- Task 1.3: 設定ファイルの作成
+
+実行を開始してよろしいですか？
+```
+
+## 制約事項
+
+以下の場合は自動実行を行わず、ユーザーに確認を求めます：
+
+- タスクの説明が曖昧で、実装方法が複数考えられる場合
+- 本番環境への直接的な変更など、リスクの高い操作
+- 技術選択やアーキテクチャの決定が必要な場合
+
+## 絵文字の使用禁止
+
+このスキルでは、すべてのメッセージ、コミットメッセージ、ドキュメント更新において絵文字を使用しません。クリーンで読みやすいテキストコミュニケーションを維持します。
+
+## ベストプラクティス
+
+### tasks.mdの作成
+
+tasks.mdは、sdd-docsスキルを使用して作成することを推奨します：
+
+1. requirements.mdで要件を定義
+2. design.mdで設計を文書化
+3. tasks.mdでタスクに分解
+4. task-executorスキルで実行
+
+### タスクの粒度
+
+各タスクは以下の粒度が推奨されます：
+- サブエージェント1回の実行で完了できる範囲
+- 20-90分程度の作業量
+- 明確な受入基準を持つ
+
+### 受入基準の具体化
+
+受入基準は検証可能な形で記載してください：
+```markdown
+**受入基準**:
+- [ ] 特定のファイルが存在する
+- [ ] すべてのテストが通過する
+- [ ] ESLintエラーがゼロ
+```
+
+## トラブルシューティング
+
+### タスクが並列実行されない
+
+**原因**: 依存関係が設定されている
+
+**解決**: tasks.mdの依存関係フィールドを確認し、不要な依存関係を削除
+
+### サブエージェントがタスクを完了できない
+
+**原因**: タスクの説明が不十分
+
+**解決**: tasks.mdのタスク説明を詳細化し、以下を含める：
+- 実装すべきファイルパス
+- 使用する技術やライブラリ
+- 具体的な実装手順
+- 技術的文脈
+
+## ライセンス
+
+このスキルはMITライセンスの下で公開されています。