关于 transcript-cleanup
transcript-cleanup 是用于整理项目 output/ 目录中转录文本并汇总为带日期的 Markdown 文件的技能。它会格式化句子、按文件名日期排序并验证输出，只有验证通过后才删除已处理的文本文件。
主要功能
- 01查找转录 .txt 文件
- 02提取转录文本部分
- 03校正并格式化句子
- 04按文件名日期排序
- 05验证输出后再删除源文件
适用场景
- 01将多份转录汇总为 Markdown
- 02修正拼写、语法和标点
- 03生成易读的日期与时间标题
- 04验证通过后清理已处理文本
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/transcript-cleanup确认已加载。
附带文件tile.json
详细介绍
处理当前项目 output/ 目录中的所有转录文件。请仔细执行以下步骤：
第 1 步：查找输入文件
使用 Glob 查找 output/ 中所有 .txt 文件。如果没有文件，报告没有内容需要处理，然后停止。
第 2 步：解析每个文件
对每个文件，只提取 === TRANSCRIPTION === 下的内容。忽略 === SUMMARY === 和 === METADATA === 部分。
第 3 步：根据文件名生成日期时间标题
每个文件名的格式为 YYYY_MM_DD_HH_MM_SS.txt。将其转换为包含星期几的易读日期时间字符串，格式如下：
## Thursday, February 26, 2026 at 2:20 PM
使用 12 小时制 AM/PM 时间。根据日期正确推算星期几。
第 4 步：清理每份转录内容
对转录文本应用以下规则：
- 更正所有拼写错误
- 修正语法错误（主谓一致、时态一致等）
- 添加恰当的标点符号（句号、逗号、撇号、缩写中的撇号）
- 大写专有名词和句首字母
- 每个完整句子单独占一行
- 每个句子之间空一行
- 将零散的短语合并为完整、连贯的句子
- 删除填充词（um、uh、like）
- 删除说话中断和重复的词语
第 5 步：写入输出
通过在 Bash 中运行 date '+%Y_%m_%d_%H_%M_%S' 获取当前日期和时间。将所有清理后的转录内容写入：
cleaned/transcripts_YYYY_MM_DD_HH_MM_SS.md
其中时间戳取自该 Bash 命令。若 cleaned/ 目录不存在，则创建该目录。
文件中应按时间倒序排列所有转录内容（最新的文件名排在最前），每份内容均置于对应的 ## 日期时间标题下，各份内容之间只用标题分隔（不添加水平线）。
输出文件中只能包含清理后的转录内容，不得添加介绍、说明或其他评论。
第 6 步：验证
写入输出文件后：
- 确认文件存在且非空
- 确认输出中的
##标题数量与已处理的输入文件数量一致
如果验证失败，请清楚报告错误，且不要删除 output/ 中的任何文件。
第 7 步：删除源文件
只有在验证通过后，才使用 Bash 删除 output/ 中已处理的所有 .txt 文件。
第 8 步：保持源录音不变
不要移动、删除或以其他方式处理任何 .mp3 文件。
转录程序会在 Python 中自行删除每个录音，而且只会在确认对应转录文件已写入磁盘后立即执行删除。
这一步以前由这里负责，但由于仅凭文件名将录音与转录文件匹配只能靠猜测，而猜测不该被用来决定是否删除某人的语音备忘录，因此它在这里悄无声息地失败了好几个月。
报告已处理的文件数量以及输出文件路径。