| name | srt-proofreader |
| description | Proofread SRT subtitles by using srts/source.md as terminology reference while preserving subtitle indices and timestamps. Use when users ask to proofread or correct srts/*.srt files and require git-tracked edits, optional large-file section splitting, and merge-back. |
SRT Proofreader
Execute the workflow in order. Keep edits minimal and deterministic.
1. Enter srts/
- Change directory to the task's
srts/ folder.
- Stop and report if
srts/ does not exist.
2. Ensure Git Baseline
- Check whether
srts/ is already inside a git repository.
- If not inside a git repository:
- run
git init
- run
git add .
- run
git commit -m "init srt"
- Do not rewrite existing history.
3. Require and Read source.md
- Check whether
srts/source.md exists.
- If missing, stop immediately and tell the user:
还没有创建 source.md.
- Read
source.md before editing subtitles.
- Extract terminology and proper nouns from
source.md, then use them as authoritative wording.
4. Select the Main .srt File
- List candidates in
srts/ with:
- extension
.srt
- filename not starting with
. or _
- Require exactly one candidate.
- If zero candidates, stop and report.
- If multiple candidates, stop and ask the user which file is the main subtitle file.
5. Handle Large Files (>400 lines)
- Count lines in the main
.srt.
- If line count is
<=400, edit directly.
- If line count is
>400:
- split into
section-001.srt, section-002.srt, ... using scripts/srt_sections.mjs
- edit each section sequentially
- merge sections back and overwrite the original main
.srt using the same script
- Use this script interface:
- tool path:
scripts/srt_sections.mjs
- split:
node scripts/srt_sections.mjs split --input <main.srt> --output <dir> --chunk 400
- merge:
node scripts/srt_sections.mjs merge --input-dir <dir> --output <main.srt>
6. Subtitle Editing Rules
- Edit only typo-level text issues and term consistency.
- Never modify subtitle sequence numbers.
- Never modify timestamp lines (
-->).
- Preserve original line structure and blank-line boundaries.
- Use
source.md terminology as first priority.
- Do not introduce new trailing punctuation on the final subtitle text line.
- Remove filler words from subtitle text: delete 嗯 and 啊 when they are pure speech fillers carrying no meaning. Remove the character cleanly, do not add or change surrounding text to compensate.
7. Final Verification
- Review
git diff and confirm index/timestamp lines are unchanged.
- Confirm only subtitle text lines were modified.
- Report completion with a short summary of corrected term categories.