SuperAPI AI 工具集

session-logger

办公与效率

查看项目

更新于 10-15 14:55

技能介绍

Session Logger 是 Agent Playbook 提供的一项会话记录技能,目标是在不把原始对话历史当作持久记忆的前提下,生成一份紧凑的恢复性产物(recovery artifact)。

用途 该技能适用于以下情形:用户明确要求保存或记录当前会话;受支持的主机通过 Agent Playbook SessionEnd 钩子传入转录文件路径;后续任务需要一份简洁的交接产物,且用户已授权写入。它不会静默持久化原始转录、凭据、私有客户数据或无界代理输出。主机支持与写入权限必须可见,仅凭技能元数据并不会执行钩子。

主要能力 在 Claude Code 安装环境中,可调用命令 agent-playbook session-log。该命令读取主机提供的 JSONL 转录,仅存储有边界、经脱敏的细节,包括:消息数量;脱敏后截断的最后一条用户提示;最多 12 条检测到的命令和文件引用;最多 8 个检测到的问题;以及哈希化的会话引用和项目标识。

使用方式 默认情况下,文件是私有的本地产物,路径为 ~/.agent-playbook/sessions/<project-id>/YYYY-MM-DD-<topic>.md。可通过设置 AGENT_PLAYBOOK_DATA_DIR 或传入 --data-dir 来移动私有数据根目录。写入仓库内部属于可选行为,需显式指定,例如:apb session-log --session-dir ./sessions。如果选择了仓库本地目录,写入前应核实其忽略(ignore)与保留策略,切勿假定其他仓库会忽略 sessions/ 目录。

当主机无法提供转录事件时,可依据当前会话中实际可见的上下文,创建经用户授权的摘要。摘要仅应包含:结果与当前状态;影响后续工作的决策;相关文件或命令;未决问题与下一验证关口。应如实说明遗漏内容,除非当前运行时能够明确证明,否则不得声称具备完整对话捕获、结构化决策提取、自动追加行为或跨会话回忆能力。

隐私与安全 写入前应对常见凭据、bearer 令牌、私钥、电子邮件地址以及密码/密钥赋值进行脱敏。在生成的元数据中,用项目标识替换当前项目根路径。在平台支持的情况下,以仅所有者可访问的权限写入生成的摘要。除非用户另行授权提交、上传或分享,否则产物应保持本地。脱敏应被视为降低风险,而非保证任意机密文本绝对安全。

完成检查 目的地与写入权限明确;摘要具有边界且不含已知原始机密;仓库本地存储为显式选择且已检查忽略策略;返回的路径存在且用户可读。

适用场景与限制 该技能适合需要会话交接、恢复或记录的场景,但依赖主机提供转录事件或用户显式授权。它不提供完整对话捕获、结构化决策提取、自动追加或跨会话回忆等能力,除非运行时明确支持。关于收费、价格、平台支持范围等具体信息,资料中暂未提供。