菜单
视频拉片 skill：将一个视频经 MiniMax-M3 整段理解、本地文本定位、受限视觉搜索、自适应抽帧与图片证据回写核验，产出可供 remix 消费的 video_* 拉片包。Use when user mentions 拉片, 拆视频, 视频拆解, 分析视频, 逐帧分析, 分镜, 视频取证, 怎么剪, 视频结构分析, breakdown, video breakdown, transcript extraction. 只需要普通视频总结时，选择当前环境可用的视频理解或总结能力，不走本 skill。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Git 提交：在用户明确要求提交时，轻量安全复核变更、精确暂存、运行相关验证并创建真实 Conventional Commit；只做本地提交，推送与对外发布由 507-release 承接。Use when user says commit, 提交, 提交一下, 提交这些改动, 提交代码, Git 提交, commit 一下, 生成并执行提交, 准备提交, 存个档。
对外发布：在用户明确要求发布、推送或发版时，定版本号、打 tag、推送远端，并按项目实际探测的发布渠道（npm、GitHub Release）发布。每个不可逆对外动作执行前都向用户显式确认。Use when user says release, publish, push, 发版, 发布, 推送, 发包, 打 tag, 升版本, 升级版本号, 发新版本, 上线, 发到 npm, 发 GitHub Release。默认只做用户明确点名的对外动作，不自动扩到全部渠道。
根因修复：已明确存在 bug、报错、崩溃、异常、回归或合并冲突时，先建立可重复反馈环，再以最小改动修复根因并验证。Use when user says fix, 修一下, 修 bug, 报错了, 崩了, 跑挂了, 有 bug, 修复报错, 合并冲突, 修复冲突, 修不通, debugging, error, crash, regression.
维护项目地图：以当前代码为证据，建立或校准 README、doc 组织、目录职责、入口与上下游，只修改地图文档。Use when user says map, project map, 梳理项目结构, 项目结构, 更新 README, 补 README, 校准 README, 整理 doc, 整理结构, 文档地图, 目录职责, 分层 README.
交付审查：围绕明确的 commit、branch、diff 或路径检查 Standards、Spec 与 Code Quality，只报告问题、证据和路由。Use when user says review this change, code review, review 一下, 检查, 审查, 审查改动, 审查这次改动, 检查提交, 检查分支, 过一遍代码, 把关, 需求符合度, 交付审查. 不用于主动寻找全库架构机会。
在保持公开契约与可观察行为不变的前提下，对指定代码范围或 507-inspect 报告逐项建立证据、修改并验证。可深入内部模块、抽象与接缝；若需要行为变化则停止并路由到需求实施。Use when user mentions simplify, simplify code, 简化, 简化代码, 行为不变重构, 内部简化, 按报告修改, 处理 inspect 报告, 局部重构, 降低复杂度, 收敛架构摩擦。
| name | 507-breakdown |
| description | 视频拉片 skill：将一个视频经 MiniMax-M3 整段理解、本地文本定位、受限视觉搜索、自适应抽帧与图片证据回写核验，产出可供 remix 消费的 video_* 拉片包。Use when user mentions 拉片, 拆视频, 视频拆解, 分析视频, 逐帧分析, 分镜, 视频取证, 怎么剪, 视频结构分析, breakdown, video breakdown, transcript extraction. 只需要普通视频总结时，选择当前环境可用的视频理解或总结能力，不走本 skill。 |
| compatibility | Requires Python 3.10+, ffmpeg/ffprobe, faster-whisper, and MiniMax_API_KEY; yt-dlp for URLs and Tesseract for optional OCR. |
把一个视频编译成可核验、可复用的拉片包。它不是快速总结：MiniMax-M3 先理解整段视频，本地证据再确认关键时间与画面。
一次处理一个 URL 或本地视频，输出到 05-视频拉片/<video-id>/：
video_meta.md
video_transcript.md
video_breakdown.md
video_breakdown.json
raw/video_manifest.json
analysis/video_understanding_minimax.json
analysis/video_locations.json
analysis/video_frame_observations.json
analysis/video_analysis_brief.md
只接受新 video_* 契约；不兼容旧包。
MiniMax_API_KEY 读取密钥，不读取 .zshrc。video_breakdown.*。video_validate_breakdown.py --workspace ... 通过后才标记 video_completed。M3 的时间、顺序与方向只作未验证参考。最终时间窗只能来自本地 ASR、OCR、带 PTS 的帧与 scene-cut；没有证据不得猜时间。
M3 是默认必经阶段；失败时命令非零退出并保留工作区。只有显式 --force-local-fallback 才可跳过 M3 整段视频理解，改走本地 locator + 自适应抽帧降级；但图片理解仍需 MiniMax_API_KEY，未导出密钥时无法完成。完成包必须记录 forced_local_fallback 与限制。
python3 scripts/video_pull.py run --video <url-or-path> --output-dir 05-视频拉片
python3 scripts/video_validate_breakdown.py --workspace 05-视频拉片/<video-id>
脚本均使用小写 snake_case，视频流水线文件以 video_ 开头。详情见 scripts/README.md 与 references/analysis-playbook.md。
raw/video_manifest.json 为 video_completed，最终时间窗均有本地证据，降级路径与限制已记录。05-视频拉片/<video-id>/ 下可核验、可复用的新 video_* 拉片包。507-mine；需要借鉴叙事、镜头、字幕或节奏手法时进入 507-remix；两类目标同时存在时可分别接力；只需要拉片证据时直接结束。video_completed，也不把不完整包交给下游。