reading-notes

阅读笔记

将提供的资源转化为实用的复习笔记和具体的作业清单。

决策树

用户提供了什么？

• 原始笔记、粘贴的要点或实时笔记记录 将文本视为素材。保留用户粗略的结构，修正明显的分组问题，并提取作业内容，但不要假装笔记已经完整。

• 本地文档、PDF、幻灯片、电子表格、图片、音频文件或视频文件 阅读 references/intake.md，提取可用的文本和视觉／音频信息，然后继续执行默认工作流。

• 网页、文章、RFC、议题、拉取请求或公开 URL 阅读 references/intake.md。总结前记录标题、URL、可见日期和访问限制。

• YouTube 或其他视频 URL 阅读 references/intake.md。优先使用文字稿或字幕，然后补充可见的元数据。如果没有文字稿，说明这一点，并在产出有依据的内容后再索要文字稿。

• 用户要求“作业”“要研究的内容”“接下来该做什么”或“把这些变成待办事项” 阅读 references/synthesis.md，并明确列出行动项。

• 用户要求保存、导出、分享或转换笔记 阅读 references/output-formats.md。先整理笔记，然后询问要保存为哪种格式，除非用户已经指定格式。

快速参考

需求	操作
快速分类来源	python3 scripts/probe_reading_notes.py --source "<resource-or-notes>"
从文档、视频、网页或截图中提取内容	阅读 references/intake.md
将杂乱材料整理为主题、想法、待办事项和研究线索	阅读 references/synthesis.md
使用稳定的 Markdown 结构	复制 templates/reading-notes.md
保存为 Markdown、DOCX、PDF 或其他格式	阅读 references/output-formats.md
避免常见的摘要错误	阅读 references/gotchas.md
验证技能包	在技能目录中运行：python3 scripts/validate.py .
运行打包和辅助程序测试	在技能目录中运行：python3 scripts/test_skill.py .

默认工作流

1. 确认资源类型和访问方式。如果没有提供资源，请索要笔记、链接、文件、文字稿或截图。
2. 记录来源元数据：标题、作者／演讲者（如已知）、事件／背景、URL／路径、日期和访问限制。
3. 使用损失最少的方法提取内容。对于较长的资源，按章节、时间戳、标题、幻灯片或主题分块。
4. 写最终笔记前先构建主题图。按主题分组，而不是按片段出现的顺序整理。
5. 提取有意思的想法：出人意料的论断、实用技巧、权衡、未决争论、参考资料、具名工具，以及值得重新探讨的概念。
6. 将有价值的后续事项转化为作业待办，用具体动词表述：阅读、核实、比较、制作原型、询问、安装、基准测试、撰写、创建或决定。
7. 区分事实、推断和问题。对不确定的内容作出标记，不要把它们润色成确定的结论。
8. 除非用户要求其他格式，否则以 Markdown 返回笔记。
9. 结尾询问是否要保存或导出笔记，并列出 Markdown、DOCX、PDF 或任务清单格式等实用选项。

输出约定

默认使用以下结构。省略空白章节；但如果用户要求作业，则保留待办事项和研究章节。

# <Resource or Session Title>

## Snapshot
- Context:
- Source:
- Confidence:

## Topics
- <topic>: <one-line explanation>

## Interesting Ideas
- <idea>: why it matters or why it is worth revisiting

## Homework / Todos
- [ ] <verb-first action>

## Further Research
- <term, tool, paper, RFC, person, library, or question to look up>

## Open Questions
- <uncertainty, missing source, or question to ask later>

质量标准

• 要点应精炼且有价值。不要把整个来源改写成压缩版的逐字稿。
• 待办事项应足够具体，让用户之后无需重读所有内容也能开始行动。
• 保留具名参考资料、命令、URL、库、产品、人物和 RFC。
• 如果只能访问部分来源，准确说明已获取的内容和缺失的内容。
• 如有可用的引用或来源定位信息，请使用：URL、页码、时间戳、标题、幻灯片编号或文件路径。

阅读指南

情况	阅读
需要访问或规范化资源	references/intake.md
需要判断什么算主题、想法、研究线索或待办事项	references/synthesis.md
需要保存或导出笔记	references/output-formats.md
来源杂乱、不完整、篇幅较长、包含视觉内容或仅有转录文本	references/gotchas.md
需要可复用的输出框架	templates/reading-notes.md

注意事项

1. 转录文本并不等于演讲的全部内容。演示、幻灯片、图表、代码和听众提问都可能包含重要背景信息。
2. 杂乱的现场笔记是证据，而非完整来源。应保留其中的不确定性。
3. 像“研究 ClickHouse”这样含糊的待办事项不够明确。最好写成“将 ClickHouse MergeTree 主键设计与 Nightwatch 仪表板的常见查询进行比较”。
4. 有趣不代表只是被提及。应优先记录那些令人意外、有用、有争议、可复用或与后续行动相关的内容。
5. 除非用户的主要请求是创建文件，否则应先整理笔记，再询问导出格式。

验证说明

辅助脚本具有确定性，只对来源描述符进行分类。请使用 --help 验证命令语法，并使用 scripts/test_skill.py 验证软件包行为。