SuperAPI AI 工具集

log-session

通用与其它

查看项目

更新于 10-15 21:56

技能介绍

用途:在清空上下文、收工或到达自然停点前,把本次会话的过程与下一步写入项目会话日志 docs/LOGS.md,作为工作记忆而非合并产物。默认路径为 docs/LOGS.md,若文档地图指定其他位置则以地图为准;日志不存在时按 template/docs/LOGS.md 的结构创建。若存在 .claude/.session-*.start 标记,可用其中的 HEAD 与开始时间界定会话范围,否则以对话上下文并结合 git 记录为准。

主要能力与流程:先用 git 收集机械事实(当前分支、本次提交、改动文件);再撰写叙述部分,包括摘要、非显而易见的决策及理由、具体下一步。渲染条目可运行:bun scripts/session-close.mjs render --summary "<what this session did>" --decisions "<key choices + why>" --next "<the concrete next step>",该命令只输出内容、不写文件,需自行追加到 docs/LOGS.md 末尾。收尾运行:bun scripts/session-close.mjs close,它会检查日志确为追加、提交该文件并报告未提交路径(退出 0 干净、2 有遗留、1 拒绝)。

限制与注意:仅追加、不重写既有条目,不分散到多个文件。不要为日志单独开 PR,也不要使用 git add -A。关于 PR/issue 状态的描述须以 forge 实际状态为准。决策与下一步必须来自真实会话,无内容则省略而非填充。该技能只做结构化总结,不应使用昂贵模型;在无 Claude Code 钩子的其他 agent 上,它是唯一的日志写入方式,需每次会话结束前手动运行。不适用场景或额外平台支持暂未提供。