关于 archive
用于归档已完成工作计划的 Agent 技能,会记录成果与经验、重命名计划并提交更改,适用于将计划保存在 ai-workspace/plans/ 的仓库工作流。
主要功能
- 01查找最新未归档计划
- 02记录成果与经验
- 03将计划标记为已完成
- 04提交归档后的计划
适用场景
- 01归档已完成的实施计划
- 02记录项目结束后的经验
- 03维护仓库中的计划历史
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ camacho/ ai-skills --skill archive安装后在 Claude Code 中输入/archive确认已加载。
详细介绍
输入
WORKTREE:当前工作树的绝对路径(从会话 CWD 或git rev-parse --show-toplevel解析)- 计划文件路径(默认为
$WORKTREE/ai-workspace/plans/中最近的非.done.md文件)
步骤
-
查找计划文件:
ls -t "$WORKTREE/ai-workspace/plans/"*.md | grep -v '.done.md' | head -1如果计划文件已经是
.done.md→ 错误:"Already archived." -
读取计划文件,了解计划内容。
-
收集结果:询问用户(或根据 git 日志和分支上下文推断):
- 哪些方面进展顺利?
- 哪些方面没有按计划进行?
- 如果重新来过,你会做哪些不同的事情?
如果用户跳过 → 写入 "Outcomes: not recorded"(不要阻塞流程)。
-
将 Outcomes & Learnings 部分写入计划文件:
## Outcomes & Learnings **Completed**: [date] ### What Worked - [bullet points] ### What Didn't - [bullet points] ### Learnings - [bullet points] -
重命名为 .done.md:
git -C "$WORKTREE" mv ai-workspace/plans/<name>.md ai-workspace/plans/<name>.done.md -
提交归档:
git -C "$WORKTREE" add ai-workspace/plans/<name>.done.md git -C "$WORKTREE" commit -m "docs: archive plan <name> Co-Authored-By: Claude <model>"
输出:确认计划已归档,并提供 .done.md 文件的路径。
评论
支持 Markdown