Initial commit
This commit is contained in:
185
skills/sdd-docs/assets/templates/tasks_template_ja.md
Normal file
185
skills/sdd-docs/assets/templates/tasks_template_ja.md
Normal file
@@ -0,0 +1,185 @@
|
||||
# タスク
|
||||
|
||||
> このドキュメントはAIエージェント(Claude Code等)が実装を行うことを前提としています。
|
||||
> タスクは具体的なファイルパス、技術仕様、検証可能な受入基準を含めて記載してください。
|
||||
|
||||
## 実装計画
|
||||
|
||||
### フェーズ1: 基盤構築
|
||||
*推定期間: X分(AIエージェント作業時間)*
|
||||
|
||||
#### タスク1.1: [タスクタイトル]
|
||||
**説明**:
|
||||
*AIエージェントが実装すべき内容を具体的に記載*
|
||||
- 対象ファイルパス
|
||||
- 実装する機能の詳細
|
||||
- 使用する技術・ライブラリ
|
||||
|
||||
**技術的文脈**:
|
||||
*AIエージェントの判断に必要な情報*
|
||||
- 技術スタック
|
||||
- 参照すべき既存コード
|
||||
- コーディング規約
|
||||
|
||||
**受入基準**:
|
||||
- [ ] *検証可能な基準(ファイル存在、機能動作、テスト通過など)*
|
||||
- [ ] *検証可能な基準*
|
||||
|
||||
**依存関係**: なし
|
||||
**推定工数**: X分(AIエージェント作業時間)
|
||||
**ステータス**: `TODO`
|
||||
|
||||
#### タスク1.2: [タスクタイトル]
|
||||
**説明**:
|
||||
*AIエージェントが実装すべき内容を具体的に記載*
|
||||
- 対象ファイルパス
|
||||
- 実装する機能の詳細
|
||||
- 使用する技術・ライブラリ
|
||||
|
||||
**技術的文脈**:
|
||||
*AIエージェントの判断に必要な情報*
|
||||
|
||||
**受入基準**:
|
||||
- [ ] *検証可能な基準*
|
||||
- [ ] *検証可能な基準*
|
||||
|
||||
**依存関係**: タスク1.1
|
||||
**推定工数**: X分(AIエージェント作業時間)
|
||||
**ステータス**: `TODO`
|
||||
|
||||
### フェーズ2: コア機能
|
||||
*推定期間: X分(AIエージェント作業時間)*
|
||||
|
||||
#### タスク2.1: [タスクタイトル]
|
||||
**説明**:
|
||||
*AIエージェントが実装すべき内容を具体的に記載*
|
||||
|
||||
**技術的文脈**:
|
||||
*AIエージェントの判断に必要な情報*
|
||||
|
||||
**受入基準**:
|
||||
- [ ] *検証可能な基準*
|
||||
- [ ] *検証可能な基準*
|
||||
|
||||
**依存関係**: フェーズ1
|
||||
**推定工数**: X分(AIエージェント作業時間)
|
||||
**ステータス**: `TODO`
|
||||
|
||||
#### タスク2.2: [タスクタイトル]
|
||||
**説明**:
|
||||
*AIエージェントが実装すべき内容を具体的に記載*
|
||||
|
||||
**技術的文脈**:
|
||||
*AIエージェントの判断に必要な情報*
|
||||
|
||||
**受入基準**:
|
||||
- [ ] *検証可能な基準*
|
||||
- [ ] *検証可能な基準*
|
||||
|
||||
**依存関係**: タスク2.1
|
||||
**推定工数**: X分(AIエージェント作業時間)
|
||||
**ステータス**: `TODO`
|
||||
|
||||
### フェーズ3: 統合とテスト
|
||||
*推定期間: X分(AIエージェント作業時間)*
|
||||
|
||||
#### タスク3.1: [タスクタイトル]
|
||||
**説明**:
|
||||
*AIエージェントが実装すべき内容を具体的に記載*
|
||||
|
||||
**技術的文脈**:
|
||||
*AIエージェントの判断に必要な情報*
|
||||
|
||||
**受入基準**:
|
||||
- [ ] *検証可能な基準*
|
||||
- [ ] *検証可能な基準*
|
||||
|
||||
**依存関係**: フェーズ2
|
||||
**推定工数**: X分(AIエージェント作業時間)
|
||||
**ステータス**: `TODO`
|
||||
|
||||
## タスクステータスの凡例
|
||||
- `TODO` - 未着手
|
||||
- `IN_PROGRESS` - 作業中
|
||||
- `BLOCKED` - 依存関係や問題によりブロック中
|
||||
- `REVIEW` - レビュー待ち
|
||||
- `DONE` - 完了
|
||||
|
||||
## リスクと軽減策
|
||||
|
||||
### リスク1: [リスクの説明]
|
||||
**影響度**: 高/中/低
|
||||
**発生確率**: 高/中/低
|
||||
**軽減策**: *このリスクへの対処方法*
|
||||
|
||||
### リスク2: [リスクの説明]
|
||||
**影響度**: 高/中/低
|
||||
**発生確率**: 高/中/低
|
||||
**軽減策**: *このリスクへの対処方法*
|
||||
|
||||
## 備考
|
||||
*実装に関する追加の注意事項や考慮事項*
|
||||
|
||||
---
|
||||
|
||||
## タスク管理のガイド
|
||||
|
||||
### AIエージェント向けタスクの粒度
|
||||
適切なタスクサイズの目安(AIエージェント作業時間):
|
||||
- **シンプルな実装**: 10-20分(単一ファイル、基本的な関数、設定ファイル)
|
||||
- **標準的な実装**: 20-40分(複数ファイル、APIエンドポイント、データモデル、基本テスト)
|
||||
- **複雑な実装**: 40-90分(複数コンポーネント統合、複雑なロジック、包括的テスト)
|
||||
- **非常に複雑**: 90分以上 → さらに分解を検討
|
||||
|
||||
### AIエージェント向け良いタスク定義の特徴
|
||||
1. **具体的**: ファイルパス、関数名、クラス名を明記
|
||||
2. **測定可能**: 検証可能な受入基準(テスト通過、ファイル存在など)
|
||||
3. **達成可能**: AIエージェントが実行可能な粒度
|
||||
4. **文脈提供**: 技術スタック、参照コード、コーディング規約を明記
|
||||
5. **期限付き**: AIエージェント作業時間の見積もりを明記
|
||||
|
||||
### AIエージェント向け受入基準の書き方
|
||||
- チェックボックス形式で記載
|
||||
- AIエージェントが検証可能な基準(ファイル存在、テスト通過、エラーゼロなど)
|
||||
- 具体的なファイルパスやコマンドを含める
|
||||
- 技術的に測定可能な条件を明記
|
||||
|
||||
### 依存関係の管理
|
||||
- **前提タスク**: このタスクの開始前に完了が必要
|
||||
- **並行可能**: 同時に進められるタスク
|
||||
- **後続タスク**: このタスクの完了後に開始可能
|
||||
|
||||
### ステータス遷移のルール
|
||||
```
|
||||
TODO → IN_PROGRESS → REVIEW → DONE
|
||||
↓
|
||||
BLOCKED
|
||||
↓
|
||||
IN_PROGRESS
|
||||
```
|
||||
|
||||
### フェーズ分けの考え方
|
||||
1. **基盤構築**: 環境設定、基本構造
|
||||
2. **コア機能**: 主要な機能の実装
|
||||
3. **拡張機能**: 追加機能、改善
|
||||
4. **統合・テスト**: 結合、品質保証
|
||||
5. **リリース準備**: デプロイ、文書化
|
||||
|
||||
### リスク評価のマトリクス
|
||||
| | 低影響 | 中影響 | 高影響 |
|
||||
|---|--------|--------|--------|
|
||||
| **高確率** | 注意 | 対策必要 | 最優先対応 |
|
||||
| **中確率** | 監視 | 注意 | 対策必要 |
|
||||
| **低確率** | 受容 | 監視 | 注意 |
|
||||
|
||||
### AIエージェント作業時間の見積もり
|
||||
- 基本的な実装: 楽観的見積もり × 1.2-1.5
|
||||
- 不確実性が高い場合: × 1.5-2.0
|
||||
- 新しいライブラリや複雑な統合: × 2.0-2.5
|
||||
- AIエージェントの能力範囲内のタスクに限定すること
|
||||
|
||||
### 進捗管理のヒント
|
||||
- 毎日ステータスを更新
|
||||
- ブロッカーは即座に報告
|
||||
- 見積もりと実績の差を記録
|
||||
- 振り返りで改善点を特定
|
||||
Reference in New Issue
Block a user