用途：将 plans/active/ 中已完成的 plan 归档至 plans/completed/，并补上验证结果与完成时间，适合在实作结束后调用。
主要能力与流程：
- 找出要归档的 plan：有传入档名或路径则直接使用，否则列出 plans/active/*.md；多个时依 mtime 排序询问使用者，只有一个则直接用，目录不存在或为空则输出「找不到待归档的 plan」并结束。
- 读取 plan 内容，确认是否有实作步骤、## 验证 或 ## Verification、## Industry & Standards Reference 段落，并列出所有 step 作为追踪清单。canonical 格式为 - [ ] S<phase>.<num> — <title>，phase 为上方最近的 ### 标头；抓不到再退回旧式 ## Phase X / ### Step X.Y 标头。两种都抓不到就停下来询问，不当作 0 个 step 继续。完成率分母是 plan 内实际 step 数，不是 task 数。
- 产生执行报告：检查 <plan-dir>/.plan-state/<slug>.state.json 是否存在；存在则执行 python3 ~/Documents/agent-skills/scripts/plan_runner.py report <plan>，把 stdout 原样放入 plan 的 ## 执行摘要 段（已存在则整段取代），位置在 ## 验证结果 之前，不加 --output 写成旁档；不存在则写「（本 plan 未经 /plan-run 推进，无执行纪录）」。此步须在移动前完成，因为 mv 只搬 .md，state 留在隐藏目录会与 plan 分离。
- 补充验证结果：在 frontmatter 后加上「状态：✅ 完成（YYYY-MM-DD）」，追加或更新 ## 验证结果 段落，逐条比对清单并标记 PASS/FAIL，FAIL 须附说明；若有 Industry & Standards Reference 则逐条对照 APPLIED / PARTIAL / NOT_APPLIED。完成率 = PASS 步骤数 / 总步骤数，低于 100% 警告，低于 80% 阻止归档并要求使用者确认。
- 移动档案：mkdir -p plans/completed 后 mv plans/active/<filename>.md plans/completed/<filename>.md，成功后输出已归档路径，并在最终回覆附上嵌入的执行摘要精简版（报告路径、Progress 进度行、#### 彙整 三张清单、各 phase step 状态表、未完成与例外段全文）。
目录规范：plans/active/ 为进行中，plans/completed/ 为已实作完成，plans/archived/ 为长期封存。自动化（选用）：若希望每次 ExitPlanMode 后自动将 plan 存至 plans/active/，设定方式见 docs/hooks-setup.md。
限制：完成率低于 80% 会阻止归档；无执行纪录时须照实回覆，不假造摘要；报告格式对 parse_plan 无效，归档后重新 init 不会多出 step 或 phase。