Review Screenshot

---
name: review-screenshot
description: '統一截圖入口。Use when 使用者要求截圖驗證 UI 畫面，或要跑 UI 檢查清單。NOT for 把既有截圖 sweep 進 _archive/（走 screenshots-archive），NOT for Lighthouse 稽核或 performance trace 拆解（走 chrome-devtools-mcp）。'
permission_tier: read-only
---
<!-- 🔒 LOCKED — managed by clade · auto-generated by sync-to-cursor; edit source in .claude/ then re-run sync -->

# 截圖（統一入口）

所有截圖工作一律派 `screenshot-review` **Claude subagent**（`Agent` tool，四模式共用；見 § Runtime 分流）。**NEVER** 在主 session 直接跑 `agent-browser` / `curl dev server` / `mkdir screenshots/` 等截圖命令。

工具選擇規則見 `.cursor/rules/screenshot-strategy.mdc` — agent 會自行判斷，主 session 不需指定。

## Runtime 分流

**四個模式共用同一條路徑**：`[verify:ui]` channel、archive 前 QA、commit 0-B、ad-hoc 截圖，
一律派 `screenshot-review` **Claude subagent**（`Agent` tool，`subagent_type: screenshot-review`）。

**Cursor runtime**：本 channel 的 Claude subagent 是 AI Agent `Agent` tool，**NEVER** 改用 Cursor Task 的 `model=claude-*`。Pi 已 fail-closed。改走 [[agent-routing]] § Cursor runtime 主線 residency 的 Herdr create-only `--launcher cc`／`ccw`。

**本 channel NEVER 外派給 Pi 任一 model**——`grok-xai` / `grok-cursor` / `astra` / `gemini` / `luna`
一律不准，`pi-dispatch-screenshot-verify.ts` 已 fail-closed 拒跑，
`pi-routing-policy.ts` 對 `--table-row screenshot-review-verify` 直接 throw。
2026-08-22 Charles 拍板，理由見 [[review-gui-surface]] § 為什麼只准 Claude subagent。

**NEVER** 因為「這次只是 ad-hoc、輸出不是 gate」而改派——carrier 是同一個，模式差別只在
輸出是不是 gate（verify / archive / 0-B 三個是，ad-hoc 不是）。

**警訊**（subagent 沒在做自己的工作）：subagent 的 tool call 出現 `pi` / `pi-dispatch` /
`codex` → 它把自己當成路由器了，**MUST** 立刻打斷。本 agent 是執行體，不轉派給任何人
（成因見 [[pitfall-screenshot-review-sonnet-wrapper-self-rationalize]]）。

## Brief 注意事項

- Brief **NEVER** 寫 `[DELEGATED-BY-CLAUDE-CODE]`——那是 Pi 派工的 marker，本 channel 不派 Pi。
- Brief 結構（Setup / Items / Output format）跟誰執行**無關**。

## 觸發時機

- 「截圖」「看畫面」「幫我看 UI」「看一下頁面」
- 「review screenshot」「跑檢查清單」「截圖檢查」
- UI 實作後確認、除錯截圖
- Spectra workflow 完成後視覺驗收

## 派遣方式

四個模式共用同一條：`Agent` tool，`subagent_type: screenshot-review`，brief 直接放在
`prompt` 參數（不落檔——in-process subagent 的 brief 是 prompt 字串，per
[[agent-routing]] § Dispatch 資料邊界）。

主線收到 subagent 回報後只消費它的 JSON 摘要，**NEVER** 逐張 `Read` 截圖
（例外路徑見 [[review-gui-surface]] § 截圖 evidence 一律走 Claude subagent 的表）。
下面三段是 brief 的 prompt 本體素材。

### 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）

### 可採性判準（把任何一張圖當證據之前，逐張套）

任一條成立即標 **NON-EVIDENCE**，**NEVER** 列入驗收證據：

1. 畫面為空資料狀態，而被驗行為不是「空狀態分支本身」
2. 被驗行為就是空狀態分支，但拿不出同頁、同 session 產出的**非空對照圖**（證明「空」不是該身分下的預設長相）
3. 依 brief / baseline 可知改動**前**同條件下畫面相同
4. 畫面資料列數低於該 entity 的 seed plan 最小列數
5. 圖中實際渲染的分支與被驗行為不同

agent 交回的 manifest 已含 `discriminating` 欄，但**主線 MUST 自行覆核**——2026-08-19 實測失敗的正是這一段：agent 誠實揭露了「不能當驗收證據」「403 完全截不到」，主線在壓縮成拍板選項時把但書丟了，據零鑑別力的圖 land。

**Hard rule**：任何一項被標 NON-EVIDENCE 或 UNREACHABLE 時，主線**在同一段訊息內** MUST 把該標記與理由講給使用者，**NEVER** 只呈報通過項就請人拍板。UNREACHABLE 的「不可達」本身是 finding，要一起報。

通則見 `rules/core/agent-self-verification.md` § 證據鑑別力；實證見 [[pitfall-empty-state-screenshot-has-no-discriminating-power]]。

## 注意事項

- **四個模式**（verify / archive QA / commit 0-B / ad-hoc）一律由主線直派 `screenshot-review` Claude subagent（`Agent` tool，`subagent_type: screenshot-review`）；**NEVER** 派 Pi 任一 model，也 **NEVER** 讓 subagent 再轉派
- 主 session **不需要**自己跑截圖命令
- 主 session **不需要**決定用哪個工具 — agent 依 rule 判斷