sprint-review-preplisted
Install: claude install-skill ryokkon624/scrum-agent-base
# Sprint Review Prep
**生成したHTMLの出力先:** `backlog/sprint_{N}/review-#{Issue番号}.html`
---
## テンプレートの選択
IssueのラベルによってテンプレートHTMLを使い分ける。
| ラベル | テンプレート |
|---|---|
| `feature` / `refactor` | [templates/feature-refactor.html](templates/feature-refactor.html) |
| `bug` | [templates/bug.html](templates/bug.html) |
どちらのテンプレートも **CSSはすべてinline** にすること。外部CSSファイルを参照しない(ファイルを移動・共有しても壊れないようにするため)。
---
## 実行手順
### Step 1: 情報収集
以下を必ず読んでから生成する。
1. **GitHub Issue本文** — `github-issues` スキル参照。ACの内容・原因・改修方針を確認する
2. **実装ブランチのdiff** — `git diff main...HEAD` で変更ファイルと差分を確認する
3. **変更した各ファイル** — Readツールで実際のコードを読む(行番号を正確に使うため)
4. **`backlog/sprint_{N}/implementation-notes.md`** — DEVが実装中に記録した仕様外の判断・変更・妥協点。ファイルが存在しない場合は「記録なし」としてスキップする
### Step 2: テンプレートを読む
選択したテンプレートHTMLをReadツールで読み、セクション構成とCSSを把握する。
### Step 3: HTML生成
テンプレートを元に、実際のIssueとコードの内容を埋め込んでHTMLを生成する。
**テンプレートのコピーではなく、内容を実際の情報で置き換えた新しいHTMLを生成すること。**
---
## feature/refactor テンプレートのセクション構成
| セクション | 内容 |
|---|---|
| なぜこの改修が必要だったか | 問題ボックス + 改修前後のアーキテクチャ比較 |
| AC別 実装内容 | 各ACにチェックマーク・変更ファイル名・diff・解説注釈 |
| 実装メモ(仕様外の判断・変更・妥協点) | `implementation-notes.md` の内容。記録なしの場合はセクション自体を省略する |
| 動作確認ポイント | ユーザーが何を確認するか、番号付きリスト |
| 改修スコープ確認 | 変更したファイル・していないファイルの一覧 |
### diffの書き方
- 行番号は実際のファイルの行番号を使う(テンプレートの番号をそのまま使わない)
- 変更前後の行が明確になるように `+` / `-` プレフィックスをつける
- 変更に関係ない行はコンテキストとして数行だけ表示する
- 解説注釈(annotationボックス)には「なぜこう変えたか」を書く
---
## bug テンプレートのセクション構成
| セクション | 内容 |
|---|---|
| 発生事象 | Before/After のUIモック(実際の画面イメージ) |
| 原因分析 | 根本原因・ミスマッチ表・コード特定箇所