146 lines
7.1 KiB
Markdown
146 lines
7.1 KiB
Markdown
---
|
||
description: TDD開発の要件整理を行います。機能要件を明確化し、テスト駆動開発のための準備を行います。
|
||
---
|
||
あなたは開発の要件整理担当者です。TASKから必要な情報を集めて必要な機能を網羅的に整理してください。
|
||
|
||
# TDD要件定義・機能仕様の整理
|
||
|
||
TDD開発を始めます。以下の機能について要件を整理してください：
|
||
|
||
**【機能名】**: {{feature_name}}
|
||
|
||
## 事前準備
|
||
|
||
開発コンテキストの準備を行います：
|
||
|
||
1. **追加ルールの読み込み**
|
||
- `docs/rule` ディレクトリが存在する場合は読み込み
|
||
- `docs/rule/tdd` ディレクトリが存在する場合は読み込み
|
||
- `docs/rule/tdd/requirements` ディレクトリが存在する場合は読み込み
|
||
- 各ディレクトリ内のすべてのファイルを読み込み、追加ルールとして適用
|
||
|
||
2. **技術スタック定義の読み込み**
|
||
- `docs/tech-stack.md` が存在する場合は読み込み
|
||
- 存在しない場合は `CLAUDE.md` から技術スタックセクションを読み込み
|
||
- どちらも存在しない場合は `.claude/commands/tech-stack.md` のデフォルト定義を使用
|
||
|
||
3. **@agent-symbol-searcher で機能関連情報を検索し、見つかったファイルを読み込み**
|
||
- 読み込んだ技術スタック定義に基づいて関連ファイルを検索
|
||
- 関連する既存機能・コンポーネントを検索し、該当ファイルをReadツールで読み込み
|
||
- 類似した実装パターンやアーキテクチャを特定し、設計文書をReadツールで読み込み
|
||
- 既存のインターフェースやAPI仕様を確認し、関連ファイルをReadツールで読み込み
|
||
|
||
4. **関連ファイルを直接読み込み**
|
||
- `docs/implements/{要件名}/{{task_id}}/{feature_name}-memo.md` - 既存の開発履歴を確認
|
||
- `docs/implements/{要件名}/{{task_id}}/{feature_name}-requirements.md` - 既存の要件定義を確認
|
||
- `docs/implements/{要件名}/{{task_id}}/{feature_name}-testcases.md` - 既存のテストケースを確認
|
||
- 関連する設計文書やタスクファイルも必要に応じて読み込み
|
||
|
||
読み込み完了後、準備されたコンテキスト情報を基にTDD要件定義の作業を開始します。
|
||
|
||
## TDD用要件整理フォーマット
|
||
|
||
**【信頼性レベル指示】**:
|
||
各項目について、元の資料（EARS要件定義書・設計文書含む）との照合状況を以下の信号でコメントしてください：
|
||
|
||
- 🔵 **青信号**: EARS要件定義書・設計文書を参考にしてほぼ推測していない場合
|
||
- 🟡 **黄信号**: EARS要件定義書・設計文書から妥当な推測の場合
|
||
- 🔴 **赤信号**: EARS要件定義書・設計文書にない推測の場合
|
||
|
||
## 1. 機能の概要（EARS要件定義書・設計文書ベース）
|
||
|
||
- 🔵🟡🔴 各項目の信頼性レベルを記載
|
||
- 何をする機能か（ユーザストーリーから抽出）
|
||
- どのような問題を解決するか（As a / So that から抽出）
|
||
- 想定されるユーザー（As a から抽出）
|
||
- システム内での位置づけ（アーキテクチャ設計から抽出）
|
||
- **参照したEARS要件**: [具体的な要件ID]
|
||
- **参照した設計文書**: [architecture.md の該当セクション]
|
||
|
||
## 2. 入力・出力の仕様（EARS機能要件・TypeScript型定義ベース）
|
||
|
||
- 🔵🟡🔴 各項目の信頼性レベルを記載
|
||
- 入力パラメータ（型、範囲、制約）- interfaces.tsから抽出
|
||
- 出力値（型、形式、例）- interfaces.tsから抽出
|
||
- 入出力の関係性
|
||
- データフロー（dataflow.mdから抽出）
|
||
- **参照したEARS要件**: [具体的なREQ-XXX]
|
||
- **参照した設計文書**: [interfaces.ts の該当インターフェース]
|
||
|
||
## 3. 制約条件（EARS非機能要件・アーキテクチャ設計ベース）
|
||
|
||
- 🔵🟡🔴 各項目の信頼性レベルを記載
|
||
- パフォーマンス要件（NFR-XXXから抽出）
|
||
- セキュリティ要件（NFR-XXXから抽出）
|
||
- 互換性要件（REQ-XXX MUSTから抽出）
|
||
- アーキテクチャ制約（architecture.mdから抽出）
|
||
- データベース制約（database-schema.sqlから抽出）
|
||
- API制約（api-endpoints.mdから抽出）
|
||
- **参照したEARS要件**: [具体的なNFR-XXX, REQ-XXX]
|
||
- **参照した設計文書**: [architecture.md, database-schema.sql等の該当セクション]
|
||
|
||
## 4. 想定される使用例（EARSEdgeケース・データフローベース）
|
||
|
||
- 🔵🟡🔴 各項目の信頼性レベルを記載
|
||
- 基本的な使用パターン（通常要件REQ-XXXから抽出）
|
||
- データフロー（dataflow.mdから抽出）
|
||
- エッジケース（EDGE-XXXから抽出）
|
||
- エラーケース（EDGE-XXXエラー処理から抽出）
|
||
- **参照したEARS要件**: [具体的なEDGE-XXX]
|
||
- **参照した設計文書**: [dataflow.md の該当フロー図]
|
||
|
||
## 5. EARS要件・設計文書との対応関係
|
||
|
||
既存のEARS要件定義書・設計文書を参照した場合、以下の対応関係を明記してください：
|
||
|
||
- **参照したユーザストーリー**: [ストーリー名]
|
||
- **参照した機能要件**: [REQ-001, REQ-002, ...]
|
||
- **参照した非機能要件**: [NFR-001, NFR-101, ...]
|
||
- **参照したEdgeケース**: [EDGE-001, EDGE-101, ...]
|
||
- **参照した受け入れ基準**: [具体的なテスト項目]
|
||
- **参照した設計文書**:
|
||
- **アーキテクチャ**: [architecture.md の該当セクション]
|
||
- **データフロー**: [dataflow.md の該当フロー図]
|
||
- **型定義**: [interfaces.ts の該当インターフェース]
|
||
- **データベース**: [database-schema.sql の該当テーブル]
|
||
- **API仕様**: [api-endpoints.md の該当エンドポイント]
|
||
|
||
整理後、以下を実行してください：
|
||
|
||
1. 要件定義書を `docs/implements/{要件名}/{{task_id}}/{feature_name}-requirements.md` に保存（既存ファイルがある場合は追記）
|
||
2. TODOステータスを更新（要件定義完了をマーク）
|
||
3. **品質判定**: 要件の品質を以下の基準で判定
|
||
- 要件が明確で曖昧さがない
|
||
- 入出力仕様が具体的に定義されている
|
||
- 制約条件が明確
|
||
- 実装可能性が確実
|
||
4. **次のステップ表示**: 判定結果に関わらず、次のお勧めコマンドを表示
|
||
- 「次のお勧めステップ: `/tdd-testcases` でテストケースの洗い出しを行います。」
|
||
|
||
## 品質判定基準
|
||
|
||
```
|
||
✅ 高品質:
|
||
- 要件の曖昧さ: なし
|
||
- 入出力定義: 完全
|
||
- 制約条件: 明確
|
||
- 実装可能性: 確実
|
||
|
||
⚠️ 要改善:
|
||
- 要件に曖昧な部分がある
|
||
- 入出力の詳細が不明確
|
||
- 技術的制約が不明
|
||
- ユーザー意図の確認が必要
|
||
```
|
||
|
||
## TODO更新パターン
|
||
|
||
```
|
||
- 現在のTODOを「completed」にマーク
|
||
- 要件定義フェーズの完了をTODO内容に反映
|
||
- 次のフェーズ「テストケース洗い出し」をTODOに追加
|
||
- 品質判定結果をTODO内容に記録
|
||
```
|
||
|
||
次のステップ: `/tdd-testcases` でテストケースの洗い出しを行います。
|