zhongwei/gh-windschord-claude-skils-task-executor

Fork 0

Files

Zhongwei Li 98f94c88db Initial commit

2025-11-30 09:06:33 +08:00

5.6 KiB

Raw Blame History

Task Executor スキル

docs/tasks.mdに記載されたタスクを自動的に実行するClaude Codeスキルです。

概要

Task Executorスキルは、プロジェクトのdocs/tasks.mdファイルからタスクを読み取り、サブエージェントを使用して自動的に実装を行います。並列実行可能なタスクは並列で処理し、各タスク完了後に適切なコミットを作成します。

主な機能

docs/tasks.mdからのタスク自動読み取り
サブエージェントを使用した自動実装
並列実行可能なタスクの並列処理
タスクごとの自動コミット作成
重要な変更前の安全なコミット作成
タスク完了時のtasks.md自動更新
絵文字を使用しないクリーンなメッセージ

使用方法

基本的な使い方

次のタスクを実行してください

または

tasks.mdのタスクを進めてください

複数タスクの実行

tasks.mdのすべてのTODOタスクを実行してください

タスクの実行フロー

docs/tasks.mdを読み取り、TODO状態のタスクを特定
依存関係を確認し、実行可能なタスクを決定
並列実行可能なタスクをグループ化
サブエージェントを起動してタスクを実行
タスク完了後、コミットを作成
tasks.mdを更新して完了をマーク
次のタスクへ進む

tasks.mdの形式

このスキルは、sdd-docsスキルで作成されたtasks.mdファイルを想定しています：

#### タスク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の更新

タスク完了後、以下のように更新されます：

#### タスク1.1: ユーザー認証APIエンドポイントの実装

**説明**: [元の説明]
**受入基準**: [元の受入基準]
**ステータス**: `DONE`
**完了サマリー**: login/logoutエンドポイントをJWT認証で実装、すべてのテスト通過

並列実行

依存関係のないタスクは自動的に並列実行されます：

以下のタスクを並列実行します：

- Task 1.1: ユーザー認証APIエンドポイントの実装
- Task 1.2: データモデルの定義
- Task 1.3: 設定ファイルの作成

実行を開始してよろしいですか？

制約事項

以下の場合は自動実行を行わず、ユーザーに確認を求めます：

タスクの説明が曖昧で、実装方法が複数考えられる場合
本番環境への直接的な変更など、リスクの高い操作
技術選択やアーキテクチャの決定が必要な場合

絵文字の使用禁止

このスキルでは、すべてのメッセージ、コミットメッセージ、ドキュメント更新において絵文字を使用しません。クリーンで読みやすいテキストコミュニケーションを維持します。

ベストプラクティス

tasks.mdの作成

tasks.mdは、sdd-docsスキルを使用して作成することを推奨します：

requirements.mdで要件を定義
design.mdで設計を文書化
tasks.mdでタスクに分解
task-executorスキルで実行

タスクの粒度

各タスクは以下の粒度が推奨されます：

サブエージェント1回の実行で完了できる範囲
20-90分程度の作業量
明確な受入基準を持つ

受入基準の具体化

受入基準は検証可能な形で記載してください：

**受入基準**:
- [ ] 特定のファイルが存在する
- [ ] すべてのテストが通過する
- [ ] ESLintエラーがゼロ

トラブルシューティング

タスクが並列実行されない

原因: 依存関係が設定されている

解決: tasks.mdの依存関係フィールドを確認し、不要な依存関係を削除

サブエージェントがタスクを完了できない

原因: タスクの説明が不十分

解決: tasks.mdのタスク説明を詳細化し、以下を含める：

実装すべきファイルパス
使用する技術やライブラリ
具体的な実装手順
技術的文脈

ライセンス

このスキルはMITライセンスの下で公開されています。

5.6 KiB Raw Blame History Unescape Escape