
Subtitle Refine
This does production-grade cleanup of Chinese ASR subtitles without turning them into polished prose. It fixes recognition errors, strips filler words like 嗯 and 啊, adds spacing between clauses, and splits entries over 14 characters while keeping everything synced to the original audio timestamps. The workflow is conservative: no rewriting for style, no summarizing, just subtitle-level fixes. It includes a validation script that checks length limits, timeline drift, and deletion allowlists. Best for documentaries, interviews, or screencasts where you need to correct ASR output but preserve the speaker's natural phrasing. The instructions are unusually thorough about not introducing timeline drift when splitting entries, which is where most automated cleanup tools fail.
- skills.sh installs
- 325
- GitHub stars
- 827
- last updated
- Aug 21, 2026
Install
$ npx -y skills add wdkns/wdkns-skills --skill subtitle-refine --agent claude-codeInstalls into .claude/skills of the current project.
Files
字幕精修
任务目标
把用户提供的原始 srt 清洗成一份可交付的完整 clean.srt。
- 不要覆盖原始字幕文件。
- 只做字幕级纠错,不做润色、总结或扩写。
- 最终校验:直接对原始
srt和完整clean.srt运行scripts/check_clean_srt.py。
原始要求
文本清洗要求
- 修正识别错误,包括正确的“的地得”、合理的“他她它”。
- 删除“嗯、啊、呃、哈”之类的无意义语气词;清洗后的字幕不要带标点。
- 子句间需要有必要的空格停顿。
例:
来那你就先开始->来 那你就先开始例:你是第二个是吧->你是第二个 是吧 - 删除明显重复字眼,不要书面化改写,不要总结,不要扩写,只做字幕级清洗和纠错。
- 每条字幕最长不超过 14 字(英文单词默认视为一个字),单条字幕内不要换行。
- 如果原字幕超过 14 字,要做准确断句拆分。
例:
还得谢谢各位母亲对家里的付出->还得谢谢各位母亲+对家里的付出 - 不得因文本纠错、删语气词、删重复字眼或拆分字幕,造成后续字幕整体提前或滞后。所有调整都应限于当前字幕条目及其局部范围内。
时间轴要求
- 处理后字幕必须与原音频严格同步,不得出现全局时间漂移。
- 若仅进行字幕级清洗与纠错,且未改变原句语义边界,则默认保持该条原始起止时间不变。
- 若因断句或单条超过 14 字而拆分,则拆分后的所有子条目必须完全落在原字幕时间范围内;各子条目之间不得重叠,优先首尾衔接,总覆盖时长必须与原条目一致。
- 拆分后的时间分配应优先依据语义停顿和说话节奏;无法精确判断时,再按各子句有效字符数比例分配,不得机械平均切分。
- 删除句中语气词或明显重复字眼时,通常不调整原条目起止时间;若某条本身只是独立且无意义的语气词,则可直接删除,但不得无依据拉伸前后字幕覆盖。
- 每条字幕应尽量贴合语音片段,不得明显早挂或滞留;如需微调,单条字幕起止时间相对语音边界的偏差应尽量控制在 ±100 到 150 毫秒内。
- 拆分和删改后仍须保证可读性,避免过短闪现、明显漏挂、无意义空窗或破坏自然语义边界的切分。
额外要求
- 不要误删有意义的字幕条目。
- 时间轴必须 double check。
- 如果字幕文件过长,只有在用户明确要求并行或允许并行子代理时才并行;即便并行,也只把并行当作编辑辅助,主代理最后仍需直接整理出一份完整的
clean.srt。 - 脚本不应假设字幕一定发生了拆分;无拆分和有拆分都必须兼容。
工作原则
Sponsors
Details
- Repository
- github.com/wdkns/wdkns-skills
- Category
- Video & Audio Editing
- First seen
- Jun 3, 2026