| name | review-screenshot |
| description | 統一截圖入口，派遣 screenshot-review agent（Sonnet）執行。Use when 使用者說「截圖」「看畫面」「確認 UI」「看一下頁面」「幫我看 UI」「review screenshot」「跑檢查清單」。 |
截圖（統一入口）
所有截圖工作派遣 screenshot-review agent（sonnet wrapper）。MUST 使用 spawn_agent 工具 派遣，NEVER 在主 session 直接跑 agent-browser / curl dev server / mkdir screenshots/ 等截圖命令。
工具選擇規則見 .claude/rules/screenshot-strategy.md — agent 會自行判斷，主 session 不需指定。
Runtime 分流
| 模式 | 由誰執行 | Dispatch 方式 |
|---|
verify mode（[verify:ui] / archive 前 QA） | Codex GPT-5.5 low | 主線直接 Bash run_in_background（per agent-routing.md Routing Table；NEVER 透過 spawn_agent 工具 / sonnet wrapper） |
| ad-hoc 截圖（使用者說「截圖」「看畫面」等） | Sonnet subagent 自己執行 | 主線用 spawn_agent 工具 派 screenshot-review sonnet wrapper；sonnet 直接做工作（NEVER 在 subagent 內呼叫 codex CLI） |
| sonnet fallback（codex 不可用的 verify mode） | Sonnet subagent 自己執行 | 主線偵測 codex 不可用後 fallback 到 spawn_agent 工具 |
Hard rule（per agent-routing.md § Dispatch 入口）：subagent NEVER 在其 sandbox 內呼叫 codex CLI。Codex 一律由主線直接 Bash 派工。
警訊（subagent 跳過 Step 0 直接做工作）：subagent 第一個 tool call 不是 identity check 而是 agent-browser / curl / mkdir screenshots/ → 違反 agent body hard rule，MUST 立刻打斷讓 agent 重來。
Brief 注意事項
- Brief NEVER 在第一行寫
[DELEGATED-BY-CLAUDE-CODE] — 那是主線直派 codex 的 marker，派 Claude subagent 不該帶。寫了會讓 sonnet 誤判身份跳過 agent body。
- Brief 結構（Setup / Items / Output format）跟誰執行無關 — 結構像 delegated 不代表你應該寫 marker。
觸發時機
- 「截圖」「看畫面」「幫我看 UI」「看一下頁面」
- 「review screenshot」「跑檢查清單」「截圖檢查」
- UI 實作後確認、除錯截圖
- Spectra workflow 完成後視覺驗收
派遣方式
spawn_agent 工具，agent_type: "screenshot-review"。
Ad-hoc 截圖
prompt: |
截圖驗證以下頁面：
1. /path/to/page — 頁面描述
2. /path/to/page2 — 頁面描述
Dev server port: <port>（若已知）
Review 截圖（Spectra 人工檢查）
prompt: |
針對 change `<change-name>` 的人工檢查清單逐項截圖驗證：
## 人工檢查
- [ ] #1 實際操作功能，確認 happy path 正常運作
- [ ] #2 測試 edge case...
Dev server port: <port>（若已知）
除錯截圖
prompt: |
除錯截圖：頁面 /path 出現 [問題描述]，需要截圖確認目前狀態。
Dev server port: <port>（若已知）
結果處理
Agent 回傳後，主 session 應：
- 向使用者展示摘要表格（通過/需確認/有問題）
- 列出需要人工確認的項目及截圖路徑
- 報告檔位置：
screenshots/<env>/<語義>/review.md（路徑規則見 rule）
注意事項
- Verify mode 由主線直派 codex GPT-5.5 low；ad-hoc 截圖由 sonnet subagent 自己執行（subagent NEVER 呼叫 codex CLI）
- 主 session 不需要自己跑截圖命令
- 主 session 不需要決定用哪個工具 — agent 依 rule 判斷
