SuperAPI AI 工具集

session-end

编程与开发

查看项目

更新于 10-15 22:16

技能介绍

用途:在编码会话结束时做收尾,把本次做了什么持久化下来,并给出会话重命名建议。

主要能力(分五个阶段):

  1. 盘点:分析新建/修改的文件、会话期间的 git 变更、已完成与未完成任务;同时统计 MEMORY_WRITES(自动记忆文件编辑与记忆 MCP 保存调用)、COMMIT_COUNT(git commit 次数)、SESSION_LOG_UPDATED(是否真的写入了日志)。若存在旧式 .claude-sessions/session_*.log,会追加会话结束标记。
  2. 会话结束自评:按会话复杂度决定深度,简单会话只给一句诚实结论;涉及认证、支付、生产、数据、删除等风险面或已交付时才展开。可回答的问题包括:最没把握的地方、可能被忽略的最大问题、若三个月后出故障最可能的原因、哪些事没做,以及为每个不确定项给出可验证的测试或命令。此阶段只做盘点,不开始修复;有具体验证方式的发现进入第 3 阶段,其余折入交接说明或用 /idea 记录。
  3. 校验:若存在 curator 子代理(agents/curator.md),以只读方式对照 git/文件、环境检查和仓库不变量文档核验声明。只有 VERIFIED 的声明才记为已完成;UNVERIFIED 可记录但须标注;CONTRADICTED 不得记为完成,须写入交接说明。
  4. 写入 SESSION_LOG.md:git 仓库写入 $GIT_ROOT/SESSION_LOG.md,否则写入 ~/SESSION_LOG.md;条目含日期、短标题、1–2 句摘要和主要产物指针(文件路径、commit SHA、PR URL 或 issue ID),以最新在上的方式原子化前置插入。无实质变更则跳过并置 SESSION_LOG_UPDATED=false。
  5. 输出收尾两行:Rename: [YYYY-MM-DD] <项目或主题> - <做了什么>(动词短语不超过 8 词),以及计数摘要 <N> memory updates · <N> commits · SESSION_LOG <updated|skipped>。

使用方式:作为技能在会话结束时触发,按阶段执行;涉及日志前置插入时使用资料中给出的 shell 片段(LOG_PATH、mktemp、cat 与 mv 等命令保持原样)。

适用场景:需要为编码会话留下可追溯记录、交接上下文和下一步指令的开发者工作流。

限制:curator 校验为可选,不可用时静默跳过;自评深度需按会话规模自行把握,避免制造无谓担忧;无实质变更时日志与部分阶段会被跳过,属有意行为。具体安装方式与平台支持暂未提供。