English | 简体中文
把同一专题的混合材料整理成风格统一、形式可切换的笔记与提纲
Agent skills for turning same-topic mixed materials into style-controlled Markdown notes and outlines.
materials-to-notes 是一组 Agent Skills，用来把同一专题下的混合材料整理成可读、可复用、风格一致的 Markdown 笔记或提纲。材料可以来自本地文件夹、粘贴文本、Markdown、PDF 转文本、Word-like 文本或多种材料混合，但内容应围绕同一主题，而不是把无关内容强行合并。
它的重点不是直接替用户猜测输出，而是先通过交互确认目的、使用场景、读者、输出形式、细节深度、语气、语言和来源保留程度。确认后，主 skill 会组织材料盘点、跨材料综合、结构确认和最终 Markdown 输出。
| 场景 | 调用方式 | 输出 |
|---|---|---|
| 复习整理 | Use $materials-to-notes to organize this folder into an exam-review outline. |
层级清晰的复习提纲 |
| 研究准备 | 使用 $materials-to-notes 把这些同一专题材料整理成研究综述提纲。 |
带概念、分歧和空白的综述框架 |
| 汇报准备 | Use $materials-to-notes to turn these notes into a presentation outline. |
可继续转 PPT 的汇报提纲 |
| 单步辅助 | Use $clarify-note-intent to decide the right output type and source policy. |
下游可复用的 style_profile |
更多示例见 examples/prompts.md 和 examples/sample-output.md。
- 面向“同一专题”的材料整理，支持同一主题下多种材料格式混合。
- 主 skill 负责任务编排，辅助 skills 分别负责意图澄清、材料盘点、专题综合和最终输出。
- 支持四类首版输出：完整笔记、结构化提纲、知识框架、汇报提纲。
- 可根据用户交互主动判断输出形式，也可以在用户明确要求时调用某个辅助 skill。
- 默认要求在最终写作前展示拟定结构，并等待用户确认。
- 来源保留程度可调：不保留、材料级、论点级、短引文支撑。
- Markdown-first，便于继续放入 Obsidian、Notion、GitHub 或文档系统。
使用支持从 GitHub 安装 skill 的 agent runtime 安装所有 skills。下面是一个安装命令示例：
python ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py \
--repo Markwulala777/Materials2Notes \
--path skills/materials-to-notes \
--path skills/clarify-note-intent \
--path skills/intake-topic-materials \
--path skills/synthesize-topic-materials \
--path skills/build-note-outputs安装后重启你的 agent runtime，让新的 skills 生效。
优先使用主入口 $materials-to-notes：
Use $materials-to-notes to organize the materials in this folder into a structured Markdown note.
The materials are all about one topic. Ask me about output type, style, and source retention before writing.
中文请求也可以直接触发：
使用 $materials-to-notes 把这个文件夹里的同一专题材料整理成一份风格统一的复习提纲。
如果输出形式不确定，先问我用途和使用场景。
如果只需要某个环节，也可以单独调用辅助 skills：
Use $intake-topic-materials to inventory this folder.
Use $synthesize-topic-materials to merge these material summaries into a topic skeleton.
Use $build-note-outputs to turn this synthesis into a presentation outline.
- 确认输入方式：本地文件夹、粘贴文本，或二者混合。
- 确认专题边界：当前材料共同讨论什么，哪些相邻内容要排除。
- 澄清输出目的：复习、学习、汇报、写作准备、教学或其他场景。
- 盘点材料：标记核心、辅助、边缘或无关材料，并生成材料摘要。
- 综合专题：抽取核心概念、论点、关系、冲突、空白和推荐结构。
- 展示拟定结构：先让用户确认 H1/H2/H3 层级和重点。
- 生成 Markdown：按选定风格、语言、细节深度和来源策略输出。
skills/materials-to-notes/ # 主编排 skill
skills/clarify-note-intent/ # 输出意图、风格和来源策略澄清
skills/intake-topic-materials/ # 同一专题材料盘点
skills/synthesize-topic-materials/ # 跨材料专题综合
skills/build-note-outputs/ # Markdown 笔记和提纲生成
scripts/validate_materials_to_notes_skills.py
examples/prompts.md # 常用调用示例
examples/sample-output.md # 示例输出形态
assets/icon.svg # README 图标
运行仓库内置校验：
python scripts/validate_materials_to_notes_skills.py也可以对每个 skill 运行 quick validate：
python ~/.codex/skills/.system/skill-creator/scripts/quick_validate.py skills/materials-to-notes
python ~/.codex/skills/.system/skill-creator/scripts/quick_validate.py skills/clarify-note-intent
python ~/.codex/skills/.system/skill-creator/scripts/quick_validate.py skills/intake-topic-materials
python ~/.codex/skills/.system/skill-creator/scripts/quick_validate.py skills/synthesize-topic-materials
python ~/.codex/skills/.system/skill-creator/scripts/quick_validate.py skills/build-note-outputsMIT