mcpField
A
archive

archive

github.com/camachoAgent 工作流710 次安装
代码仓库

关于 archive

用于归档已完成工作计划的 Agent 技能,会记录成果与经验、重命名计划并提交更改,适用于将计划保存在 ai-workspace/plans/ 的仓库工作流。

主要功能

  1. 01查找最新未归档计划
  2. 02记录成果与经验
  3. 03将计划标记为已完成
  4. 04提交归档后的计划

适用场景

  1. 01归档已完成的实施计划
  2. 02记录项目结束后的经验
  3. 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 文件)

步骤

  1. 查找计划文件:

    ls -t "$WORKTREE/ai-workspace/plans/"*.md | grep -v '.done.md' | head -1
    

    如果计划文件已经是 .done.md → 错误:"Already archived."

  2. 读取计划文件,了解计划内容。

  3. 收集结果:询问用户(或根据 git 日志和分支上下文推断):

    • 哪些方面进展顺利?
    • 哪些方面没有按计划进行?
    • 如果重新来过,你会做哪些不同的事情?

    如果用户跳过 → 写入 "Outcomes: not recorded"(不要阻塞流程)。

  4. 将 Outcomes & Learnings 部分写入计划文件:

    ## Outcomes & Learnings
    
    **Completed**: [date]
    
    ### What Worked
    - [bullet points]
    
    ### What Didn't
    - [bullet points]
    
    ### Learnings
    - [bullet points]
    
  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>
    
    Co-Authored-By: Claude <model>"
    

输出:确认计划已归档,并提供 .done.md 文件的路径。

评论

支持 Markdown