voice-debrieflisted
Install: claude install-skill realwooolf/voice-debrief
# 面试复盘
根据传入的文件类型自动判断执行阶段：
- 传入音频文件（.wav / .m4a / .mp3）或视频文件（.mp4）→ 执行阶段一：本地转录
- 传入 PDF 文件（已有转录文本）→ 执行阶段二：整理并输出结果
> **注意：** Claude Code 不支持直接上传音频/视频文件。请粘贴文件路径，或截图文件所在位置（如 Finder 窗口底部会显示完整路径），例如：
> `帮我整理这场面试 /Users/xxx/Desktop/某公司二面.mp3`
**多文件处理：** 如果用户传入多个音频/视频文件，在阶段一完成后自动执行阶段零（多文件合并排序），再进入阶段二。单文件则跳过合并直接处理。
---
## 前置依赖
使用前确保以下工具已安装：
```bash
# 转录（二选一���按平台选）
pip install mlx-whisper # Apple Silicon Mac 用，GPU 加速，推荐
pip install openai-whisper # 其他平台 fallback
# 音视频处理（whisper 内部依赖 ffmpeg 解码音频）
# macOS
brew install ffmpeg
# Ubuntu / Debian
sudo apt install ffmpeg
# Windows
# 前往 https://ffmpeg.org/download.html 下载，或用 winget install ffmpeg
```
**平台说明：**
- Apple Silicon Mac（M1/M2/M3/M4）→ 使用 mlx-whisper，速度快 5-10 倍
- Intel Mac / Windows / Linux → 自动 fallback 到 openai-whisper（CPU 模式）
---
## 飞书配置
若选择保存到飞书，需要先完成以下一次性配置。选本地保存可跳过此章节。
### 第一步：创建飞书自建应用
1. 打开 [open.feishu.cn](https://open.feishu.cn)，登录你的飞书账号
2. 点击右上角「开发者后台」→「创建应用」→ 选「自建应用」
3. 填写应用名称（随意，如 `interview-debrief`）和描述，创建完成
### 第二步：开启权限
1. 进入应用后，左侧菜单点「权限管理」
2. 点击「**批量导入/导出权限**」→「导入」，将以下 JSON 粘贴进去，点「下一步，确认新增权限」：
```json
{
"scopes": {
"user": [
"docx:document",
"bitable:app",
"docs:doc",
"docs:doc:readonly",
"docs:document:import",
"drive:drive",
"drive:file",
"wiki:wiki"
]
}
}
```
3. 确认后权限全部生效（测试企业环境下免审核）
### 第三步：添加回调地址
1. 左侧菜单点「安全设置」
2. 找到「重定向 URL」，点击添加，填入：
```
http://localhost:9998/callback