ce-riffrec-feedback-analysis

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Riffrec Feedback Analysis

Riffrec 反馈分析

Turn raw product feedback into structured evidence for downstream agents. This skill is the consumption side of Riffrec, a capture tool that records synchronized screen + voice + event sessions and emits a

riffrec-*.zip

bundle.

将原始产品反馈转化为可供下游 Agent 使用的结构化证据。此 Skill 是 Riffrec 的消费端，Riffrec 是一款录屏工具，可同步录制屏幕+语音+事件会话，并生成

riffrec-*.zip

压缩包。

Choose the path

选择路径

Route to the matching reference based on the input. Read only that reference; do not load the others.

Setup — user has no recording yet and asks how to install Riffrec, capture a session, or share feedback. Read
```
references/install-riffrec.md
```
.
Quick bug report — input is a short recording (under ~60 seconds), the user describes a single specific issue, or asks for "quick", "small", or "just transcribe". Read
```
references/quick-bug-report.md
```
. Emit one concise bug report; skip the full artifact set and brainstorm handoff.
Extensive analysis — input is a longer recording, contains multiple issues / requirements / workflow walkthroughs, or the user wants requirements or brainstorm material. Read
```
references/extensive-analysis.md
```
. Always continue into the
```
ce-brainstorm
```
skill.

When the input is ambiguous (e.g., a zip arrived without context), inspect the recording length and event count before choosing. If still unclear, ask the user which path applies before running anything heavy.

根据输入内容匹配对应的参考文档，仅读取该参考文档，无需加载其他文档。

设置 — 用户尚未录制内容，询问如何安装 Riffrec、捕获会话或分享反馈。读取
```
references/install-riffrec.md
```
。
快速 bug 报告 — 输入为短时长录屏（约60秒以内），用户描述单一特定问题，或要求“快速处理”“小问题”“仅转录”。读取
```
references/quick-bug-report.md
```
。生成一份简洁的 bug 报告；无需生成完整工件集，也无需进入头脑风暴交接环节。
深度分析 — 输入为长时长录屏，包含多个问题/需求/工作流程演示，或用户需要提取需求、获取头脑风暴素材。读取
```
references/extensive-analysis.md
```
。需始终进入
```
ce-brainstorm
```
Skill。

当输入内容模糊时（例如仅收到压缩包但无上下文），先检查录屏时长和事件数量再选择路径。若仍无法确定，需先询问用户适用哪种路径，再执行后续操作。

Common rules

通用规则

Keep raw recordings, audio chunks, zip contents, session dumps, and extracted screenshots local-only by default. Do not commit
```
raw/
```
or
```
frames/
```
directories unless the user explicitly asks and privacy is acceptable.
Text/metadata artifacts (requirements docs, analysis summaries, problem analyses, source manifests) may be committed when they are needed for traceability and contain no sensitive data.
Use repo-relative screenshot paths in any committed doc so later agents can open the evidence without absolute local paths.

默认情况下，原始录屏、音频片段、压缩包内容、会话转储和提取的截图仅保存在本地。除非用户明确要求且隐私合规，否则请勿提交
```
raw/
```
或
```
frames/
```
目录。
文本/元数据工件（需求文档、分析摘要、问题分析、源清单）若需追溯且不含敏感数据，可提交至仓库。
在所有提交的文档中使用仓库相对路径引用截图，以便后续 Agent 无需绝对本地路径即可查看证据。

Analyzer entrypoint

分析器入口

All non-setup paths share the same analyzer:

bash

python scripts/analyze_riffrec_zip.py /path/to/input

Accepted inputs: a Riffrec

.zip

, an

.mp4

.mov

.webm

video, an

.m4a

.mp3

.wav

audio file, or a meeting-notes

.md

. Use

--output-dir <dir>

to control where artifacts land. In repos with

docs/brainstorms/

, the default is

docs/brainstorms/riffrec-feedback/

. The quick path overrides the output dir to a temp location so nothing pollutes the repo.

The Compound Engineering output format used by the extensive path is documented in

references/compound-engineering-feedback-format.md

所有非设置路径均使用同一分析器：

bash

python 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/

。快速路径会将输出目录覆盖为临时位置，避免污染仓库。

深度分析路径使用的复合工程输出格式记录在

references/compound-engineering-feedback-format.md

中。