SuperAPI AI 工具集

wrap-session

通用与其它

查看项目

更新于 10-29 18:03

技能介绍

用途:wrap-session 用于“收尾(wrap)”场景:当前工作线程已完成、用户明确要求 wrap,或经授权的合并结束了该线程时使用。未完成的任务不应 wrap;若任务进行中上下文即将耗尽,应改用 context-handoff。对于紧密耦合的分阶段集合,某一阶段合并后可以刷新连续性并在会话内继续,判断依据是线程是否完成,而不是是否存在提交或 PR。

前置读取:先读取仓库声明(AGENTS.md 链),识别任务追踪器与完成状态、交接形式(如有)、变更日志策略、记忆策略、远程持久化与合并规则,以及每一项外部写入的授权。没有声明的表面则跳过;不得在已有声明的交接文件旁另建 GitHub 交接,反之亦然。

状态核实:使用会话中收集的证据,只刷新可能变化的状态,例如 git status --short、git log --oneline -5;使用 GitHub 时回读相关 PR 与 issue 状态。需区分已提交、已推送、已合并、已部署;已通过的测试与未运行的测试;已验证事实与假设;本次会话改动与工作区原有改动。不得把无关改动混入收尾。

载体规则:每个声明载体只更新一次——已交付变更写入声明的变更日志;架构决策写入 ADR、计划或决策日志;坑点或来之不易的原因写入 auto-memory;约定或流程写入仓库文档;剩余任务或决策写入声明的追踪器;提交历史交给 git。若为已完成的 issue,按仓库惯例在合并时用 Closes #N 或 Fixes #N 关闭;确认任务完成后再移除进行中标记;部分推进的 issue 保持开启并附简短进展更新。仅在仓库声明变更日志且变更符合收录策略时更新;写记忆前先 recall,更新已有记忆而非新建重复项。

交接撰写:若仓库使用交接,为一位全新读者撰写:已完成工作及稳定标识符、经验证的当前状态、阻塞项及解除条件、下一可执行项或追踪器过滤条件、明确假设与未改动内容。不要写历史记录。文件交接应替换过期会话状态而非追加日记;追踪器交接遵循仓库声明的创建/关闭生命周期并回读结果,关闭前需先将保管权转移至追踪器。

持久化与验证:仅在请求或仓库策略授权时提交或推送收尾改动;提交后记录提交标识符,并验证目标远程包含它。本地提交、命令 URL 或成功退出码不构成远程持久化证明。跨仓库收尾需逐一独立验证。若工作区存在原有改动,不得声称工作树干净,应说明其未被触碰。

最终报告:返回已完成工作与稳定标识符、验证命令与结果、实际做出的追踪器/变更日志/记忆/交接更新、远程持久化状态、剩余工作与阻塞项、因未声明或未授权而跳过的表面。线程结束后,无关的新工作应在新顶层会话中启动。