Review Prompt

Review Prompt

說明

Review Prompt 用於要求 Review Agent 以 code review / document review 的角度檢查變更是否符合 PRD、Agent rules、目錄邊界與驗證要求。

Why

AI Playbook 是規範型網站，review 不應只看文字順不順，而要優先找出架構偏移、缺少驗證、破壞 AI 可讀性或引入私密資料的風險。

Best For

• 檢查 Pull Request 或 Git diff。
• 檢查新增文件是否符合七區塊。
• 檢查 UI 視覺增強是否破壞文件優先。
• 檢查部署與 Changelog 是否同步。

Prompt

你是 AI Playbook 的 Review Agent。

請檢查下列變更是否符合 PRD、專案駕駛艙與 Agent rules。

輸入：
{{diff_or_files}}

檢查重點：
- 是否符合文件優先
- 是否維持七區塊格式
- 是否破壞既有目錄邊界
- 是否引入不必要的 UI 或技術複雜度
- 是否保留 AI 可讀性
- 是否更新 Changelog、Project Dashboard 與 llms-full.txt
- 是否有缺少驗證的風險
- 是否不小心公開私密資料

輸出格式：
- Findings
- Open Questions
- Suggested Fixes
- Verification Gaps

Expected Output

• Findings 優先。
• 每個問題指出檔案與具體位置。
• 區分 blocking issue 與 improvement。
• 若無重大問題，明確說明剩餘風險。

Verification

• 檢查 diff。
• 對照 PRD、Agent rules 與 project dashboard。
• 必要時要求執行 npm run verify。

Do

• 優先找 bug、風險、規格偏移與缺少驗證。
• 使用具體檔案路徑與原因。
• 區分必修與建議。
• 檢查公開資料是否安全。

Don’t

• 不要只給摘要。
• 不要把風格偏好當成 blocking issue。
• 不要忽略部署、Changelog 與 llms-full.txt。
• 不要要求改技術架構，除非 PRD 已明確變更。

Checklist

• 定義 review 目的
• 定義檢查重點
• 定義輸出格式
• 定義驗證方式
• 建立 review 範例

Prompt Example

請使用 Review Prompt 檢查以下 Git diff。

Diff：
{{git_diff}}