session-report – Claude Code 会话报告生成 Skill

3周前更新 8 0 0 0

session-report 是 Anthropic 官方 Claude 插件仓库中的会话报告 Skill,用于把 Claude Code 会话整理成包含任务进展、关键操作和遗留问题的结构化摘要,适合生成开发记录、周报或团队交接文档。

Skill 安装

多 Agent 安装
npx skills add https://github.com/anthropics/claude-plugins-official --skill session-report

使用 npx skills 快速安装,支持将 Skill 添加到多个兼容的 AI Agent。

Skill 调研报告

Skill 详细介绍

session-report 是 Anthropic 官方 Claude 插件市场仓库(anthropics/claude-plugins-official)中的一个 Skill,用于针对 Claude Code 会话(session)生成结构化报告。它的定位偏向“会话记录整理与总结”,帮助用户把一次或多次 Claude Code 会话中产生的对话、操作结果、命令执行情况等整理成更易读、可归档、可交接的报告内容。它不是独立运行的软件,也不是一个通用编程库,通常以 Skill 指令的形式被 Agent 加载,用来指导 Agent 如何组织并输出会话相关报告。

它是什么

– Anthropic 官方仓库 claude-plugins-official 中的一个 Skill 条目。
– 面向 Claude Code 会话记录整理与报告生成。
– 以指令 / 提示词 / 工作流方式被 Agent 加载,增强 Agent 整理会话信息并生成报告的能力。

它不是什么

– 不是 Claude Code 本体,也不是 Claude 模型的替代品,不能脱离 Agent 独立执行。
– 不是通用的“会话监控”或“性能分析”工具。
– 不是第三方独立项目,而是官方仓库中的 Skill 条目。
– 本身不新增底层运行时,不提供独立的 CLI、服务或守护进程。

核心用途与典型任务

– 把一次 Claude Code 会话整理成可读记录、周报或交接材料。
– 把长会话压缩成结构化摘要、关键操作清单。
– 在团队内部共享某次调试或开发会话的结论。
– 按“问题、排查过程、结论、后续动作”等结构组织交接文档。

适合哪些用户

– 需要把一次 Claude Code 会话整理成可读记录、周报或交接材料的用户。
– 希望将长会话压缩成结构化摘要、关键操作清单的开发者。
– 需要在团队内部共享某次调试或开发会话结论的场景。

不适合哪些需求

– 想要监控实时运行系统、做 APM / 日志分析的用户。
– 想要持久化保存 Claude Code 全部原始会话日志、需要完整审计链的场景。
– 希望 Skill 自己能够“跑”起来、独立访问文件系统或数据库的用户。

关于它的具体输出格式(例如是否包含固定小节、是否生成 Markdown 或纯文本、是否可自定义字段),当前官方资料未在本环境中完整提供,具体以该 Skill 当前的官方 SKILL.md 和仓库说明为准。用户在使用时应以仓库中实际内容为唯一依据,避免依赖不确定性细节。

Skill 安全评估

总体判断:作为来自 Anthropic 官方仓库(anthropics/claude-plugins-official)的 Skill,session-report 在来源可信度上属于较高等级,没有已知的第三方夹带风险。但“会话报告”这一用途意味着它天然会接触到会话内容,而会话内容可能包含敏感信息,这是使用这类 Skill 时真正需要关注的点。

来源可信

该 Skill 属于 Anthropic 官方插件仓库条目,非第三方重新发布。只要从官方仓库路径获取,供应链可信度相对可控。若从第三方镜像、Fork 或转载站点获取,则不再具备同样可信度,需要自行审查内容。

会话内容隐私

会话报告中可能包含用户代码片段、命令、路径、环境变量名、接口调用、甚至密钥信息。生成报告后若被分享、提交到仓库或粘贴到外部平台,存在信息泄露风险。建议在分享前人工检查并脱敏。

文件写入

如果报告以文件形式写出(例如保存为 Markdown、txt、JSON),Agent 需要文件写入权限。是否写入、写入到哪里,取决于用户在具体会话中的指令和 Agent 权限设置。不需要写文件时,可以让 Agent 只在对话中输出。

Shell 权限

session-report 本身通常不需要执行 Shell 来生成文本报告。但如果 Agent 环境中启用了自动执行,且 Skill 指令涉及调用命令整理数据,则可能触发 Shell 操作。若只需生成文本报告,可以在 Agent 中限制或关闭自动执行 Shell。

网络访问

报告生成过程通常不需要联网。若 Agent 环境启用了联网,需要自行判断会话内容是否会被外发。存在联网能力时应谨慎处理含敏感信息的会话。

Prompt Injection

如果会话内容中包含来自不可信来源的文本(例如抓取的网页、第三方文件内容),且被纳入报告流程,理论上存在被注入指令影响 Agent 行为的可能。会话内容作为报告素材时,应视为数据处理对象,而不是新的指令来源。

降低风险的建议

– 只从 anthropics/claude-plugins-official 官方路径获取该 Skill,避免使用来源不明的副本。
– 生成报告前,明确告知 Agent 报告范围与输出位置,避免无意覆盖已有文件。
– 分享报告前预览内容,删除或替换密钥、Token、内部 URL、真实用户名等敏感信息。
– 如果在多用户环境使用,注意会话内容可能包含其他同事的信息,分享需经同意。
– 若不需要自动写文件,可以让 Agent 直接在对话中输出报告,由用户自行决定是否保存。

没有公开的独立安全审计结果可引用,因此不应做出“100% 安全”或“完全无风险”之类的绝对结论。正确姿势是把它当作一个可信来源、但会接触敏感内容的辅助能力来使用。

Skill 使用要求

一、Agent / 客户端

session-report 来自 Anthropic 官方 Claude 插件仓库,主要面向 Claude Code。可以优先在 Claude Code 中使用,作为 Claude Code 会话能力的一部分安装与调用。

官方没有提供完整的第三方 Agent 兼容列表。由于 Skill 本身是以指令 / 提示词 / 工作流方式工作,凡是支持 Skills、自定义 Skill 或类似指令加载机制的 Agent(例如 Codex、Cursor、Trae、OpenClaw、WorkBuddy 等),通常可以尝试加载和使用。不同 Agent 的 Skill 加载方式、目录约定与权限模型不同,兼容程度可能有差异,具体以对应 Agent 当前版本的实际行为为准。

| 项目 | 要求 |
|—|—|
| Agent | Claude Code 优先;其他支持 Skill 机制的 Agent 可尝试 |
| Node.js | 官方未在 Skill 层面明确要求;跟随所在 Agent 的环境 |
| Python | 官方未在 Skill 层面明确要求 |
| 网络 | 报告生成通常不需要;是否可用取决于 Agent 环境 |

二、运行环境 / 依赖

该 Skill 本身没有公开说明必须安装的独立运行时(Node.js、Python、Docker 等)。实际依赖来自你使用的 Agent:Claude Code 有它自己的安装方式,其他 Agent 也有各自环境要求。不需要为了 session-report 单独安装额外语言运行时,除非该 Skill 当前官方 SKILL.md 另有说明。

三、权限

– 文件读取:可选。若要让 Skill 基于会话导出文件整理报告,可能需要读取相关文件。
– 文件写入:可选。若希望报告保存为文件,需要写入权限;仅在对话中输出报告则不需要。
– Shell:通常不需要。文本报告生成不依赖 Shell。
– 网络:通常不需要。
– 浏览器 / Docker / GitHub 权限:不涉及。

四、账号 / API Key

session-report 作为 Skill 本身,官方未说明需要单独的账号、API Key 或 Token。所需账号与凭证取决于你使用的 Agent:使用 Claude Code 时,凭 Claude Code 自身的账号 / 登录态即可;如果会话内容涉及调用外部服务的项目,那些凭证属于项目层面,不属于本 Skill。

最小使用条件

– 一个可加载 Skill 的 Agent(Claude Code 为优先选择)。
– 该 Agent 中已完成 session-report 的安装 / 加载。
– 存在需要整理的 Claude Code 会话内容。
– 如希望保存报告为文件,需要相应的文件写入能力。

Skill 安装、使用与卸载教程

一、安装

LemonAIKit 本页面已经提供该 Skill 对应的安装指令,推荐直接复制本页面提供的 Skill 安装指令,粘贴到对应 Agent 或终端中执行。

如果你不确定当前使用的 Agent 应该怎样安装,可以直接向该 Agent 提问,让它根据自身的 Skill 加载 / 管理机制给出安装步骤,例如:

如何安装 anthropics/claude-plugins-official#session-report?

如何在 Claude Code 中安装 anthropics/claude-plugins-official#session-report?

如何在 Codex 中安装 anthropics/claude-plugins-official#session-report?

如何在 Cursor 中安装 anthropics/claude-plugins-official#session-report?

不同 Agent 的 Skill 安装目录、加载顺序和管理命令不一致,让 Agent 自己给出步骤通常比在文章里罗列所有平台命令更稳妥。该 Skill 当前官方资料没有说明必须额外的特殊安装前置条件,若后续官方 SKILL.md 有补充,以其为准。

二、安装后如何使用

安装完成后,通常有两种触发方式:

– Agent 依据 Skill 描述自动匹配:当你提出的任务明显属于“整理会话 / 生成会话报告”时,Agent 可能自动调用该 Skill。
– 用户在对话中明确点名:直接让 Agent 使用 session-report 完成指定任务。

自然语言使用示例(以下均为示例写法,不是官方 CLI 命令或 Slash Command):

使用 session-report,把今天这次 Claude Code 会话整理成一份结构化报告,包含主要任务、关键改动和遗留问题。

使用 session-report,帮我把刚才的调试会话生成一份交接文档,按“问题、排查过程、结论、后续动作”组织。

使用 session-report,总结本次会话中我执行过的主要命令和结果,输出为 Markdown。

建议在描述需求时同时说明:报告用途(自用 / 团队交接 / 归档)、是否要保存为文件、希望包含哪些部分。这样 Agent 更容易生成可直接使用的结果,而不是泛泛总结。

三、卸载

卸载方式取决于你使用的 Agent:

– 使用对应 Agent 或 Skill 管理器提供的删除方式,移除 session-report 条目。
– 如果 Agent 支持直接对话卸载,可以直接问它:

如何卸载 anthropics/claude-plugins-official#session-report?

不同 Agent 的 Skill 安装位置与管理方式可能不同,如果没有统一卸载命令,直接询问当前 Agent 如何移除该 Skill 通常更稳妥。当前官方资料未明确说明统一的卸载命令,本文不编造具体命令。

常见问题

1. session-report 会和 Claude Code 自带的会话记录功能冲突吗?

两者目的不同。Claude Code 自身的会话记录侧重交互历史与恢复,而 session-report 侧重把会话整理成可读报告。通常可以并用。具体行为以你所用 Agent 版本为准。

2. 安装后 Agent 没有识别到这个 Skill,怎么办?

常见原因包括:Skill 未放到 Agent 期望的目录、Agent 版本不支持 Skill 机制、或需要重启 / 重新加载。可以直接询问当前 Agent“为什么没有识别到 anthropics/claude-plugins-official#session-report”,让它根据自身加载机制排查。

3. session-report 生成的报告会不会包含我的密钥或敏感信息?

取决于会话内容本身。如果会话里出现过密钥、Token、真实路径等,报告可能包含同样内容。分享前请人工检查并脱敏。该 Skill 不会主动“清洗”敏感信息,除非你在指令中要求。

4. 可以同时安装到多个 Agent 吗?

可以。Skill 本质是文件层面的内容,可以在多个 Agent 各自的 Skill 目录中分别安装。是否同时生效取决于各 Agent 的加载规则。

5. Skill 更新后需要重新安装吗?

取决于你的安装方式和 Agent 的管理机制。如果是直接复制文件方式安装,需要重新拉取最新版本覆盖;如果 Agent 支持从来源更新,则按 Agent 提供的更新方式操作。当前官方资料未明确统一的更新流程,以仓库和 Agent 说明为准。

6. 在中国大陆使用有网络要求吗?

session-report 本身是本地 Skill 内容,报告生成过程通常不需要联网。能否安装、同步、更新取决于你使用的 Agent 与仓库访问网络环境,这部分不是该 Skill 特有的要求。

7. 它可以用于生产环境的会话审计吗?

它的定位是报告生成,不是审计系统。缺少持久化存储、完整性校验、防篡改等审计特性。生产级审计应使用专门的日志与审计方案,session-report 更适合内部总结和交接场景。

Skill 更新日志

版本列表
无版本号
添加按天会话时间线并折叠缓存中断列表 - analyze-sessions.mjs:跟踪每个会话的开始/结束/tokens,并在 JSON 输出中生成 by_day[](日期、星期、tokens、峰值并发数、 每会话时间跨度)。将共享的 token 汇总提升到提交循环中。 - template.html:新增“按天会话时间线”部分——水平 日期胶囊(占总量的百分比 + 会话数)驱动一个泳道打包的 并发会话甘特图,按项目着色,带有悬停详情和 ←/→ 键盘导航。提取 drillList() 辅助函数,并将其用于 顶部提示和缓存中断(显示 5 条 + “显示更多”切换)。
无版本号
添加 session-report 插件 从本地 ~/.claude/projects 转录记录生成可探索的 Claude Code 会话使用情况 HTML 报告:总 tokens、缓存效率、按项目/子代理/技能细分、带转录上下文的最昂贵提示以及缓存中断。终端风格、单文件输出,带有可排序表格和可展开的下钻视图。

暂无评论

none
暂无评论...