1仕組みと動作原理
本項目は単一ファイルのスキルではなく、Codex Plugin コレクション（6つの業務スキル）です。メインエントリは「口播カット」の chengfeng-cut であり、字幕／映像／エクスポート／不具合報告／更新チェックと並列に登録され、共通の境界線は内部のリファレンスに記載され、ユーザー用エントリを圧迫しません。
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 状態の唯一の書き込み者です」と記載されており、メディアへの書き込みはスキル層から完全に切り離されています。
すべての状態変更は Product CAS に従います。まず readback で revision を取得し、--expected-revision を指定して候補を提出し、提出後すぐに再度 readback して stage およびプロジェクト／Cuts／EDL の3つの 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）です。エージェントが独自に transcript.json を組み立てることは禁止されています（欠番をコンテンツ欠落として暗黙に誤読するため）。
plugins/chengfeng-videocut/skills/chengfeng-cut/SKILL.md
**判断只用 `transcript playback` 的播放顺序，不许自己从 `transcript.json` 拼**
references/semantic-deletion.md には2件の実障害事例（元の段落番号によるグループ化、圧縮された無音区間を削除済みと誤認）が記録されており、「判定基準は正しかったが、入力が暗黙のうちに嘘をついていた」と結論付けられています。
削除判定は5巡の単一基準スキャン（重複／言い直し・途中破棄／言い間違い・再発話／英語の詰まり／口癖）に分割されており、各巡では1つの基準のみを適用して1種類のみを記録し、競合の解決は集計フェーズに委ねられます。
plugins/chengfeng-videocut/skills/chengfeng-cut/SKILL.md
把播放顺序完整读五遍，每遍只带一个判据。
同セクションに「一度に1つの基準で読み進める方が、6つ同時に判定するよりも遥かに品質が高く、各巡の出力が小さく検証しやすい」とその理由が述べられています。
集計により2つのテーブルを出力し、自己通読検証を強制します。削除集計テーブル＋重複文テーブルを出力後、AI 自身がテーブルに沿って削除後の全文を通読し、不自然な場合は取り消します（二値判定であり、「削除推奨」のような曖昧な第3の状態は設けない）。
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 と3つの revision もバインドされており、「ゲートの ok=true は製品側の実行能力を証明するだけであり、プロジェクトレベルのバインドを代替できない」と明記されています。
ハンドオフ後の振り返りと蓄積：保存された提案ファイルと最終台帳の差分（diff）を取り、その差異を3つの引き出し（好み・偏好／固有名詞辞書／ルールの空白）に分類してアーカイブします。
plugins/chengfeng-videocut/skills/chengfeng-cut/SKILL.md
- 口味差异 → `~/.chengfeng-videocut/cut-preferences.md` 追加（Agent 维护的
偏好ファイルと辞書はユーザーレベルの Markdown であり、Agent は自身のセクションのみを追記・更新します。固有名詞の誤りは dictionary.md に登録され、ルールの空白は「判例昇格待ち」として記録され、同一事例が3回発生した時点で汎用判例への昇格が提案されます。
結論の検証レベルは厳密なゲートとして定義されています。API/readback PASS、ビジュアルフレーム PASS、人手による聴取 PASS の3段階は相互に代替できず、実際に人間が聴取していない場合は必ず UNVERIFIED と報告しなければなりません。
plugins/chengfeng-videocut/references/business-workflow-contract.md
没有真实人类听音记录时，必须报告 **human listening UNVERIFIED**；不得声称 PASS。若本轮没有真实 UI 路径，visual frame 也必须是 UNVERIFIED，而不是由静态测试代替。
エクスポートの SKILL.md にはさらに「プレビューと完成版は別々のレンダリングパスである」と明記されており、プレビューのスクリーンショットを完成版の検証エビデンスとして使用することは禁止されています。
環境ロジックは単一の専用 Skill に集約されています。業務 Skill のステップ 0 は check-updates の「準備状況チェック」のみを参照し、結果は厳密に3つの状態のみを取ります。
plugins/chengfeng-videocut/skills/chengfeng-check-updates/SKILL.md
三步走完，输出三态之一：**就绪 / 需新会话 / 停**。
該当 Skill には「環境に関するすべてのロジックはこの Skill にのみ記述される……環境ポリシーを変更する場合はこのファイル1つのみを変更する」とあり、停止状態には、製品画面の代わりに独自の確認ページやプレイヤーを作成することを禁じる事故防止条項が付随しています。
Skills の更新は「検出」と「インストールの変更」の2つのトランザクションに分離されています。チェック段階では、隔離された一時 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` を実行します。候補はバージョン + 40桁の16進数 B(snapshotRevision) + 40桁の16進数 A(contentRevision) + SHA-256 の4点が一致する必要があります。
アクティベーションは公式の Codex コマンドのみを使用し、ロールバックが可能です。ユーザーが4要素の識別情報を確認した後、スクリプトは再度ステージングして --expected-* を比較し、remove → add --ref <B> → upgrade を実行した上でキャッシュから再読み込みして検証します。
installer-manifest.json
"codex plugin marketplace add",
installer-manifest.json の allowedCommands では利用可能なコマンドが7つの codex plugin コマンドにホワイトリスト化されています。SKILL.md は B が40桁の16進数 snapshotRevision でなければならないと規定しており、stable、ブランチ、タグ、短い SHA はすべて marketplace_ref_unsafe として扱われます。
2コア機能
01口播プロジェクトの初期化と状態の readback（project create + workflow get + cuts get、双方の readback は同一の projectId であることが必須）
02辞書による誤字修正ゲート：汎用辞書とユーザー辞書の2段階検証を経て修正テーブルを生成。文字のみを変更し、タイムスタンプ／単語数／wordId は変更不可
035巡の単一基準セマンティック削除（重複／言い直し／言い間違い／英語の詰まり／口癖）、各巡で wordIds・タイプ・リスクを記録
042つのテーブル集計と自己通読検証（削除集計テーブル、重複文テーブル）、曖昧な中間状態のない二値判定
05Studio 手動確認のオーケストレーション：テーブル提示後にページ起動、冪等な ensure-running → open による製品 URL 取得 → ensure-studio 機能ゲート検証
06振り返りとアーカイブ：提案と最終台帳の差分から、ユーザーの好みと固有名詞を3つに分類して蓄積
07字幕フェーズ：台帳に基づきカット後のタイミングを計算し、1画面ごとに単語 ID リスト＋表示テキストを保持（秒数は非保持）
08映像フェーズ：HTML レイヤーを字幕キュー（--cues）にバインド、フレーム抽出による確認、ピクセル差分による動きのある区間の特定、レジストリからのスタイル選択
09エクスポートフェーズ：台帳に基づくカット＋ズーム＋字幕＋HTML レイヤーを一括で mp4 に焼き込み、4段階の進捗（assemble→overlay→compose→verify）を管理
10不具合報告フェーズ：マスキング済みドラフト → ユーザー確認トークン → 固定リポジトリ・ラベルへの gh issue create
11更新・環境フェーズ：準備状況チェック、Runtime のインストールとヘルスチェック、Skills のロールバック可能なアクティベーション
3外部依存関係
| Kind | Dependency / Endpoint |
|---|---|
| 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推奨統制措置と判定根拠
安全運用のための推奨統制措置
Agent 向け
段階的・都度認可、サンドボックス推奨
管理者向け
承認フロー、ロールバック可能、全履歴監査
判定根拠（ファイルパスと抜粋）
- scripts/: ローカルスクリプトまたはコマンドの実行: node plugins/chengfeng-videocut/scripts/ensure-runtime.cjs --install-if-mis
- 网络端点: 外部ネットワークアクセスの宣言: https://github.com/Agentchengfeng/chengfeng-videocut/releases/download/v0.4
- 本地工作目录: ファイルの読み書きと成果物の出力: ~/.chengfeng-videocut/（インストーラーにより Runtime インストールディレクトリに書き込み、cut-preferences.md、dictionary.md）
監査ノート： リスク評価の根拠（6段階基準：リモートパッケージへの依存または認証情報チェーンのトリガーにより橙色判定）—— ① リモートインストーラーのダウンロードと実行：ensure-runtime.cjs が curl で公式 GitHub Release から install.cjs とポータブル成果物を取得し、node を spawn して実行するため、リモートコード実行のリスク面に該当（緩和策：固定の release tag v0.4.11 + SHA-256 検証 + プラットフォーム制限 + フェイルクローズ設計）； ② ホストの認証情報チェーンのトリガー：公式 codex CLI を経由してユーザーの Marketplace／プラグインキャッシュを変更（ロールバック可能な書き込みトランザクション）、gh CLI を経由してパブリック Issue を作成； ③ サードパーティサービスの利用：クラウド ASR に Volcano Engine の認証情報が必要であり、音声および書き起こしテキストが Volcano Engine に外部送信される； ④ 大量のローカル書き込み：~/.chengfeng-videocut、ユーザーの Codex 設定およびキャッシュ、プロジェクトファイル（製品 CLI 経由）。緩和策は包括的です：書き込みトランザクションに対するユーザー確認、CAS readback、状態マシン化されたエラーハンドリングを備え、インジェクション対策としてマスキングおよびパラメータ化された 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結論
最適な用途： 中国語トーキングヘッド（口播）長尺素材の一括編集に最適です。「AI が言い間違い・重複・破棄フレーズを検出 → ユーザーが Studio 上で2つのテーブルを用いて手動確認 → 振り返りによる嗜好の蓄積」という半自動パイプラインを希望し、かつ Chengfeng VideoCut 連携 Runtime を導入済みまたは導入可能な Codex ユーザーに適しています。また、「エージェントによるオーケストレーション + 製品 CAS + 誠実な受け入れ検証レベル」の設計パラダイムを研究するスキル開発者のリファレンスとしても適しています。
不向きな用途： 手動確認や Studio での確認作業を望まず、ワンクリックでの完全自動出力を求めるユーザーには適していません（複数箇所で人手による確認のため明示的に停止します）。トーキングヘッド以外の素材（単語単位の原稿がない vlog、音楽のみの動画、中国語以外の素材）、または必要な Runtime、Chrome、クラウド ASR が利用できない環境には適していません。動画素材を機密データとして扱う環境には適していません（クラウド文字起こしにより音声が Volcano Engine に送信されます）。また、外部送信ゼロやユーザー環境への変更ゼロを求める完全オフライン環境のユーザーにも適していません。
Install Agent-Ready
① Verified Mirror 2026-09-15
Option A · Direct DownloadDownload videocut-skills.tar.gz
sha256:
Option B · Copy Guide for Agent34c8b28b38500e4f…Agent はこの JSON ガイドから自動的にダウンロードして検証します。
② Upstream GitHub
GitHub Repo ↗
Pinned to commit b10e85e169.