1实现原理 · 为什么它能做到
本条目是 Codex Plugin 合集（6 个业务 Skill）而非单文件 skill：主入口取「剪口播」chengfeng-cut，它与字幕/画面/导出/上报/更新检查并列注册，共同的边界写在内部 references 里，不占用用户入口。
plugins/chengfeng-videocut/.codex-plugin/plugin.json
Six task-facing chengfeng-videocut Skills: cut, subtitle, visual, export, safe bug reporting, and Marketplace update checks. Shared product boundaries are internal references, not a user-facing Skill.
注：plugin.json 的 "skills": "./skills/" 指向 plugins/chengfeng-videocut/skills/ 下 6 个 SKILL.md；主入口按 defaultPrompt[0]「使用 $chengfeng-videocut:chengfeng-cut 剪掉这条视频里的口误，审核后生成删词账本。」与 plugin README 能力边界表首行（剪口播 → chengfeng-cut）取 chengfeng-cut，skill.path 即该目录。
主入口只做语义判断与编排：它明确不产出媒体，唯一产物是一份人工复核过的删词账本（Cuts + EDL），时间/媒体/状态的真值都在产品 Runtime。
plugins/chengfeng-videocut/skills/chengfeng-cut/SKILL.md
**不切媒体**：账本改一次是几十毫秒，切一次是一个不可撤销的文件。到本 Skill 结束，
注：紧接下一行「磁盘上没有任何新视频。Skill 做语义判断与编排；产品 Runtime 是项目、Cuts 和 Studio 状态的唯一写入者。」——媒体写入被整体移出 skill 层。
所有状态变更走 Product CAS：先 readback 拿 revision，再用 --expected-revision 提交候选，提交后立即再次 readback 校验 stage 与项目/Cuts/EDL 三个 revision。
plugins/chengfeng-videocut/references/business-workflow-contract.md
使用上一步 readback 的 expected revision 调用 `cuts set`、`artifact put` 或 Product transition；随后立即 readback，确认 Product 返回的新 revision 与预期 stage。
注：同一合同表还规定 revision_conflict 或 readback 不匹配时「停止、展示差异、重新提案/审核；不覆盖」，即失败即停而不是重试覆盖。
删词判断的唯一合法输入是产品给的「播放顺序」视图（transcript playback），禁止 agent 自己拼 transcript.json——那会把跳号静默读成缺内容。
plugins/chengfeng-videocut/skills/chengfeng-cut/SKILL.md
**判断只用 `transcript playback` 的播放顺序，不许自己从 `transcript.json` 拼**
注：references/semantic-deletion.md 记了两次真实错法（按原段号分组、把压缩停顿也标成删过），结论是「判据没错，输入撒了谎，而且是静默的」。
删词被切成五轮单判据扫描（重复 / 残句改口 / 口误重说 / 英文卡壳 / 口头禅），每轮只带一个判据、只记一类，冲突留到汇总解决。
plugins/chengfeng-videocut/skills/chengfeng-cut/SKILL.md
把播放顺序完整读五遍，每遍只带一个判据。
注：理由在同段：「一次带一个判据去读，判断质量远高于一次带六个；每轮产出小、可检查」。
汇总产出两张表并强制自读：删词汇总表 + 重复句子表，AI 自己按表通读删后全文，读不通就撤销（两态，不设『建议删除』第三态）。
plugins/chengfeng-videocut/skills/chengfeng-cut/SKILL.md
这是复核的定义：AI 自己再看一遍，不是拿去问用户；拿不准 = 不列（两态）。
注：两张表都带风险列（低/高）；长句、整句、分叉重说必须高风险复核。
人工复核环节把 UI 打开做成项目级绑定 + 能力门禁双重校验：URL 的 #project/<projectId> 必须与 readback 一致，且 ensure-studio 返回 ok=true 才开页面。
plugins/chengfeng-videocut/skills/chengfeng-cut/SKILL.md
- 打开前把 `productUrl` 的 `#project/<projectId>` 与 readback 的 `projectId` 严格比对，
注：同段还绑定 stage=cut_review_ready 与三个 revision，并声明「门禁 ok=true 只证明产品面能力，不能替代项目级绑定」。
交棒后做复盘沉淀：用留存的提案文件与终版账本 diff，把差异归档成三抽屉（口味偏好 / 专名词典 / 规则空白）。
plugins/chengfeng-videocut/skills/chengfeng-cut/SKILL.md
- 口味差异 → `~/.chengfeng-videocut/cut-preferences.md` 追加（Agent 维护的
注：偏好文件与词典是用户级 markdown，Agent 只追加/改写自己的节；专名错误进 dictionary.md，规则空白记「待升级判例」，同类第三次才建议升级进通用判例。
结论分级被写成硬门禁：API/readback PASS、visual frame PASS、human listening PASS 三档互不替代，没人真的听过就必须报 UNVERIFIED。
plugins/chengfeng-videocut/references/business-workflow-contract.md
没有真实人类听音记录时，必须报告 **human listening UNVERIFIED**；不得声称 PASS。若本轮没有真实 UI 路径，visual frame 也必须是 UNVERIFIED，而不是由静态测试代替。
注：导出 SKILL.md 进一步写明「预览和成片是两条渲染路径」，禁止用预览截图当成片证据。
环境逻辑被集中到唯一一个 Skill：业务 Skill 第 0 步只引用 check-updates 的「就绪检查」，结果只有三态。
plugins/chengfeng-videocut/skills/chengfeng-check-updates/SKILL.md
三步走完，输出三态之一：**就绪 / 需新会话 / 停**。
注：该 Skill 自述「环境的一切逻辑只写在本 Skill……环境策略要变，只改这一个文件」；停态附反事故禁令：禁止自制审核页/播放器替代产品界面。
Skills 更新是「发现」与「改变安装」两事务：检查阶段只在临时 CODEX_HOME 里用官方 stable 解析候选，对用户 HOME 零 codex 调用、零写入。
plugins/chengfeng-videocut/skills/chengfeng-check-updates/SKILL.md
正常检查只允许在临时 `CODEX_HOME` 中用官方 `stable` 发现候选；对用户
注：代码侧证据：check-plugin-update.cjs 的 stageCandidate() 以 isolatedEnv = { ...process.env, CODEX_HOME: codexHome } 执行 `plugin marketplace add … --ref stable` 与 `plugin marketplace upgrade`；候选需 version + 40-hex B(snapshotRevision) + 40-hex A(contentRevision) + SHA-256 四项一致。
激活只走官方 Codex 命令并可回滚：用户确认四项身份后，脚本重新 stage 比对 --expected-*，再 remove → add --ref <B> → upgrade，并从 cache 复读验证。
installer-manifest.json
"codex plugin marketplace add",
注：installer-manifest.json 的 allowedCommands 把可用命令白名单固定为 7 条 codex plugin 命令；SKILL.md 规定 B 必须是 40-hex snapshotRevision，stable/分支/tag/短 SHA 一律 marketplace_ref_unsafe。
2核心能力
01口播建档与状态 readback（project create + workflow get + cuts get，两份 readback 必须同一 projectId）
02词典修字闸门：通用词典 + 用户词典两遍过闸，产出修字表；只改文字不动时间/词数/wordId
03五轮单判据语义删词（重复 / 残句改口 / 口误重说 / 英文卡壳 / 口头禅），每轮只记一行 wordIds+类型+风险
04两张表汇总 + 自读校验（删词汇总表、重复句子表），两态无第三态
05Studio 人工复核编排：先呈表再开页，幂等 ensure-running → open 取产品 URL → ensure-studio 能力门禁
06复盘归档：提案 vs 终版 diff，分三抽屉沉淀用户偏好与专名
07字幕段：按账本算剪后时间，一屏存词 id 列表 + 显示文字，不存秒数
08画面段：HTML 层绑字幕屏（--cues），抽帧看画面、像素差找运动窗口，风格只从注册表选
09导出段：账本切片段 + 推近 + 字幕 + HTML 层一次烧成 mp4，四段进度 assemble→overlay→compose→verify
10Bug 上报段：脱敏草稿 → 用户确认令牌 → gh issue create，固定仓库与 label
11更新/环境段：就绪检查、Runtime 安装与体检、Skills 可回滚激活
3外部依赖
| 类型 | 依赖 |
|---|---|
| cli | codex（OpenAI Codex CLI） |
| cli | git |
| cli | gh（GitHub CLI） |
| cli | curl |
| network | GitHub Releases（Runtime 制品与 install.cjs） |
| network | 官方 Codex Marketplace 源（Git） |
| network | 本地 Studio / Product Runtime（loopback 常驻服务） |
| cli | node ≥ 20 / ffmpeg ≥ 6 / ffprobe / Google Chrome |
| api | 云端 ASR（火山引擎，凭证由 Runtime 保存） |
| package | MCP 运行时依赖（plugin 包） |
4风险提醒 风险提醒：橙色 · 评估后使用
风险提醒：橙色 · 评估后使用
- 会下载并执行远程安装器（远程代码执行面） — ensure-runtime.cjs 用 curl 拉官方 Release 的 install.cjs 并 spawn node 执行；缓释是 release tag 固定 + SHA-256 校验 + 平台门禁，但供应链仍指向 Agentchengfeng/chengfeng-videocut 发布件。
- 会改用户 Codex 环境（Marketplace ref 与 plugin cache） — 激活路径经官方 codex 命令写入，需用户确认四项身份且带 CAS/回滚；确认门之后的写入落在用户真实环境，脚本对『恢复不完整』只报告实际状态。
- 密钥以命令行参数传递 — 转录凭证走 videocut-cli config set transcription.apiKey <key>，可能进 shell 历史与进程列表；SKILL.md 未就此给出提示。
- 强流程对宿主能力有硬依赖 — 需要 Codex Plugin/Marketplace、managed service（launchd / Windows Task Scheduler）、Google Chrome、Node ≥ 20、云端 ASR；缺任一项按设计停止，非 Codex 宿主基本无法复现该流程。
- 『已启用』不可自证，存在误判面 — plugin README 明说静态 metadata 与 CLI 调用不能证明 Desktop UI 已展示群组，用户可能以为装好即生效。
风险提醒：橙色，评估后使用。判级依据（按六档：依赖远程包/触发凭证链即橙色）——① 会下载并执行远程安装器：ensure-runtime.cjs 用 curl 拉官方 Release 的 install.cjs 与 portable 制品，再 spawn node 执行，属远程代码执行面（缓释：release tag 固定 v0.4.11 + SHA-256 校验 + 平台门禁 + 失败 fail-closed）；② 触发宿主凭证链：经官方 codex CLI 改用户 Marketplace/plugin cache（可回滚写事务），经 gh CLI 创建公开 Issue；③ 涉及第三方服务：云端 ASR 需用户火山引擎凭证，音频/转写文本外发到火山引擎；④ 大量本地写：~/.chengfeng-videocut、用户 Codex 配置与 cache、项目文件（经产品 CLI）。缓释面完整：写事务需用户确认、CAS 复读、失败状态机化；注入面有脱敏与参数化 spawn 测试。注意：本分级只描述行为面，不评价作者。
5第二遍独立确认
- [ok] skill.path 定位（任务表标『待定位』；本 repo 是合集形态） — repo 是 Codex Plugin 安装入口 + 一包 6 个 Skill，plugin 根无 SKILL.md；主入口按 plugin.json defaultPrompt[0] 与 plugin README 能力边界表首行取 chengfeng-cut，故 path=plugins/chengfeng-videocut/skills/chengfeng-cut。其余 5 个 SKILL.md 路径已在 analysis.capabilities 与 internal_assets 中逐条登记。
- [ok] skill.commit / audit.skill_commit 与 pin 一致 — 工作副本 HEAD b10e85e1694ac562cb9d0a9496e1a79545d10071；任务表 pin b10e85e1694a；PINS-b2.json 记 {dir: chengfeng-videocut-skills, commit: b10e85e1694a}。
- [ok] meta.license 与仓库事实 — 仓库根 LICENSE 为 Apache License Version 2.0；plugin package.json 与 .codex-plugin/plugin.json 均声明 Apache-2.0；GitHub API spdx_id = Apache-2.0，无冲突。
- [ok] stars / last_push 交叉核对 — gh api 返回 stargazers_count 2996、pushed_at 2026-09-14T15:41:49Z；工作副本最后一次提交时间为 2026-09-14 23:40:09 +0800（同年同日），一致。
- [unlocatable] 被顶替关系（本条目顶替 to-prd/writing-great-skills） — 『为什么由本 skill 顶替』属任务分配层决定，源码内无证据可核；本条仅按 agent-18.md 指派执行。
- [discrepancy] 池内旧描述（aws_review：FFmpeg + 火山引擎 ASR + 上传 uguu.se 公共图床）是否适用于本 pin — 全仓 grep 'uguu' 零命中（仅 git pack 二进制噪声），该描述来自旧仓库 Ceeon/videocut-skills 时代；本 pin 的实际外部依赖是官方 GitHub Releases/Marketplace、codex/gh CLI 与 loopback 5190。云端 ASR 仍是火山引擎，但凭证经 Runtime 管理。池内 aws_review 与 pool.gh_url（Ceeon/videocut-skills）均为待更新的历史值。
- [ok] README/契约中的『已验收/未验收』自述是否与代码一致 — README 明说本轮是 CLI/portable 安装修复预发行、不推进 stable、常驻服务生命周期尚未完成新版本验收；runtime-requirements.json 的 minimumRuntimeVersion 0.4.10 与 releaseTag v0.4.11 与之相符，未发现把预发行包装成 stable 的表述。
- [ok] 『user-invocable 只证明兼容 metadata，不证明 UI 展示』是否真在源码写明 — plugin README 原句：静态元数据、agents/openai.yaml、Plugin 首页 starter prompt 和 CLI 的 $plugin:skill 调用，不能单独证明 Desktop Slash/Plugin 群组已经在界面中展示。
6结论
适合：适合中文口播（talking-head）长素材的一次性剪辑：想要『AI 找口误/重复/残句 → 人拿两张表在 Studio 亲自复核 → 复盘沉淀偏好』这套半自动流水线，并且已经或愿意安装 Chengfeng VideoCut 配套 Runtime 的 Codex 用户。也适合作为 skill 作者研究『agent 编排 + 产品 CAS + 诚实验收分级』的工程范式样本。
不适合：不适合只想一键出片、不接受人工复核与 Studio 环节的用户（多处显式要求停下来等人）。不适合非口播素材（无逐词稿的 vlog、纯音乐、非中文素材）以及缺配套 Runtime / Chrome / 云端 ASR 的环境。不适合把视频素材视为敏感数据的场景：云端转录会把音频外发到火山引擎；也不适合要求零外发、零写用户环境的纯离线用户。
安装 agent 直装可复制
① 本站镜像 更新 2026-09-15
方式 A · 人下载镜像包下载 videocut-skills.tar.gz
sha256:
方式 B · JSON 格式安装指南，复制给 agent34c8b28b38500e4f…agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。
② 上游 GitHub · 原始来源
来源信息 GitHub 原始
作者 / 仓库Agentchengfeng / Agentchengfeng/chengfeng-videocut-skills
Stars2996
最近推送2026-09-14
本 skill commit
b10e85e169许可Apache-2.0（仓库根 LICENSE 首行 'Apache License'、次行 'Version 2.0, January 2004'；plugin package.json 亦声明 "license": "Apache-2.0"）
本站信息
收录日期2026-09-06
分类内容创作
侦查报告AI 侦查 · 2 遍 · 2026-09-06
本站镜像与 GitHub 原始是不同来源：本站锁定 commit 快照经 /r2 分发；GitHub 为实时上游，内容可能已更新。