SuperAPI AI 工具集

wrap

编程与开发

查看项目

更新于 10-15 12:47

技能介绍

Wrap 是一个面向开发会话收尾的 AI 技能,来源为 camacho/ai-skills。它的用途是在结束会话、收尾工作、告别,或在完成一个开发周期后切换到新的任务上下文时,帮助完成反思与清理,为 /clear 做准备。

主要能力分为三步。

第一步是反思(Reflect)。通过 Skill 工具调用 /reflect,并等待其完成后再继续。资料明确要求不要内联 reflect 逻辑,而应调用该技能。它负责处理 MEMORY.md、Basic Memory vault、GitHub issues、计划定稿以及 .last-reflect-ts。

第二步是会话清理(Session Cleanup)。在 reflect 完成后,清理会话工作树。先获取仓库根目录并列出工作树:

REPO_ROOT="$(git rev-parse --show-toplevel)" git -C "$REPO_ROOT" worktree list

对 .worktrees/ 下的每个条目(绝不处理主工作树),判断其分支是否已合并到 main:

REPO_ROOT="$(git rev-parse --show-toplevel)" BRANCH=$(git -C <worktree-path> rev-parse --abbrev-ref HEAD) git -C "$REPO_ROOT" branch --merged main | grep -q "$BRANCH" && MERGED=true || MERGED=false

若已合并:执行 git -C "$REPO_ROOT" worktree remove <path> 以及 git -C "$REPO_ROOT" branch -d "$BRANCH"。若未合并:仅以分支名发出警告,不删除。

关于 .branch-context.md:如果它存在于 "$REPO_ROOT/.branch-context.md",且 reflect 确认学习内容已整合,则删除它;如果 reflect 跳过了它或报告没有学习内容,则保留并警告:".branch-context.md may contain unreflected learnings."。

清理完成后输出报告,例如:

Session cleanup: Removed: .worktrees/feat-foo (branch feat/foo, merged) Kept: .worktrees/feat-baz (branch feat/baz, NOT merged) Cleaned: .branch-context.md (learnings consolidated)

第三步是提示 /clear。会话收尾完成后,提示用户准备好时输入 /clear。资料强调不要直接调用 /clear,它是只有用户才能输入的内置命令。在 /clear 之后,SessionStart 钩子会自动注入衔接(catchup)说明。

常见错误与修正:内联 reflect 逻辑应改为通过 Skill 工具调用 /reflect;删除未合并的工作树应改为仅警告、绝不删除未合并的工作;直接调用 /clear 应改为让用户自行输入,因为 /clear 是内置命令;清理主工作树应改为只清理 .worktrees/* 条目;跳过清理报告应改为始终报告清理和保留的内容。

适用场景:在完成一个开发周期后结束会话、收尾工作或切换到新任务上下文时使用。限制:不处理主工作树;不删除未合并的分支;不代为调用 /clear;关于收费、价格、平台等信息资料暂未提供。