关于 agent-wrapped
Agent Wrapped 可将本地 Agent 使用历史整理成视频,供用户回顾会话、常见纠正和使用画像。统计与渲染均在本地进行,不会上传数据。
主要功能
- 01统计支持的 Agent 会话
- 02按纠正内容归纳重复问题
- 03生成可编辑的使用总结
- 04本地渲染总结视频
- 05支持纵向或方形视频
适用场景
- 01回顾一段时间内的 Agent 使用情况
- 02把重复纠正整理成规则
- 03生成用于分享前检查的视频总结
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ vkpdeveloper/ agent-wrapped --skill agent-wrapped安装后在 Claude Code 中输入/agent-wrapped确认已加载。
附带文件wrapped.sh
详细介绍
Agent Wrapped
通过此文件旁边的 wrapped.sh 运行所有操作。首次使用时,它会从 GitHub 下载适用于当前操作系统和 CPU 的最新 agent-wrapped 版本到
~/.local/share/agent-wrapped(下载大小为 40 到 60 MB),并且每天最多检查一次是否有更新版本,因此切勿手动安装任何内容。每台机器上的第一个视频还会下载 Chrome Headless Shell,因此请预留几分钟。
所有内容都在本地读取和渲染,不会上传任何内容。
1. 读取历史记录
<skill-dir>/wrapped.sh stats -o "${TMPDIR:-/tmp}/wrapped.json"
它会查找所有具有本地历史记录的受支持 Agent,按会话数排序,并打印一行摘要。如需其他年份,请添加 --year 2025;如果用户为第一张卡片提供了姓名,请添加 --name "..."。JSON 中包含提示词摘录,因此请将其保存在临时目录中,切勿放入项目目录。
2. 编写经验教训
阅读 JSON 中的 corrections.samples:其中是用户曾对 Agent 提出异议的真实提示词。按 Agent 屡次出错的方面进行归类,并编写最多 3 条 lessons,按出现频率从高到低排列:
rule:用户可以粘贴到 CLAUDE.md 或 AGENTS.md 中的一条指令,最多 8 个词,使用祈使语气并且具体(“Use bun, never npm”“Run the tests before saying done”“Ask before deleting files”)。count:这条规则适用的样本数量。请如实统计;视频会显示该数字。
跳过仅出现一次的抱怨,以及提及某个人、客户或机密的内容。如果某种模式没有重复出现,请将 lessons 留空。可以润色 persona.line,但必须保持其计算出的数字不变。保存编辑后的 JSON。
3. 渲染
<skill-dir>/wrapped.sh render "${TMPDIR:-/tmp}/wrapped.json" -o ~/Desktop/agent-wrapped-<year>.mp4
如果 ~/Desktop 存在,则使用它;否则使用当前目录,除非用户指定了其他位置。X 或 LinkedIn 信息流使用 --format square(1080x1080);Stories、Reels 和 TikTok 默认使用竖版(1080x1920)。
报告
提供视频路径、关键数字(小时数、会话数、排名第 1 的 Agent)、人物设定和经验教训。询问是否要将这些经验教训添加到他们的 CLAUDE.md 或 AGENTS.md 中。提醒他们,视频会显示项目名称和高频短语,因此发布前应先观看。