1实现原理 · 为什么它能做到
本体是「总管型」编排提示词：不含任何脚本，靠把每步委派给专门 skill 来跑完整条剪辑流水线；单点需求则直接路由到对应专家 skill。
.claude/skills/edit-video/SKILL.md
Use for a complete edit; route a single requested operation directly to its specialist skill.
目录内只有 SKILL.md 一个文件（后经 find 核对），所以它的能力边界 = 步骤编排 + 纪律约束 + 交付契约。
第 1 步先做媒体摸底与保源：ffprobe 探时长/流/分辨率，源片要么复制进项目 assets 要么只引用给定的本地路径。
.claude/skills/edit-video/SKILL.md
1. Inspect duration, streams, and source resolution with ffprobe. Copy the source into the project's assets or reference an explicitly provided local path.
项目统一放 video-projects/<slug>/，避免就地改写原始素材。
第 2 步是唯一的外部服务入口，且把「先读成本文档 → 复用已有转录 → 才考虑调服务 → 未授权先解释上传与费用」写成硬顺序。
.claude/skills/edit-video/SKILL.md
2. Read `docs/TOOLS-AND-API-KEYS.md` before service setup. Reuse a matching word transcript. Otherwise use the student's chosen provider; Nate defaults to `node scripts/transcribe-elevenlabs.mjs <source>`. OpenAI Whisper and local Whisper are supported workflow alternatives after transcript normalization. Check available credentials or local dependencies. Explain uploads and costs before any service call whose authorization is still missing.
这是本 skill 被判橙档的依据：服务调用写在自身主流程里，默认走仓库级 ElevenLabs helper（读 key、上传音频、消耗额度），并可选 OpenAI Whisper 或本地 Whisper。
剪辑段被显式拆成两跳：先按 ../cut-silences/SKILL.md 出 EDL 与重定时转录，再按 ../cut-mistakes/SKILL.md 做审查式口误剪辑。
.claude/skills/edit-video/SKILL.md
3. Read `../cut-silences/SKILL.md`. Produce an EDL and a retimed transcript, and render the silence pass when editing is authorized. … 4. Read `../cut-mistakes/SKILL.md`. Inspect candidates in context and preserve intentional emphasis.
第 4 步还带一条易踩坑的纪律：Match every transcript to its actual video.（转录必须与视频版本对应）
动效段同样走委派：视觉弧线交给 video-storytelling，覆盖层/节拍交给 hyperframes-video-beats，并有「写 beat sheet + 每拍一个视觉主意 + 有意回扣」的产出要求。
.claude/skills/edit-video/SKILL.md
5. Read `../video-storytelling/SKILL.md` for the visual arc and `../hyperframes-video-beats/SKILL.md` for overlays. Write a beat sheet with transcript anchors, one visual idea per beat, and deliberate callbacks.
第 6 步再指向 MOTION_PHILOSOPHY.md、../hyperframes/SKILL.md、GSAP 参考与 style-library，并要求 Localize every asset used by the composition。
质量门分两道：先跑 preflight + HyperFrames lint + 转录同步校验器并过 Studio 审看，再渲染草稿后抽帧看画面与听切点边界。
.claude/skills/edit-video/SKILL.md
7. Run preflight and HyperFrames lint from the project, plus the transcript-sync validator for anchored sub-compositions. Review Studio before the draft. … 8. Render a draft, inspect encoded frames and transitions, and listen across cut boundaries.
第 8 步把检查项列得很具体：face framing / text legibility / black frames / A/V sync，并要求失败先修再终渲。
交付是一组产物而非单个文件：成片路径、剪辑决策、重定时转录、composition，以及一份说明「检查了什么、还剩什么限制」的 VERIFY.md。
.claude/skills/edit-video/SKILL.md
Deliver the final MP4 path, edit decisions, retimed transcript, composition, and `VERIFY.md` describing what was checked and any remaining limitations.
全文最后一句点明能力边界：An automated detector proposes edits; editorial judgment remains necessary.
2核心能力
01端到端编排：从原始口播素材到已验证成片的一条主线（8 个编号步骤）
02按需分流：只做单项操作时直接进对应专家 skill，不必跑全流程
03转录经济性纪律：优先复用既有词级转录，只有缺才调服务
04服务前置的授权与成本提示（未授权前先讲清上传与费用）
05剪辑两跳委派：删沉默（EDL + 重定时转录）→ 口误审查式剪辑
06视觉叙事与节拍编排委派，并要求 beat sheet 与转录锚点
07双重质量门：静态检查（preflight/lint/transcript-sync/Studio）+ 渲染后抽帧与听切点
08交付契约包含自证文档 VERIFY.md（检查了什么、还剩什么限制）
3外部依赖
| Kind | Dependency / Endpoint |
|---|---|
| cli | ffprobe（媒体摸底：时长/流/分辨率） |
| api | ElevenLabs Scribe（默认转录服务；经仓库级 helper 上传音频取词级时间戳） |
| api | OpenAI Whisper API（替代云转录；自带 key 与计费） |
| api | Kie.ai（可选生成式 B-roll/图像素材服务，作者自述偏好而非必需） |
| cli | HyperFrames CLI（preflight / lint / preview / render，路径与用法由 ../hyperframes 与 ../hyperframes-cli skill 指路） |
| package | Node.js + 仓库级脚本（transcribe-elevenlabs.mjs、validate-beat-sync.mjs、preflight 系列） |
| network | HyperFrames Studio（本地预览服务器，渲染前人工审看） |
4管控建议与判定依据
建议配套管控措施
面向 Agent
分级或逐次授权，建议在沙箱运行
面向管理者
审批流程、可回滚、全程审计
判定依据（文件路径与关键语句摘要）
- scripts/: 执行本地脚本或命令: 本 skill 自身 0 个脚本（目录内只有 SKILL.md，find -type f 核对）
- 网络端点: 声明外部网络访问: 执行期：ElevenLabs 转录上传 —— POST 音频到 api.elevenlabs.io（经仓库级 helper；SKILL.md 第 2
- 本地工作目录: 文件读写与工件输出: video-projects/<slug>/ 下的项目文件（源片副本、assets/、BRIEF.md 或 DESIGN.md、composition
审计说明： 。本 skill 自身目录只有一个 SKILL.md（无脚本、无凭证读取代码），但它把「转录」写成自己主流程第 2 步，默认路线是仓库级 `scripts/transcribe-elevenlabs.mjs`——该 helper 读 ELEVENLABS_API_KEY 并把用户音频 POST 到 api.elevenlabs.io（素材出网 + 消耗账号额度），并给出 OpenAI Whisper（另一 key）与 Kie.ai（自备额度）两条可选外部服务路线；SKILL.md 自己还要求「Check available credentials」并「先解释上传与成本」。按统一分档『把用户素材送外部服务后端/消耗账号额度 → 橙』，且形态与同库 faceless-explainer（依赖 HeyGen 凭证完成核心功能 → 橙）、video-edit（驱动读凭证的第三方 CLI → 橙）一致。区别于同批 cut-silences / cut-mistakes（🔵）：那两个 skill 的自身代码纯本地，转录被定义为上游产物（也接受无 key 的本地 Whisper），而本 skill 把服务调用写成自己的默认步骤与成本纪律。未发现红档特征：无沙箱关闭、无 TLS 降级、无反自动化绕过、无任意代码执行面（渲染与 CLI 都在本地、参数来自本地文件）。
5第二遍独立确认
- [ok] 目录文件清单（是否真的无脚本） — find .claude/skills/edit-video -type f 仅返回 SKILL.md；无 scripts/、无 agents/、无隐藏文件。
- [ok] 被引用路径是否真实存在 — 仓库内存在 .claude/skills/{cut-silences,cut-mistakes,video-storytelling,hyperframes-video-beats,hyperframes,style-library}/SKILL.md、docs/TOOLS-AND-API-KEYS.md、MOTION_PHILOSOPHY.md、scripts/transcribe-elevenlabs.mjs —— 委派链与文档依赖均非空指。
- [ok] 转录 helper 的凭证与端点（橙档证据） — scripts/transcribe-elevenlabs.mjs 定位到：ELEVENLABS_API_KEY 三别名 env 读取 + .env 兜底、POST https://api.elevenlabs.io/v1/speech-to-text、请求头 xi-api-key、timestamps_granularity=word、ffmpeg 抽 16kHz 单声道 mp3 上传。
- [ok] 「可选服务」是否被误判为主线 — Kie.ai 在 docs 中被标为 Optional，且明确 the kit does not bundle a universal Kie generation script；本 skill 的 SKILL.md 未直接点名 Kie，只写『学生自选 provider』——已按可选路径写入 external_deps 并在 reason 里附条件说明。
- [ok] 自动化边界是否夸大 — SKILL.md 末句 『An automated detector proposes edits; editorial judgment remains necessary.』，与 cut-mistakes 的 review-gate 设计一致，无夸大。
- [ok] 红档特征反查 — 全文无 sandbox 关闭、无 --no-verify/TLS 降级、无 AutomationControlled/反爬绕过、无下载并执行远端代码的指令；渲染与校验均为本地 CLI。
6结论
适合： 适合：手里有口播原片、想一遍跑完「转录 → 删沉默 → 删口误 → 视觉叙事 → 动效 → 渲染 → 验证」的创作者或团队；也适合把它当管线骨架，按需替换其中的转录 provider 或动效 skill。
不适合： 不适合：不想让素材离开本机（应先改本地 Whisper 路线并复核）、只要单一操作（description 已提示直接走专家 skill）、以及没有 Node/ffmpeg/Chromium 环境的机器。
Install Agent-Ready
① Verified Mirror 2026-09-28
Option A · Direct DownloadDownload edit-video.tar.gz
sha256:
Option B · Copy Guide for Agentec3a3991479999f4…agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。
② Upstream GitHub
GitHub Repo ↗
Pinned to commit 0d30152a82.