菜单
Use when reviewing or correcting SRT subtitle text while preserving timestamps, especially ASR transcript errors, product-name terminology, homophone mistakes, and visual review workflows.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
| name | subtitle-optimizer |
| description | Use when reviewing or correcting SRT subtitle text while preserving timestamps, especially ASR transcript errors, product-name terminology, homophone mistakes, and visual review workflows. |
此 skill 用于优化 SRT 字幕文件中的文字内容，提高准确性，同时严格保留原始时间戳。所有实际写入最终 SRT 的修改都必须经过审查面板或用户明确确认。
词汇列表（assets/corrections.json）：包含已知需要修正的词汇对，支持两种匹配模式：
普通模式（默认）：
{"from": "cloud code", "to": "Claude Code", "reason": "产品名称"}
正则模式（regex: true）： 用于处理多种变体，如大小写、空格差异：
{"from": "cloud\\s?code", "to": "Claude Code", "reason": "产品名称", "regex": true}
cloud code → Claude Codecloudcode → Claude Code（无空格）Cloud Code → Claude Code（大写）常用正则语法：
\s? — 可选空格\s* — 零或多空格-? — 可选连字符(?i)读取 skill 目录下的 assets/corrections.json，了解已知的修正规则。
使用 Read 工具读取用户提供的 SRT 文件。SRT 格式结构：
1
00:00:01,000 --> 00:00:04,000
第一行字幕文本
2
00:00:05,000 --> 00:00:08,000
第二行字幕文本
解析要点：
逐一检查每个字幕条目，识别以下类型的问题：
基于词汇列表的修正：
corrections.json 中的每条规则regex: true，使用正则匹配（考虑大小写不敏感）regex: false 或省略，使用普通字符串匹配转录错误：
语义偏差：
判断依据：
先从 skill 目录运行 prepare-review。它会读取原始 SRT 和词汇列表，在原始 SRT 同目录生成：
{原文件名}_candidate.srt{原文件名}_diff_preview.htmlnode scripts/generate_diff.js prepare-review \
/path/to/video.srt \
--corrections assets/corrections.json
不要把真实用户产物写入 skill 仓库目录或仓库内临时目录。默认只在原始 SRT 同目录生成候选 SRT 和审查面板；调试产物不是最终交付物，确实需要时写到系统临时位置并在完成后清理。
prepare-review 生成的候选文件包含词汇列表命中的自动修正。候选文件不是最终输出，必须进入审查流程。
prepare-review 只是规则词汇预处理，不会自动产生上下文级 AI 建议。不能只运行 prepare-review 就向用户汇报审查完成。
运行 prepare-review 之后，必须继续阅读原始 SRT 和候选 SRT，做完整逐条审阅，逐段检查候选文件中仍然存在的 ASR 错字、近音字、断句问题、上下文语义偏差和术语不一致。不得只抽样、不得只搜索品牌名或已知词汇、不得只检查脚本输出的差异行。
AI 审阅协议：
review-plan 获得连续审阅范围，不得只靠一次整文件 Read；默认不要生成 *_review_chunks.json：
node scripts/generate_diff.js review-plan \
/path/to/video.srt \
--size 100
review-plan 只输出范围，不创建额外文件。只有在调试或需要机器可读审计记录时，才可以显式运行 review-chunks，并且输出到系统临时位置或 Agent 临时目录，不要写到用户字幕目录，也不要作为 skill 文件保留。review-plan 输出的 chunk 范围为准。长文件可以按每 80-150 条字幕一批处理，但必须覆盖完整文件。不得通过一次整文件读取后直接宣称完成；必须能说明已审阅的连续区间。{原文件名}_candidate.srt，随后刷新审查面板。1-100, 101-200, ...，不能只说“已逐条审阅”。硬性汇报规则：
重点检查类型：
分析时至少覆盖：
如果识别出高置信度 AI 修正：
{原文件名}_candidate.srt如果没有发现高置信度 AI 修正，也要在最终回复中明确说明“已完成上下文 AI 审阅，未发现可安全加入候选文件的 AI 建议”。不要把脚本输出中的 AI corrections: 0 当作已经完成 AI 审阅的证据；它只表示当前候选文件里没有非词汇表来源的差异。
如果第五步之后没有再修改候选 SRT，prepare-review 已经生成审查面板，不需要重复运行命令。若你编辑了候选 SRT 来加入 AI 修正，则用同一个候选文件重新生成 HTML 审查面板：
node scripts/generate_diff.js \
/path/to/video.srt \
/path/to/video_candidate.srt \
/path/to/video_diff_preview.html \
--corrections assets/corrections.json
审查面板默认展示发生变化的字幕块，同时必须支持切换到“全部字幕”和“未修改”，用于检查是否有漏改。面板包含：
统计信息：
对比表格：
操作按钮：
{原文件名}_fixed.srt）手动添加功能：
from、to、regex，用于沉淀后续可复用的规则；页面会自动写入默认 reasonnew_corrections.json，提示用户把文件交给 Agent，并让它合并到 assets/corrections.json审查面板特性：
assets/diff_preview_template.html 中的优化审查台 UI；不要临时生成简化版、旧版或一次性 HTMLnew_corrections.json；静态页面本身不直接修改本地词汇表文件{文件名}_diff_preview.html。默认展示修改行，你也可以切换到全部字幕或未修改行检查漏改。请在页面中接受/拒绝修改，也可以添加遗漏词汇或手动修正未修改的字幕行。完成后点击“导出最终 SRT”即可下载 {文件名}_fixed.srt。如果新增了可复用词汇规则，请在“追加词汇规则”区域点击“导出新增规则”，下载后把 new_corrections.json 交给 Agent 合并到规则库。"普通用户生成最终字幕不需要 JSON。只有当用户在页面里追加了可复用词汇规则，并导出了 new_corrections.json 时，才需要合并到 assets/corrections.json：
node scripts/generate_diff.js update-corrections \
new_corrections.json \
--corrections assets/corrections.json
合并规则：
new_corrections.json 中的 correctionsmanualCorrectionsfrom、to、regex 自动去重assets/corrections.json，不会修改当前 SRT 文件如果希望新增规则也立刻影响当前字幕，应先合并规则，再重新从第三步开始扫描并生成新的候选文件和审查面板。若只是想修改当前某条字幕，应使用“手动修正字幕行”，它会直接进入页面导出的最终 SRT。
普通用户优先使用页面中的“导出最终 SRT”。当需要在 Agent/CI 中复现同一批审查决策时，仍可使用脚本生成最终字幕文件：
node scripts/generate_diff.js apply-decisions \
original.srt \
video_candidate.srt \
review_decisions.json \
video_fixed.srt \
--corrections assets/corrections.json
应用规则：
acceptedChangeIds：使用候选文件中的修正文本rejectedChangeIds：保留原字幕文本，除非同一序号存在手动行级修正pendingChangeIds：兼容字段，当前页面通常导出为空数组manualLineEdits：直接覆盖指定字幕块文本manualCorrections：兼容旧审查记录，可追加到 assets/corrections.json，自动去重最终文件要求：
_fixed 后缀命名输出文件（例：video.srt → video_fixed.srt）{原文件名}_fixed.srtnew_corrections.json 只用于更新规则库，不是生成最终字幕的必需步骤[原始序号]
[原始时间码]
[修正后文本]
[原始序号]
[原始时间码]
[修正后文本]
...
预览页面为一个独立的 HTML 文件，包含内联 CSS 和 JavaScript，无需外部依赖。
设计风格：
数据结构：
const diffData = [
{
id: 1,
timestamp: "00:00:01,000 --> 00:00:04,000",
before: "原文",
after: "修正后",
type: "vocabulary", // 或 "ai"
status: "accepted", // accepted / rejected
reason: "产品名称",
sourceCorrection: {
from: "cloud\\s?code",
to: "Claude Code",
reason: "产品名称",
regex: true
}
}
];
const reviewRows = [
{
id: 1,
timestamp: "00:00:01,000 --> 00:00:04,000",
before: "原文",
after: "修正后",
beforeHtml: "原文",
afterHtml: "修正后",
type: "vocabulary",
status: "accepted",
kind: "changed", // changed / unchanged
changeNumber: 1 // 未修改行为 null
}
];
新增规则导出格式：
{
"version": 1,
"generatedAt": "2026-04-16T00:00:00.000Z",
"corrections": [
{"from": "原文", "to": "修正后", "reason": "遗漏词汇", "regex": false}
]
}
new_corrections.json，再由 Agent 或脚本追加到 assets/corrections.jsoncorrections.json；更新词汇表仍需要 Agent 或脚本处理基于 SOC 职业分类
