session-replay

将Claude Code会话JSONL文件转换为动画GIF终端回放

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:session-replay。
它的用途是:将Claude Code会话JSONL文件转换为动画GIF终端回放
完整的 Skill 内容见:https://321skill.com/skills/session-replay-x-4/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

‘帮我把刚才调试数据库连接问题的Claude Code会话导出成GIF,我想分享给同事看复现步骤。’,它会引导你找到会话文件并执行转换命令,最终生成一个展示从连接失败到修复成功全过程的动画GIF。或者,

对AI说:‘我需要为我们的CLI工具制作一个快速入门演示GIF。’,它可以利用你之前使用该工具的一次完整会话记录,自动生成教学动画。

介绍

这个Skill解决了开发者需要分享或复盘终端操作过程,但仅凭静态日志或截图难以直观展示动态流程的问题。它能够读取Claude Code生成的JSONL格式会话文件,自动模拟终端中的命令执行与输出过程,并生成一个动态的GIF动画,生动再现整个编码会话。

使用方式非常直接:用户只需准备好Claude Code导出的JSONL文件,通过简单的命令调用该Skill,即可生成对应的GIF文件。整个过程自动化,无需用户手动录制屏幕或拼接截图,极大简化了操作步骤。

这个Skill非常适合需要向团队演示Bug复现步骤、制作命令行工具使用教程、或者记录和分享自己解决特定技术问题过程的开发者。对于技术布道师、开源项目维护者以及需要撰写包含操作流程技术文档的人员来说,它也是一个高效的工具。

使用建议:为确保GIF动画的清晰度和可读性,建议在生成前检查原始会话中是否包含过多滚动或过于密集的输出,这可能会影响最终效果。同时,由于是模拟回放,对于依赖特定实时交互或外部网络状态的复杂命令,其回放效果可能与实际略有差异,建议在关键步骤辅以文字说明。

核心特点

与普通的屏幕录制工具或静态日志导出工具不同,它专门针对Claude Code的会话格式进行解析和动态渲染,能精准还原命令执行的时序和输出内容,生成的文件体积小且易于分享。

注意事项

不适合需要录制包含图形界面操作、复杂交互或实时网络请求响应的场景。

常见问题

支持哪些格式的输入文件?

目前仅支持Claude Code导出的JSONL格式会话文件。

生成的GIF可以调整播放速度吗?

是的,通常可以通过Skill的参数来调整回放的速度和帧率。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/session-replay-x-4/raw/index.md 读取 session-replay 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。