| 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 判斷