review-archive

name	review-archive
description	將已完成的人工檢查項目從 tasks artifact 遷移到 docs/manual-review-archive.md，保留追溯資訊。Use when 人工檢查完成後要歸檔 review 結果、使用者說「歸檔 review」「archive review」。

人工檢查歸檔（Review Archive）

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

觸發時機

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

輸入

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

流程

Step 1: 定位 tasks artifact

spectra list --json

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

Step 2: 識別要歸檔的項目

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

Step 3: 寫入歸檔

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

## 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]，不刪除。 如果所有項目都歸檔了，在區塊末尾加一行：

> ✅ 全部歸檔於 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