ishenwei/atlas
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

course-transcript-notes: add spillover recovery + srt pitfalls

Browse Source
This commit is contained in:
weishen
2026-09-19 12:33:00 +08:00
parent 22abd0a7e2
commit 63fcc17833
1 changed files with 2 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
course-transcript-notes/SKILL.md
View File

@@ -73,6 +73,8 @@ metadata:
- **不要从 log/transcript 文件重新提取 subagent 输出**：`delegate_task` 返回的结果在对话中已经是可用的 markdown。如果当时没落盘，不要试图从 `subagent-summary-*.txt` 或 `live/*.log` 文件中用正则/JSON 解析恢复 — 这些文件中的 JSON 可能包含控制字符导致解析失败，且文件会被清理。正确做法：直接重新读取原始 txt 转录文件，本地生成摘要。 - **不要从 log/transcript 文件重新提取 subagent 输出**：`delegate_task` 返回的结果在对话中已经是可用的 markdown。如果当时没落盘，不要试图从 `subagent-summary-*.txt` 或 `live/*.log` 文件中用正则/JSON 解析恢复 — 这些文件中的 JSON 可能包含控制字符导致解析失败，且文件会被清理。正确做法：直接重新读取原始 txt 转录文件，本地生成摘要。
- **验证必须按章节逐个计数**：`grep -c "^## Chapter"` 只给总数，掩盖单章缺失。必须按章节分别 `grep -c "^## Chapter N —"` 并与该章 txt 文件数对比。 - **验证必须按章节逐个计数**：`grep -c "^## Chapter"` 只给总数，掩盖单章缺失。必须按章节分别 `grep -c "^## Chapter N —"` 并与该章 txt 文件数对比。
- **subagent-summary 文件会被清理**：delegation cache 中的 `subagent-summary-*.txt` 不持久。收到结果后必须立即写入 `/tmp/` 或目标目录，不要依赖后续重新读取。 - **subagent-summary 文件会被清理**：delegation cache 中的 `subagent-summary-*.txt` 不持久。收到结果后必须立即写入 `/tmp/` 或目标目录，不要依赖后续重新读取。
- **结果过大落入 spillover 缓存**：`delegate_task` 返回超 ~100KB 时结果落在 `~/.hermes/cache/spillover/call_*.txt`（JSON 数组，每个 result 的 summary 可能是双重编码 JSON 或原始字符串）。此时可安全恢复：外层 json.loads 后在每个 summary 中找 `{"markdown"` 位置用 `json.JSONDecoder().raw_decode` 提取并 unescape，得到的就是完整 markdown（别对整个文件做 replace 修复）。比重新跑 subagent 快得多。
- **转录文件可能是 .srt 而非 .txt**：每段带序号+时间戳行，subagent 的 context 里要写明剥离序号/时间戳、按对话文本处理。
- **组装时不要做 JSON unescape 修复**：如果某章节内容看起来格式异常（全在一行），正确做法是重新读取原始转录文件生成该章节，不要用 `json.loads` 或 `.replace('\\n', '\n')` 修复整个文件 — 这会丢失其他章节。 - **组装时不要做 JSON unescape 修复**：如果某章节内容看起来格式异常（全在一行），正确做法是重新读取原始转录文件生成该章节，不要用 `json.loads` 或 `.replace('\\n', '\n')` 修复整个文件 — 这会丢失其他章节。
- **大批量章节超出 subagent 并发限制**：`delegate_task` 最多 10 个并行。超过时分批派发，每批完成后立即落盘再派下一批。 - **大批量章节超出 subagent 并发限制**：`delegate_task` 最多 10 个并行。超过时分批派发，每批完成后立即落盘再派下一批。
- **输出文件体积**：39 个视频提炼后约 70-80KB / 1500+ 行。如果用户通过 `read_file` 查看，超过 100K 字符会被截断 — 保持简洁，每个视频控制在 1.5-2KB。 - **输出文件体积**：39 个视频提炼后约 70-80KB / 1500+ 行。如果用户通过 `read_file` 查看，超过 100K 字符会被截断 — 保持简洁，每个视频控制在 1.5-2KB。