SuperAPI AI 工具集

session-debrief

通用与其它

查看项目

更新于 10-16 01:49

技能介绍

用途:分析 Claude Code 的历史会话,输出可交接或可复盘的结果。提供三种目标模式:1 交接文档(穷尽上下文,含已完成任务、当前状态、未完成项、关键决策与理由、要点与陷阱、下一步);2 错误取证(逐条列出自警告、错误、弃用、失败命令与异常,尤其 Claude 已知但忽略或推迟的项,附轮次、触发命令、文件路径、原文错误与解决状态);3 时间顺序摘要(按轮次的技术时间线,标记未解决错误,末尾给关键结果)。

使用方式:先经 AskUserQuestion 两次确认目标与时间范围,再调起 Agent 执行脚本:

bun run $HOME/eon/cc-skills/plugins/devops-tools/scripts/session-debrief.ts
--goal <1|2|3> --since <hours> --verbose

时间范围默认 48 小时,可换算为 1 周 168、1 月 720 或自定义自然语言。输出直接展示,不再摘要。常用参数:--dry --verbose 仅看提取内容不调 LLM;--project-dir 手动指定项目目录;--no-chain 跳过父链追踪;不带 --goal 的会话 UUID 形式为旧版模式。脚本从 ~/.claude/projects/<项目键>/ 扫描 .jsonl,项目键为绝对路径中的 / 替换为 -。

配置:需要 DEBRIEF_LLM_API_KEY(或 SUB2API_KEY)与 DEBRIEF_LLM_API_URL(可用 ~/.config/cc-skills/debrief.env),模型默认 claude-sonnet-5[1m],单次输出上限 16384 tokens,上下文预算约 890K 字符;超限时会按轮次分块分析再合并。

限制:无法确定项目目录或时间窗内无会话时需手动调整;缺少密钥或端点会报错;单个会话过大可能触发上下文超限,可先 --dry --verbose 检查并尝试 --no-chain;输出可能分为多个 PART 段。技能自述为随使用演进的机制,若指令与实际情况不符可修正该文件。