188 lines
5.6 KiB
Markdown
188 lines
5.6 KiB
Markdown
# 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ライセンスの下で公開されています。
|