507 breakdown

Skill ssdiwu/507-skills/write/507-breakdown

Workflow-oriented Agent Skills for writing, coding, research, and decision alignment.

Install

npx -y skills add ssdiwu/507-skills --skill 507-breakdown

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

24 days oldThe repository was created 24 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.
1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

视频拉片 skill：将一个参考视频经 MiniMax-M3 整段理解、本地文本定位、受限视觉搜索、自适应抽帧与图片证据回写核验，产出可供 remix 消费的 video_* 拉片包。Use when user mentions 拉片, 拆视频, 视频拆解, 分析视频, 逐帧分析, 分镜, 视频取证, 怎么剪, 视频结构分析, breakdown, video breakdown, transcript extraction. 只需要普通视频总结，或只想把自己的录像作为成片素材时，不走本 skill。

SKILL.md

3.9 KB, as published. Nobody here has run it

视频拉片（breakdown）

把一个视频编译成可核验、可复用的拉片包。它不是快速总结：MiniMax-M3 先理解整段视频，本地证据再确认关键时间与画面。

这个 skill 面向参考视频取证。用户自己的录像、截图或配音只需要进入成片时，由 507-video 直接做素材核验和制作；不要为了登记素材先跑完整拉片。

输入与产物

一次处理一个 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_* 契约；不兼容旧包。

流程

取得视频与本地 ASR、scene-cut、OCR 证据。
默认调用 MiniMax-M3 整段理解；从环境变量 MiniMax_API_KEY 读取密钥，不读取 .zshrc。
用 ASR/OCR 命中定位语义锚点；每 10 秒 locator、PTS 帧和 scene-cut 仅提供受限视觉搜索点，须由图片锚点命中回写定位。
对候选窗口有界加密抽帧（默认 2fps），并对关键帧做图片理解；接受带 Markdown（标记语言）围栏的 JSON（数据格式）响应，严格校验回显锚点、肯定可见性与非空证据，但不要求证据逐字复述锚点。
汇总分析简报；agent 基于本地证据填写最终 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。

完成与接力

完成信号：validator（校验器）通过，raw/video_manifest.json 为 video_completed，最终时间窗均有本地证据，降级路径与限制已记录。
产物：05-视频拉片/<video-id>/ 下可核验、可复用的新 video_* 拉片包。
候选出口：需要挖内容判断、观点或写作碎片时进入 507-mine；需要借鉴叙事、镜头、字幕或节奏手法时进入 507-remix；两类目标同时存在时可分别接力；成熟创作包再由 507-remix 交给 507-video，不要把原始拉片包直接当制作合同；只需要拉片证据时直接结束。
回退条件：M3、图片理解或本地证据不足时保留未完成工作区并报告限制，不标记 video_completed，也不把不完整包交给下游。