AI Skills
ce-riffrec-feedback-analysis

ce-riffrec-feedback-analysis

熱門

分析來自打包檔或單獨錄製檔的 Riffrec 回饋擷取內容。只要遇到 `riffrec-*.zip`、`session.json` + `events.json` + `recording.webm` + `voice.webm` 打包組合、`.mp4`/`.mov`/`.webm` 影片、`.m4a`/`.mp3`/`.wav` 音訊，或是擷取/分享需求時，一律載入此 Skill。

2.4萬星標
1961分支
更新於 2026/8/6
獲取技能源代碼

相關技能

homelab-vlan-segmentation24萬backend-code-review15萬pr-triage8.1萬
SKILL.md
唯讀
名稱
ce-riffrec-feedback-analysis
描述

分析來自打包檔或單獨錄製檔的 Riffrec 回饋擷取內容。只要遇到 `riffrec-*.zip`、`session.json` + `events.json` + `recording.webm` + `voice.webm` 打包組合、`.mp4`/`.mov`/`.webm` 影片、`.m4a`/`.mp3`/`.wav` 音訊，或是擷取/分享需求時，一律載入此 Skill。

Riffrec Feedback Analysis

將原始產品回饋轉化為結構化的事證，供下游 Agent 使用。本 Skill 屬於 Riffrec 的消費端，Riffrec 是一套擷取工具，能同步錄製螢幕、語音與事件 Session，並輸出 riffrec-*.zip 打包檔。

選擇路徑

根據輸入內容分流至對應的參考文件。只讀取該份參考文件，請勿載入其他檔案。

  • Setup — 使用者目前尚無錄影，詢問如何安裝 Riffrec、擷取 Session 或分享回饋。請讀取 references/install-riffrec.md。
  • Quick bug report — 輸入檔為短錄音/錄影（約 60 秒以內）、使用者僅描述單一具體問題，或要求「快速（quick）」、「簡短（small）」、「只需轉寫（just transcribe）」。請讀取 references/quick-bug-report.md。請輸出單份精簡的 Bug 報告，跳過完整的產物集合與 brainstorm 接續流程。
  • Extensive analysis — 輸入檔為較長錄製檔、包含多個問題 / 需求 / 工作流程操作示範，或是使用者需要需求文件或腦力激盪素材。請讀取 references/extensive-analysis.md。後續請一律接續執行 ce-brainstorm Skill。

當輸入內容不明確時（例如收到 Zip 檔但缺乏情境說明），請在選擇路徑前先檢查錄製檔長度與事件數量。若依然無法判斷，請先詢問使用者適用哪條路徑，再執行任何重型分析。

通用規則

  • 預設情況下，請將原始錄製檔、音訊片段、Zip 檔案內容、Session Dump 以及擷取的螢幕截圖保留在本地。除非使用者明確要求且符合隱私規範，否則請勿 Commit 提交 raw/ 或 frames/ 目錄。
  • 文字/詮釋資料（Metadata）產物（需求啟動素材、分析摘要、問題分析、來源清單）只要在需要追溯且不含敏感資料的前提下，皆可進行 Commit 提交。
  • 在任何已提交的文件中，螢幕截圖路徑請一律使用相對專案庫（Repo-relative）路徑，以利後續 Agent 開啟佐證資料，避免使用本地絕對路徑。

分析器入口

所有非 Setup 路徑皆共用同一個分析器，該指令碼部位於本 Skill 的 scripts/ 目錄下。由於 Bash 工具的工作目錄為使用者的專案目錄而非 Skill 目錄，直接使用 scripts/<name> 路徑將無法解析。請在同一條命令中，將 SKILL_DIR 設定為載入此 ce-riffrec-feedback-analysis SKILL.md 所在的絕對路徑來呼叫（Shell 狀態不會跨 Bash 呼叫持久化）：

SKILL_DIR="<absolute path of the directory containing this 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 固定的產出規範。快速路徑（Quick path）會將輸出目錄覆寫為暫存位置，以免污染專案庫。

Extensive 路徑所採用的 Compound Engineering 輸出格式已記錄於 references/compound-engineering-feedback-format.md。