analyze_riffrec_zip.py一条命令把 Riffrec 反馈 zip 变成需求材料【免费下载链接】compound-engineering-pluginOfficial Compound Engineering plugin for Claude Code, Codex, Cursor, and more项目地址: https://gitcode.com/GitHub_Trending/ev/compound-engineering-plugin用户丢来一个 Riffrec 录屏 zip要你还一份分析。手工转写、挑帧、整理证据既慢又乱。compound-engineering-plugin 的 analyze_riffrec_zip.py 一次把反馈 zip 拆成转写文本、关键截图和候选问题清单。动手前的三件事确认输入形态。脚本吃四种源Riffrec zip、已解压目录必须含session.json和events.json两个标记文件、独立视频/音频、会议笔记txt/md。路径先ls一眼再传。备好可选依赖。Python 3 标准库即可跑要抽帧需装ffmpeg要转写需设OPENAI_API_KEY。缺依赖不会报错中断对应环节会标记 skipped。想清楚产物落在哪。默认有docs/brainstorms时写到docs/brainstorms/riffrec-feedback/源名/否则写./riffrec-feedback/源名/。不想随默认走就加--output-dir。一条命令完成分析这条命令会解压 zip、转写音频、抽帧并写出三个 markdown 产物python3 skills/ce-riffrec-feedback-analysis/scripts/analyze_riffrec_zip.py /path/to/capture.zip加上--output-dir和--topic可以把产物钉到指定目录并给需求文档 frontmatter 一个 kebab-case 主题python3 skills/ce-riffrec-feedback-analysis/scripts/analyze_riffrec_zip.py capture.zip \ --output-dir docs/brainstorms/riffrec-feedback/checkout-bug \ --topic checkout-ux纯文本源会议笔记或不想转写时跳过媒体处理、限制截图数量python3 skills/ce-riffrec-feedback-analysis/scripts/analyze_riffrec_zip.py notes.md \ --no-transcribe --max-moments 8脚本内部做了什么整个流程按顺序分五段全部在 skills/ce-riffrec-feedback-analysis/scripts/analyze_riffrec_zip.py 里✅ 输入校验classify_source确认路径存在且是文件或目录解压目录必须含session.json、events.jsonzip 解压逐个成员做路径安全检查逃逸目的目录直接拒绝视频/音频优先用 ffprobe 判断探测失败退回扩展名 归一化快照源文件复制进临时 staging 目录验证通过后原子移动就位。中途失败会清掉临时目录❌ 不会留下半截产物覆盖旧内容。 转写调 OpenAI 转写接口音频超过单段上限时自动按 420 秒切块逐段转超时只降级不中断。 挑时刻对点击事件、400 请求、console 报错、同目标 8 秒内连点加权打分过滤 mini-profiler、vite 心跳等噪音 URL按时间排序去重最多取--max-moments默认 12个。 写产物analysis.md源概况、转写、时刻表、候选发现 F1 起编号、requirements-kickoff.md带 frontmatter 的需求骨架、source-materials.md证据清单全部用仓库相对路径。报错时的排查路径Unsupported source path type / 扩展名不认识先确认路径存在没有 ffprobe 时视频判断退回扩展名补装 ffmpeg 再跑。Unpacked Riffrec capture must contain session.json, events.json解压目录缺标记文件改用原始 zip 传参最省事。contains a symlink / Unsafe zip member path输入里有符号链接或 zip 条目路径越界脚本出于安全整体拒绝换一份干净导出的录屏。status: skipped 或 ffmpeg not installed缺 API key 或缺 ffmpeg对应环节被跳过检查环境变量或用--no-transcribe明确只要文本。拿到产物之后整个输出目录raw 快照 frames 截图 三个 md是自带证据链的包直接喂给/ce-brainstorm确认需求。截图和转写互相关联把目录整体压缩发给同事即可复现你的分析上下文无需额外解释。换环境后重新 clone 仓库执行同一条命令即可再跑一遍产物路径规则完全一致。脚本本体在 skills/ce-riffrec-feedback-analysis/scripts/analyze_riffrec_zip.pyskills/ce-sweep/scripts/analyze_riffrec_zip.py 是 ce-sweep 技能下的同名副本用法相同技能说明见 skills/ce-riffrec-feedback-analysis/SKILL.md。【免费下载链接】compound-engineering-pluginOfficial Compound Engineering plugin for Claude Code, Codex, Cursor, and more项目地址: https://gitcode.com/GitHub_Trending/ev/compound-engineering-plugin创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考