Review Archive

---
name: review-archive
description: '將已完成的人工檢查項目從 tasks artifact 遷移到 docs/manual-review-archive.md，保留追溯資訊。'
---
<!-- 🔒 LOCKED — managed by clade · auto-generated by sync-to-agents; edit source in .claude/ then re-run sync -->

# 人工檢查歸檔（Review Archive）

將已完成（`[x]`）的人工檢查項目從 tasks artifact 遷移到歸檔檔案。

## 觸發時機

- 使用者說「歸檔檢查」「archive review」「#1~#3 做完了」
- Spectra change 歸檔前，整理人工檢查結果

## 輸入

- 可指定範圍：`/review-archive #1~#5` 或 `/review-archive all`
- 未指定範圍時，遷移所有 `[x]` 項目

## 流程

### Step 1: 定位 tasks artifact

```bash
spectra list --json
```

讀取目前 change 的 tasks artifact，找到 `## 人工檢查` 區塊。

### Step 2: 識別要歸檔的項目

- 如果使用者指定範圍（如 `#1~#3`）→ 取該範圍的項目
- 如果使用者說 `all` → 取所有項目
- 未指定 → 只取 `[x]` 已完成的項目
- 如果指定的項目尚未勾選 `[x]`，用 request_user_input 確認是否要標記完成並歸檔

### Step 3: 寫入歸檔

讀取 `docs/manual-review-archive.md`，在 `---` 分隔線後插入新區塊（最新的在最上面）：

```markdown
## YYYY-MM-DD — `<change-name>`

> Specs: `<spec-1>`, `<spec-2>`

- [x] #1 實際操作功能，確認 happy path 正常運作
- [x] #2 測試 edge case — ⚠️ 空資料時缺少提示（已修）
- [x] #3 確認手機/平板響應式顯示正常
```

- 保留每個項目的 `#N` 編號
- 如果項目有附註（如截圖報告中的觀察），一併帶入
- 截圖檔案路徑不寫入歸檔（截圖在 screenshots/local/ 可能被清除）

### Step 4: 更新 tasks artifact

已歸檔的項目在 tasks artifact 中保持 `[x]`，不刪除。
如果所有項目都歸檔了，在區塊末尾加一行：

```markdown
> ✅ 全部歸檔於 YYYY-MM-DD → docs/manual-review-archive.md
```

### Step 5: 回報

```
已歸檔 N 項人工檢查到 docs/manual-review-archive.md：
- #1 實際操作功能 ✅
- #2 edge case ✅
- #3 響應式 ✅
```

回報後**自動**進入 Step 6 sweep 截圖；sweep 完成後合併回報尾巴附 sweep 結果（由 `screenshots-archive` skill 自己印出，不重複格式化）。

### Step 6: 自動 sweep 截圖

歸檔完成後**自動**用 Skill tool 呼叫 `screenshots-archive change <change-name>`，把對應截圖資料夾搬到 `screenshots/<env>/_archive/YYYY-MM/`。

**不再 prompt 是否要做** — review-archive 完成 = 該 change 已寫入 `docs/manual-review-archive.md` = sweep 對齊條件 100% 滿足，沒有人為再決定一次的空間。

**對齊失敗處理**（極少見：topic 名與 change 名不一致）：由 `screenshots-archive` 內部用 request_user_input 列頂層所有候選 topic 讓 user 手選 + 「跳過」選項，本 skill 不重複 prompt。

**例外旗標**：user 在觸發 review-archive 時若明確說「不要 sweep 截圖」/「`--no-sweep`」，跳過此步並在 Step 5 回報結尾附註「screenshot sweep 已跳過（user 指示）」。

**目的**：讓 `screenshots/<env>/` 頂層只剩 current pending review，user 一眼能找到「現在要做人工檢查的是哪個」。

## Guardrails

- **NEVER** 刪除 tasks artifact 中的人工檢查項目 — 只標記 `[x]` 和加歸檔註記
- **NEVER** 歸檔未確認的項目 — 除非使用者明確同意
- **NEVER** 把 Step 6 退回成「prompt 提示 user 要不要 sweep」— 已固化為自動執行；想跳過走明確的 `--no-sweep` 例外旗標
- **ALWAYS** 保留 `#N` 編號和來源追溯資訊
- **ALWAYS** 在歸檔前確認 `docs/manual-review-archive.md` 存在
- **ALWAYS** 在 Step 5 回報後自動觸發 Step 6 截圖 sweep，除非 user 明確 `--no-sweep`