archive

用途 archive 技能用于在计划执行完成后，为其补充结果与经验教训，并将计划文件正式归档为 .done.md。

输入

• WORKTREE：当前工作树的绝对路径（可从会话的当前工作目录或 git rev-parse --show-toplevel 解析）。
• 计划文件路径：默认取 $WORKTREE/ai-workspace/plans/ 下最近的一个非 .done.md 文件。

主要能力与使用方式

1. 查找计划文件： ls -t "$WORKTREE/ai-workspace/plans/"*.md | grep -v '.done.md' | head -1 如果计划已经是 .done.md，则报错：“Already archived.”
2. 读取计划文件，了解原本的计划内容。
3. 收集结果：向用户询问（或从 git log 与分支上下文推断）：
   • 哪些做得好？
   • 哪些未按计划进行？
   • 有什么会做得不同？ 如果用户跳过，则写入“Outcomes: not recorded”，不阻塞流程。
4. 将 Outcomes & Learnings 章节写入计划文件，结构为：

   Outcomes & Learnings

   Completed: [日期]

   What Worked

   • [要点]

   What Didn't

   • [要点]

   Learnings

   • [要点]
5. 重命名为 .done.md： git -C "$WORKTREE" mv ai-workspace/plans/<name>.md ai-workspace/plans/<name>.done.md
6. 提交归档： git -C "$WORKTREE" add ai-workspace/plans/<name>.done.md git -C "$WORKTREE" commit -m "docs: archive plan <name>\n\nCo-Authored-By: Claude <model>"

输出 确认计划已归档，并给出 .done.md 文件的路径。

适用场景 适用于以计划文件驱动的工作流程，在任务结束后需要留下复盘记录并进行版本化归档的场景。

限制

• 依赖 git 与 ai-workspace/plans/ 目录结构。
• 对已经归档（.done.md）的文件会直接报错，不重复处理。
• 用户未提供结果信息时仅记录“not recorded”。