菜单
为张雪峰直播转录文件（zxftrans/*.txt）打分类标签，产出 classification/index.json 供下游结构化流水线消费。当用户说"分类 N 份"、"全量分类"、"查分类进度"、"重分类 BVxxx"、或提及 zxftrans 分类、启发式筛选、内容类型判定时使用。支持增量运行，自动跳过已分类文件。即使用户不用"skill"字样，只要任务是对 zxftrans 目录做分类/筛选/索引，就用这个 skill。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
张雪峰转录结构化 skill（通用版 runner 薄壳，**无需 API key**）。当用户说"分类 N 份"、"跑 N 份对话片段"、"跑 N 份独白"、"跑 BVxxx"、"查进度"、或提及 zxftrans/phase_dialog/phase_monolog 时使用。runner 不调 LLM，由主 agent 用自身 AI 能力按工作包产出 JSON。
从 classification/index.json 取待跑清单，把张雪峰转录片段跑成结构化 JSON 知识库（粗修→精修→校验→入库）。当用户说"跑 N 份对话片段"、"跑 N 份独白片段"、"用 haiku 精修跑 X 份"、"跑 BVxxx"、"查结构化进度"、或提及 zxftrans 结构化/粗修/精修/phase_dialog/phase_monolog 时使用。即使用户不用"skill"字样，只要任务是对已分类的 zxftrans 片段做结构化 JSON 抽取，就用这个 skill。依赖 zxf-classify 已经打好标签。
| name | zxf-classify |
| description | 为张雪峰直播转录文件（zxftrans/*.txt）打分类标签，产出 classification/index.json 供下游结构化流水线消费。当用户说"分类 N 份"、"全量分类"、"查分类进度"、"重分类 BVxxx"、或提及 zxftrans 分类、启发式筛选、内容类型判定时使用。支持增量运行，自动跳过已分类文件。即使用户不用"skill"字样，只要任务是对 zxftrans 目录做分类/筛选/索引，就用这个 skill。 |
所有脚本都在 skill 目录，用绝对路径调用，不要复制到项目里：
CLASSIFY=~/.claude/skills/zxf-classify/scripts/classify.py
PROGRESS=~/.claude/skills/zxf-classify/scripts/progress.py
项目目录 zxftrans_structured/scripts/ 里只放项目自有脚本（如 validate_json.py），不要把 skill 脚本拷过去——容易版本双份。
扫 /Users/shuo/Documents/Claude/daxue/zxftrans/*.txt（1000+ 份），给每份打 4 维度标签写入索引，供下游 zxf-structure 按清单取样跑结构化。独立运行、增量去重。
不做：转录清洗、结构化本身、下游 RAG 接入。
| 用户说 | 动作 |
|---|---|
| "分类 N 份" / "再分类 N 份" | 从未分类中取 N 份跑（N 解析为整数，默认 20） |
| "全量分类" / "把剩下的都分类了" | 跑完所有未分类 |
| "重分类 BVxxx" | 覆盖指定 BV 的分类记录 |
| "查分类进度" / "分类到哪了" | 只读索引汇报，不跑新任务 |
python3 $PROGRESS --list-pending --limit N --strategy <sorted|random|keyword-first>
sorted：按文件名字典序（默认，稳定可复现）random：随机抽（适合探索整体分布）keyword-first：优先抽文件名含"家长/孩子/闺女/儿子/姑娘/女儿/分"的——冷启动强烈建议，能把对话类样本前置，避免前 N 份全独白zxftrans/*.txt → 从文件名提取 BV id → 对比 index.json.items → 按 strategy 排序 → 取前 N对每份待分类文件运行：
python3 $CLASSIFY <txt_file_path>
脚本返回 JSON 对象（打分+4 维度标签）。脚本做的事：
python3 $PROGRESS --update '<json_payload>' 把结果 merge 进 classification/index.json。
N > 50 时建议分批（每批 50，避免单次工作量过大）。
调 python3 $PROGRESS --report 输出汇总。
建议：如果项目 structured/ 下已有历史成品（比如之前手工跑过几份），分类完成后再跑一次：
python3 ~/.claude/skills/zxf-structure/scripts/pipeline.py --reconcile
这会把本批新分类里命中历史成品的 BV 自动标为 processed=done，避免重复跑。用户看到：
详见 references/heuristic_v2.md。关键要点：
对话 / 独白 / 专题 / 其他| 路径 | 说明 |
|---|---|
/Users/shuo/Documents/Claude/daxue/zxftrans/*.txt | 转录源（只读） |
/Users/shuo/Documents/Claude/daxue/my-advisor-app/knowledge/zxftrans_structured/classification/index.json | 索引产物 |
索引初次不存在时自动创建。
.txt 文件：跳过skip_reason重分类 场景：先删 items[BV] 再跑scripts/classify.py）分类完成：{本批数}/{本批数} 份
分布：对话 {n} | 独白 {n} | 专题 {n} | 其他 {n}
篇幅：片段 {n} | 整场 {n}
对话类 signal 预判：high {n} | medium {n} | low {n}
累计索引：{classified} / {total_files} 份
未分类剩余：约 {pending} 份