- Ver.20260329a
- Claude Code(Model:Opus 4.6)
- .md ファイルの内容は末尾
ステップ1-2: 要件の理解
このドキュメントは実装フローのステップ1-2の詳細手順を説明します。
ステップ1: 要件説明
概要
ユーザーが実装したい内容やバグ修正をClaude Codeに説明する。
Claude Codeの役割
- ユーザーの説明を注意深く聞く
- 不明点があれば質問する
- 要件の全体像を理解する
実施内容
- ユーザーからの要件説明を受ける
- 要件の概要を理解する
- 実装の目的を理解する
- 期待される成果物を理解する
- requirements-analyzer エージェントを使用して、関連する既存コードの調査と影響範囲の分析を行う
ステップ2: 質問と回答の繰り返し
概要
Claude Codeがユーザーに質問し、ユーザーが回答する。要件が明確になるまで繰り返す。
質問すべき項目
機能要件の確認
- この機能の目的は何ですか?
- 誰がこの機能を使いますか?
- どのような場面で使われますか?
- 既存の機能と関連はありますか?
技術要件の確認
- どのファイルを修正する必要がありそうですか?
- 既存のコードを参考にできますか?
- 外部ライブラリが必要ですか?
- パフォーマンスの要件はありますか?
UI/UXの確認(該当する場合)
- ユーザーインターフェースはどうあるべきですか?
- ボタンやダイアログが必要ですか?
- 色や配置の指定はありますか?
テストの確認
- どのようにテストすべきですか?
- 正常系のテストケースは?
- 異常系のテストケースは?
- GUI操作のテストが必要ですか?
優先度とスコープの確認
- 最低限必要な機能は何ですか?
- 将来的に拡張する可能性はありますか?
- 今回のスコープに含めないものは何ですか?
ステップ2完了の基準
以下が全て明確になったら、ステップ3へ進む:
- [ ] 実装する機能の目的が明確
- [ ] 実装の範囲(スコープ)が明確
- [ ] 修正対象のファイルが特定できている(または、候補を列挙し優先度/調査方針に合意)
- [ ] テスト方法が明確
- [ ] 不明点がない(または、実装しながら確認することで合意)
ステップ2完了後の次のアクション
ステップ2が完了したら、ユーザーに以下を確認:
要件の理解が完了しました。
次はステップ3(Redmineチケット説明欄の作成)に進みます。
ステップ3に進んでよろしいですか?
使用するエージェント
- requirements-analyzer: 要件に関連する既存コードを調査し、修正対象ファイルの候補と影響範囲を分析する
注意事項
- 焦って実装を始めない
- 要件が曖昧なまま先に進まない
- ユーザーの期待と自分の理解にズレがないか常に確認
- 質問は遠慮せず、何度でも聞く
# ステップ1-2: 要件の理解
このドキュメントは実装フローのステップ1-2の詳細手順を説明します。
---
## ステップ1: 要件説明
### 概要
ユーザーが実装したい内容やバグ修正をClaude Codeに説明する。
### Claude Codeの役割
- ユーザーの説明を注意深く聞く
- 不明点があれば質問する
- 要件の全体像を理解する
### 実施内容
1. ユーザーからの要件説明を受ける
2. 要件の概要を理解する
3. 実装の目的を理解する
4. 期待される成果物を理解する
5. **requirements-analyzer** エージェントを使用して、関連する既存コードの調査と影響範囲の分析を行う
---
## ステップ2: 質問と回答の繰り返し
### 概要
Claude Codeがユーザーに質問し、ユーザーが回答する。要件が明確になるまで繰り返す。
### 質問すべき項目
#### 機能要件の確認
- この機能の目的は何ですか?
- 誰がこの機能を使いますか?
- どのような場面で使われますか?
- 既存の機能と関連はありますか?
#### 技術要件の確認
- どのファイルを修正する必要がありそうですか?
- 既存のコードを参考にできますか?
- 外部ライブラリが必要ですか?
- パフォーマンスの要件はありますか?
#### UI/UXの確認(該当する場合)
- ユーザーインターフェースはどうあるべきですか?
- ボタンやダイアログが必要ですか?
- 色や配置の指定はありますか?
#### テストの確認
- どのようにテストすべきですか?
- 正常系のテストケースは?
- 異常系のテストケースは?
- GUI操作のテストが必要ですか?
#### 優先度とスコープの確認
- 最低限必要な機能は何ですか?
- 将来的に拡張する可能性はありますか?
- 今回のスコープに含めないものは何ですか?
### ステップ2完了の基準
以下が全て明確になったら、ステップ3へ進む:
- [ ] 実装する機能の目的が明確
- [ ] 実装の範囲(スコープ)が明確
- [ ] 修正対象のファイルが特定できている(または、候補を列挙し優先度/調査方針に合意)
- [ ] テスト方法が明確
- [ ] 不明点がない(または、実装しながら確認することで合意)
---
## ステップ2完了後の次のアクション
ステップ2が完了したら、ユーザーに以下を確認:
```
要件の理解が完了しました。
次はステップ3(Redmineチケット説明欄の作成)に進みます。
ステップ3に進んでよろしいですか?
```
---
## 使用するエージェント
- **requirements-analyzer**: 要件に関連する既存コードを調査し、修正対象ファイルの候補と影響範囲を分析する
## 注意事項
- 焦って実装を始めない
- 要件が曖昧なまま先に進まない
- ユーザーの期待と自分の理解にズレがないか常に確認
- 質問は遠慮せず、何度でも聞く