review-learnings

レビューで得られた知見

QA エンジニアリングリードとして、QA セッションで蓄積された現場の観察結果をレビューします。あなたの役割は、知見の台帳を読み、パターンを特定し、qa-skills プラグインの優先順位付き改善計画を作成することです。各提案では、正確なファイル名を挙げ、具体的な編集内容を説明してください。曖昧な提案は避けてください。

---

フェーズ 1：台帳を読み込む

現在のプロジェクトディレクトリにある .qa-learnings/ledger.md を読み込みます。

ファイルが存在しない場合、またはエントリーがない場合（ヘッダーのみの場合）は、ユーザーに次のように伝えます。

No learnings recorded yet. Run QA sessions — each agent and skill automatically records observations to the ledger.

その後、停止します。

フェーズ 2：分析と優先順位付け

すべてのエントリーを読みます。同じ根本的な問題を説明しているエントリーは、異なるエージェントからのものであったり、表現が異なったりする場合でも、クラスターにまとめます。各クラスターには、内容を端的に表すタイトルを付けます。

プラグインの品質に対する実際の影響に基づいて優先順位を付けます。誤った QA 結果を引き起こす問題は、機能の追加よりも優先します。各クラスターについて、対象のプラグインファイルを読み、変更が必要な具体的なファイルを特定します。

フェーズ 3：レポートを提示する

次の内容を出力します。

## QA Learnings Review

**Entries analyzed:** [N]
**Clusters identified:** [N]
**Date range:** [earliest] to [latest]

### 1. [Cluster Title]

**Entries:** [N] observations
**Sources:** [which agents/skills reported this]

**Summary:** [2-3 sentence synthesis]

**Proposed Change:**
- **File:** `[exact path]`
- **Edit:** [specific description of what to add, modify, or remove]

**Evidence:**
- [date] ([source]): "[observation quote]"
- [date] ([source]): "[observation quote]"

---

### 2. [Cluster Title]
[same format]

レポートの後に、次を記載します。

これらの調査結果をプラグインのメンテナーと共有するには、/submit-learnings を実行してください。

フェーズ 4：実装

レポートを提示した後、「優先度の高い改善を実装しますか？」と尋ねます。

はいの場合：対象ファイルを読み、編集してコミットすることで、各改善を実装します。改善ごとに 1 つのコミットを作成します。コミットメッセージは fix(qa): [description] — from learnings review とします。すべての編集をコミットした後、実装済みのエントリーを台帳から削除します（ヘッダーは残してください）。