review-screenshot

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 應：

1. 向使用者展示摘要表格（通過/需確認/有問題）
2. 列出需要人工確認的項目及截圖路徑
3. 報告檔位置：screenshots/<env>/<語義>/review.md（路徑規則見 rule）

注意事項

• Verify mode 由主線直派 codex GPT-5.5 low；ad-hoc 截圖由 sonnet subagent 自己執行（subagent NEVER 呼叫 codex CLI）
• 主 session 不需要自己跑截圖命令
• 主 session 不需要決定用哪個工具 — agent 依 rule 判斷