SuperAPI AI 工具集

session-chronicle

通用与其它

查看项目

更新于 10-15 23:57

技能介绍

用途:挖掘 Claude Code 会话日志,为研究发现、ADR 决策和代码贡献捕获完整出处,并追踪跨多个自动压缩会话的 UUID 链。触发场景包括:用户询问“谁创建了这个/它来自哪里”、需要用完整会话上下文记录发现、ADR 或研究结果需要溯源、Git 提交需要会话 UUID 引用、跨自动压缩会话追踪编辑、创建研究会话的注册表条目。

主要能力:扫描项目内全部主会话与子代理会话,构建 session_contexts 数组;可追踪父 UUID 链;生成两类 NDJSON 文件——findings/registry.jsonl(主索引)与 findings/sessions/<id>/iterations.jsonl(迭代记录)。仅 findings/ 会提交到 Git;研究产物写入被 gitignore 的 outputs/ 及 S3。注册表条目必须自包含,需记录全部会话 UUID 与必填的 GitHub 用户名(created_by.github_username)。

使用方式(摘要):先执行预检,确认 ~/.claude/projects/ 存在、枚举主会话与子代理 .jsonl、检查 jq、brotli、aws、op 等工具。随后通过 AskUserQuestion 依次确认跟踪目标、GitHub 归属、会话范围(默认全部)、预览 session_contexts、输出格式、ADR 链接。生成输出后需经用户最终确认,再追加写入并校验 NDJSON(tail -1 findings/registry.jsonl | jq .)。若需共享到 S3,必须先运行 sanitize_sessions.py 脱敏,流程固定为 raw → sanitize → zip → S3 → 预签名 URL,禁止直接上传原始文件。

限制与注意:原始会话 JSONL 可能含凭据、内部主机名、IP、邮箱等敏感信息,共享前必须脱敏并检查 redaction_report.txt,确认未破坏 UUID 等结构标识。会话存储缺失、路径编码错误、jq 解析错误、brotli 未安装、S3 凭据缺失等问题会导致失败。该技能为自进化型,仅在遇到真实可复现问题时才更新自身文件。具体命令与完整脚本参见原技能文档;其余细节资料未提供。