screenshots-archive

截圖歸檔（Screenshots Archive）

把已完成人工檢查的截圖資料夾從 screenshots/<env>/<topic>/ 搬到 screenshots/<env>/_archive/YYYY-MM/<topic>/，讓 ls screenshots/<env>/（排除 _archive/）= 目前 pending review 清單。

觸發時機

• 「歸檔截圖」「sweep screenshots」「清掉舊的截圖資料夾」
• 「change X 的截圖歸檔」（指定）
• /review-archive 完成後自動呼叫（指定 change 模式）
• 一件工作標 work.done 後自動呼叫（指定 work 模式）

輸入

• 指定 work：/screenshots-archive change <work-slug> → 只搬該工作對應的 topic（review-archive 與收尾流程自動觸發走此模式）
• 指定 topic：/screenshots-archive <topic-name> → 直接搬該 topic（跳過對齊檢查，需 user 確認）
• 未指定：sweep 所有「在 docs/manual-review-archive.md 已收錄」且「screenshots/<env>/<topic>/ 仍存在頂層」的 topic

流程

Step 1: 列出候選 topic

掃所有 environment（不只 local）：

for env in local staging production; do
  [ -d "screenshots/$env" ] || continue
  for d in "screenshots/$env"/*/; do
    [ -d "$d" ] || continue
    name=$(basename "$d")
    [ "$name" = "_archive" ] && continue
    echo "$env|$name"
  done
done

Step 2: 對齊 manual-review-archive

讀取 docs/manual-review-archive.md，抽出每個 ## YYYY-MM-DD — \`` 標題的 change-name 集合。

Mode A — 未指定範圍（sweep all aligned）

對 Step 1 的候選：

• candidate.name ∈ archived_changes → 可 sweep
• candidate.name ∉ archived_changes → 跳過，記錄原因「未在 manual-review-archive 找到對應 change」

候選有跳過項目時，回報「N 個 topic 已對齊可 sweep / M 個 topic 未對齊跳過」，列出跳過清單，不追問是否強制。

Mode B — 指定 work（含 review-archive 與收尾流程自動觸發）

/screenshots-archive change <work-slug>：

1. 跨所有 environment 掃 screenshots/<env>/<work-slug>/ 是否存在

2. 找到對應 topic：直接 sweep（信任 caller — 它已確認該工作結束；不再對齊 manual-review-archive，避免直接收尾的路徑被擋）

3. 找不到對應 topic → 先跑 backend-only 判定，命中就 noop、NEVER 追問：

   # carrier 有兩種形狀，兩處都探
   carrier=$(ls -d specs/plans/*-<work-slug>/tasks.md tasks/*-<work-slug>.md 2>/dev/null | head -1)
   spec=$(dirname "$carrier")/spec.md
   grep -q 'No user-facing journey (backend-only)' "$spec" 2>/dev/null && echo BACKEND_ONLY
   grep -q 'pre-handoff-verdict: intentional, reason: backend-only' "$carrier" 2>/dev/null && echo BACKEND_ONLY
   awk '/^## 人工檢查/{mr=1} mr && /\[review:ui\]/{found=1} END{exit found}' "$carrier" 2>/dev/null && echo BACKEND_ONLY