ashe-li /plan-archive — 歸檔已完成的 Plan
將 plans/active/ 中已完成的 plan 移至 plans/completed/，並補上驗證結果。
Step 1：找出要歸檔的 Plan
如果有傳入引數（檔名或路徑），直接使用。
否則，列出 plans/active/ 下的所有 .md：
ls plans/active/*.md 2>/dev/null
若有多個，依 mtime 排序，問使用者選哪一個。 若只有一個，直接用。 若目錄不存在或空，輸出「找不到待歸檔的 plan」並結束。
Step 2：讀取 Plan 內容
讀取目標 plan 檔案，確認：
- 是否有實作步驟段落。canonical 格式（
/design產出、plan_runner.py解析）的 step 是- [ ] **S<phase>.<num>** — <title>的 S-code 條目，phase 是任何###標頭（parser 就是^###\s+(.+)$，慣例寫### Phase N — <title>，冒號或破折號都可以）；舊 plan 另有## Phase X/### Step X.Y標頭式寫法，兩種都要認 - 是否有
## 驗證或## Verification段落 - 是否有
## Industry & Standards Reference段落
列出 plan 裡所有 step 作為追蹤清單，逐項標記完成狀態。先按 canonical S-code 格式抓（- [ ] **S1.1** — <title>，phase 為其上方最近的 ### 標頭）；抓不到再退回舊的標頭式格式（## Phase X / ### Step X.Y）。兩種都抓到空清單就停下來問使用者，不要當作「0 個 step」繼續——空清單會讓 Step 3 的完成率失去意義。
完成率的分母是這份清單的長度（即 plan 內實際的 step 數），不是 task 數——TaskCreate 在預設模型上不存在（見 rules/task-tracking-availability.md），拿 task 數當分母會在無工具環境直接歸零。session 若有 Task 工具，可另外用 TaskCreate 鏡射這份清單。
Step 3：補充驗證結果
在 plan 檔案頂部（緊接 --- frontmatter 後）加上：
**狀態：✅ 完成（YYYY-MM-DD）**
再追加或更新 ## 驗證結果 段落，逐條比對 Step 2 建立的清單：
| # | Phase/Step | 預期結果 | 實際結果 | 狀態 |
|---|---|---|---|---|
| 1 | Phase 1: ... | ... | ... | PASS/FAIL |
FAIL 項目必須附說明（是否為可接受的偏差或待處理問題）。
若 plan 有 ## Industry & Standards Reference，逐條對照確認落實情況（APPLIED / PARTIAL / NOT_APPLIED，後兩者附原因：環境限制、決策變更或遺漏）。
完成率 = PASS 步驟數 / 總步驟數：
- < 100%：警告 — 有未完成步驟，確認是否為已知的可接受偏差
- < 80%：阻止歸檔 — 需告知使用者，要求確認是否仍要歸檔
其他內容（測試通過數、任何偏差或補充說明）保留於此段落。
Step 4：移動檔案
mkdir -p plans/completed
mv plans/active/<filename>.md plans/completed/<filename>.md
確認移動成功後輸出：✅ 已歸檔：plans/completed/<filename>.md
自動化（選用）
若希望每次 ExitPlanMode 後自動將 plan 存至 plans/active/，設定方式見 docs/hooks-setup.md。
目錄規範
plans/
├── active/ # 進行中（Hook 自動存入 / /plan 手動建立）
├── completed/ # 已實作完成（/plan-archive 歸檔）
└── archived/ # 長期封存（不再參考的舊 plan）