分析来自打包文件或独立录屏/录音的 Riffrec 用户反馈。当遇到 `riffrec-*.zip`、`session.json` + `events.json` + `recording.webm` + `voice.webm` 打包资源，`.mp4`/`.mov`/`.webm` 视频，`.m4a`/`.mp3`/`.wav` 音频，或收到采集/分享反馈请求时，务必加载此 Skill。
Riffrec 反馈分析
将原始的产品反馈转化为下游 Agent 可用的结构化证据。本 Skill 对应 Riffrec 的消费处理端。Riffrec 是一款反馈采集工具，可同步录制屏幕、语音和事件操作，并输出 riffrec-*.zip 打包文件。
选择处理路径
根据输入内容路由到相匹配的参考文档。仅读取对应的参考文档，切勿加载其他无关文档。
- 环境配置 (Setup) —— 用户尚未录制任何内容，询问如何安装 Riffrec、录制会话或分享反馈。请读取
references/install-riffrec.md。 - 快速 Bug 报告 (Quick bug report) —— 输入为短录音/短视频（约 60 秒以内）、用户仅描述了一个具体问题，或要求“快速”、“简单处理”、“仅转录”。请读取
references/quick-bug-report.md。输出一份简明扼要的 Bug 报告；跳过全量产物生成和头脑风暴交接环节。 - 深度分析 (Extensive analysis) —— 输入为较长的录屏/录音，包含多个问题、需求或完整的工作流演示，或者用户需要提炼需求/头脑风暴素材。请读取
references/extensive-analysis.md。处理完成后务必继续衔接到ce-brainstormSkill。
当输入信息不够明确时（例如直接收到一个 zip 文件但缺乏上下文），请先检查录音时长和事件数量再作选择。如果依然无法确定，在执行任何重度任务前先询问用户适用哪条路径。
通用规则
- 默认将原始录屏、音频分块、zip 解压内容、会话 Dump 以及提取出的截图保留在本地。除非用户明确要求且确认不涉及隐私问题，否则切勿提交
raw/或frames/目录。 - 文本与元数据产物（如需求启动素材、分析摘要、问题分析报告、数据源清单）在需要追溯且不含敏感数据时，可以提交至仓库。
- 在任何已提交的文档中，截图路径请统一使用相对于仓库的相对路径，以便后续 Agent 能够直接打开证据图片，而不会依赖本地绝对路径。
分析器入口
所有非配置路径均共享同一个分析器，该脚本位于本 Skill 的 scripts/ 目录下。请注意，Bash 工具的当前工作目录是用户的项目路径，而非 Skill 所在目录，因此直接调用 scripts/<name> 会无法解析。请使用该 Skill 本身的绝对路径来调用：在同一个命令中将 SKILL_DIR 设置为你加载本 ce-riffrec-feedback-analysis SKILL.md 时所在的目录（因为 Shell 状态在多次 Bash 调用之间不会持久化）：
SKILL_DIR="<绝对路径，指向包含此 SKILL.md 的目录>";
python "$SKILL_DIR/scripts/analyze_riffrec_zip.py" /path/to/input
支持的输入格式：Riffrec .zip 包、.mp4 / .mov / .webm 视频、.m4a / .mp3 / .wav 音频文件，或会议记录 .md 文件。使用 --output-dir <dir> 参数可控制产物存放目录。在包含 docs/brainstorms/ 的仓库中，默认产物路径依然为 docs/brainstorms/riffrec-feedback/（作为已文档化的证据/启动产物特例；这并不是 ce-brainstorm 的持久化输出规范）。快速路径会覆盖输出目录并指向临时路径，确保不会污染仓库。
深度路径所使用的 Compound Engineering 输出格式详见 references/compound-engineering-feedback-format.md。
