| name | ah-archive |
| description | 项目归档引导。用于项目完成、用户明确提出“归档/结项/项目收尾”、或在周月回顾中识别到待归档项目时，执行完成度核查、复盘总结、待提炼内容标记、项目目录迁移（移动非删除）、领域页链接同步与归档结果汇报。 |
执行 Obsidian 的读取、检索、写入等动作时，优先调用官方技能：obsidian-cli。
项目归档引导技能
归档目标：在“项目结束”与“知识沉淀”之间建立闭环，避免项目结束后资料散落或经验丢失。
启动即执行
- 读取
{{metaPaths.memory}}/STATUS.md，检查是否有“待归档项目”提示。
- 读取
{{notePaths.activeProjects}}/，生成可选项目清单（只使用真实数据）。
- 若用户未指定项目，先让用户确认要归档的项目编号或名称。
流程锁定规则（高优先级）
- 用户在复盘中提到“阅读/卡片/整理”等词时，视为归档输入，不自动切技能。
- 只有两种情况允许中断：
- 用户明确输入其他命令（如
/ah-card）
- 用户明确说停止归档流程
- 如果用户选择“现在处理可提炼内容”，先完成归档动作，再建议进入
/ah-card。
归档主流程
- 确认项目：项目名、领域、起止时间、原目标。
- 检查完成度：读取成功标准并确认是否允许“部分完成归档”。
- 引导复盘：收集成果、收获、教训、可复用经验。
- 标记提炼项：选择“现在处理 / 先归档后处理 / 跳过”。
- 更新项目主页：写入归档区块并保留可追溯链接。
- 更新 YAML 状态：
状态: 已完成 与 完成日期。
- 确认归档层级：优先复用用户已有层级；若无现有层级则先与用户确认新层级。
- 移动项目目录：从
{{notePaths.activeProjects}}/ 移动到确认后的归档层级路径。
- 更新领域页：将项目从“活跃项目”迁移到“历史归档”。
- 输出归档报告：列出完成动作、归档位置和后续待办。
执行约束
- 归档是移动，不是删除。
- 任何路径操作前，先确认目标目录存在；不存在则先创建。
- 归档层级推荐必须先参考用户当前
{{notePaths.archive}}/ 的实际结构，不直接套用固定模板。
- 若用户是首次归档（无现有层级），必须先给出候选层级方案并与用户确认后再落盘。
- 归档完成后必须同步更新：
快速归档模式
当用户时间有限时，允许跳过深度复盘，但仍必须完成：
- 项目确认
- 完成度结论（完成/部分完成）
- 项目主页 + YAML 更新
- 归档层级确认（沿用现有或新建）
- 目录移动
- 领域页同步
- 归档结果汇报
输出标准
- 复盘内容优先保留用户原话，再做轻量整理。
- 待提炼内容必须明确状态：
- 归档结果中必须说明层级来源：沿用已有层级或本次新建层级。
- 最终汇报必须可执行、可追溯，包含准确路径。
检查清单
渐进加载（按需读取）
- 详细流程与分支话术：
references/workflow-details.md
- 更新模板（项目主页/YAML/领域页/汇报）：
references/update-templates.md
- 路径与移动规则（含多领域项目）：
references/path-rules.md
相关技能
ah-project：项目创建ah-card：将项目经验转为永久笔记ah-week：周回顾中识别待归档项目
