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 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/session-replay-x-4/raw/index.md(查看排版版本)