ce-riffrec-feedback-analysis

将原始 Riffrec 录音转化为结构化产品反馈 - 对于短捕获的快速错误报告，对于较长捕获的广泛分析，并在出现需求时移交给 ce-brainstorm。

ce-riffrec-feedback-analysis 是产品反馈消耗技能。 Riffrec 是一个单独的捕获工具，可记录同步屏幕+语音+事件会话并发出 riffrec-*.zip 包。这项技能是消费方面：它分析这些捆绑包（或任何视频/音频/会议记录文件），根据长度和意图在三个路径之间进行路由，并为录音中实际内容生成正确的工件。

TL;DR

＃＃ 问题

原始用户反馈记录不会自动简化为结构化输入：

• 长录音会被忽略 - 12 分钟的演练过于密集，无法在不进行预处理的情况下进行操作
• 多问题录音崩溃为单一修复 - 录音涵盖 4 个不同的问题，但只有第一个引起注意
• 转录中音频细微差别 - 用户所说的内容不如他们试图做的事情重要；原始转录本没有表达其意图
• 隐私泄露 — 原始屏幕截图和磁盘上的音频被意外提交
• 没有通往建设的桥梁 - 反馈存在，但没有任何东西可以将其转化为头脑风暴或计划
• 设置摩擦 — 用户想要分享反馈，但不知道如何安装捕获工具

解决方案

ce-riffrec-feedback-analysis 运行具有三个路径的路由流：

• 安装路径 — 当用户还没有录制并询问如何安装/捕获/共享时，这将显示 Riffrec 安装指南和捕获说明
• 快速错误报告 - 简短记录，单一问题，“只是转录”意图 → 一份简洁的错误报告，没有完整的工件集
• 广泛的分析 - 更长的记录或多个问题 → 带屏幕截图的结构化分析、需求形状的输出、强制移交到 /ce-brainstorm

该技能默认将原始录音、音频块、zip 内容和提取的屏幕截图仅保存在本地，不会自动提交。当可追溯性很重要并且没有敏感数据时，可以提交文本工件（分析摘要、问题分析）。

是什么让它如此新颖

1. 基于长度+意图的三路径路由

路径是根据输入实际保证的内容来选择的，而不是通过标志来选择：

• 安装 — 用户尚未录制，询问如何安装 Riffrec、捕获会话或分享反馈。该技能加载 references/install-riffrec.md 并遍历它。
• 快速错误报告 - 大约 60 秒内，单个问题，或用户明确要求“快速”、“小”或“仅转录”。输出是一份简明的错误报告；该技能会跳过完整的神器集和头脑风暴交接。
• 广泛的分析 - 更长、多个问题/需求/工作流程演练，或者用户想要需求材料。输出是带有屏幕截图的完整结构化分析；该技能始终延续到/ce-brainstorm。

当输入不明确时（到达的 zip 没有上下文），该技能会在选择之前检查记录长度和事件计数。如果仍然不清楚，它会询问用户。

2.原始工件的隐私默认设置

默认情况下，原始录音、音频块、zip 内容、会话转储和提取的屏幕截图帧仅保留在本地。除非用户明确询问并确认隐私是可接受的，否则不会提交 raw/ 和 frames/ 目录。文本/元数据工件（分析摘要、问题分析、源清单）可以在需要可追溯性时提交，并且它们不包含敏感数据。

提交文档中的存储库相对屏幕截图路径确保后续代理可以在没有绝对本地路径的情况下打开证据。

3. 单个分析器入口点 — 接受多个输入形状

所有非设置路径共享一个入口点：python scripts/analyze_riffrec_zip.py /path/to/input。接受的输入：

• Riffrec .zip 捆绑包
• .mp4 / .mov / .webm 视频
• .m4a / .mp3 / .wav 音频文件
• 会议记录 .md

这就是使该技能超越 Riffrec 的有用之处——任何记录的反馈都适合相同的管道。

4. 上下文感知输出位置

在具有 docs/brainstorms/ 的存储库中，默认输出目录为 docs/brainstorms/riffrec-feedback/，因此分析将到达下游技能（ce-brainstorm、ce-plan）期望找到需求材料的位置。快速路径覆盖临时位置，因此不会因单问题错误报告而污染存储库。

5. 用于广泛分析的复合工程输出格式

扩展路径以 references/compound-engineering-feedback-format.md 中记录的复合工程反馈格式生成输出 - 其结构可作为原始输入干净地馈送到 /ce-brainstorm 中。多个问题/要求/观察结果被分开，每个问题/需求/观察结果都有相关的屏幕截图帧和时间戳。头脑风暴收到的是一个起点，而不是一份文字记录。

6. 强制 ce-brainstorm 切换以进行广泛分析

分析落地后，扩展路径始终会继续进入 /ce-brainstorm。录音记录了用户的经历；头脑风暴澄清了要采取什么应对措施。如果没有交接，分析结果就会保存在磁盘上，没有人知道如何处理它。

快速路径跳过了交接——单个错误报告就是它自己的可交付成果。

7. 延迟引用加载

该技能仅加载所选路径的参考：install-riffrec.md 用于设置，quick-bug-report.md 用于快速，extensive-analysis.md 用于广泛。其他参考文献保持未读状态，从而使技能的运行时上下文保持较小。

简单示例

队友在您的聊天中分享了 riffrec-2026-05-04-checkout-flow.zip。你把它拖进去。

该技能检测 Riffrec zip，运行分析器来检查长度和事件计数：8 分钟、47 个事件、触摸了多个不同的 UI 表面。它会进行广泛的分析。

分析器提取：同步语音记录、事件边界处的屏幕捕获帧、带有时间戳的事件日志。它确定了 4 个不同的问题：(1) “立即购买”CTA 隐藏在移动设备上，(2) 表单验证未显示内嵌错误，(3) 确认电子邮件主题行不清楚，(4) 令人困惑的“等等，为什么跳过第 3 步？”表明流量间隙的时刻。

它在 docs/brainstorms/riffrec-feedback/2026-05-04-checkout-flow-analysis.md 处针对每个问题、相关帧和时间戳生成结构化分析。原始录制仅保留在本地。

该技能以分析为起点加载 /ce-brainstorm。头脑风暴明确首先要解决哪个问题、成功是什么样子，并生成需求文档。

何时去实现它

在以下情况下使用 ce-riffrec-feedback-analysis：

• riffrec-*.zip 到达，您想要对其采取行动
• 有人分享视频、音频或会议记录作为产品反馈
• 用户询问如何安装 Riffrec 或捕获会话以获取反馈
• 长演练记录需要成为 /ce-brainstorm 的结构化输入

在以下情况下跳过 ce-riffrec-feedback-analysis：

• 反馈仅为文本且简短 - 只需将其直接粘贴到 /ce-brainstorm 中
• 录制用于调试会话，而不是反馈 - 直接处理错误
• 您只想转录没有进一步结构的音频 - 使用转录工具，而不是此技能

用作工作流程的一部分

该技能是链的前门入口点：

recording → /ce-riffrec-feedback-analysis → (extensive) → /ce-brainstorm → /ce-plan → /ce-work
                                          → (quick)     → bug report (standalone)
                                          → (setup)     → instructions for capturing

广泛的路径始终延续到 /ce-brainstorm，因此捕获的反馈成为下游技能可以使用的真正工件。快速路径会自行生成完整的工件（错误报告），而无需进行头脑风暴。

使用独立版

该技能通常通过 Riffrec zip 或其他输入文件直接调用：

• Riffrec zip — /ce-riffrec-feedback-analysis riffrec-2026-05-04-checkout-flow.zip
• 视频文件 — /ce-riffrec-feedback-analysis demo.mp4
• 音频文件 — /ce-riffrec-feedback-analysis voice-memo.m4a
• 会议记录 — /ce-riffrec-feedback-analysis meeting-notes.md
• 设置问题 — /ce-riffrec-feedback-analysis "how do I install riffrec"（无输入文件；到设置路径的路由）

当输入不明确时（到达的 zip 没有上下文，或者路径路由信号混合），该技能会在选择之前检查长度和事件计数 - 并询问是否仍然不清楚。

＃＃ 参考

分析器：scripts/analyze_riffrec_zip.py。复合工程输出格式：references/compound-engineering-feedback-format.md。

＃＃ 常问问题

什么是 Riffrec？ 一个单独的捕获工具（github.com/kierranklaassen/riffrec），记录同步屏幕+语音+事件会话并发出 riffrec-*.zip。该技能是消耗方——它不捕获，而是分析捕获。

我必须使用 Riffrec 才能使用此技能吗？ 不需要。分析仪还接受视频（.mp4、.mov、.webm）、音频（.m4a、.mp3、.wav）和会议记录（.md）。 Riffrec 只是提供了一个带有同步事件时间戳的结构化 zip，可以产生更丰富的分析。

为什么扩展路径总是继续到 /ce-brainstorm？ 因为录音记录了用户的经历——这是证据，而不是决定。如果不继续进行头脑风暴，分析结果就会作为带有屏幕截图的记录保存在磁盘上，没有人知道要构建什么来响应。交接使反馈变得可行。

Why is the quick path different? A 30-second recording showing a single bug doesn't need the full artifact set or a brainstorm — the bug report itself is the deliverable. The user already knows what's wrong; the skill produces a concise report and stops.

什么是本地化，什么是承诺？ 原始录音、音频、zip 内容、帧默认保留在本地 — 隐私第一。当可追溯性很重要且内容安全时，可以提交文本工件（分析摘要、错误报告）。提交的文档中的存储库相对路径让后续代理可以引用本地屏幕截图，而无需绝对路径。

如果输入不明确怎么办？ 该技能首先检查长度和事件计数。如果仍然不清楚，它会询问用户哪条路径适用。提出一个问题比走错路更好。

另请参阅

• ce-brainstorm — 广泛的分析输出直接进入头脑风暴
• ce-plan — 头脑风暴的下游；接收来自录制的需求文档
• ce-debug — 当快速路径错误报告有明确的根本原因需要调查时
• Riffrec — 捕获端工具（单独的项目）