From notes-skills
Restructures and refines Markdown learning notes using a two-phase Plan-and-Execute workflow: diagnose/classify (outline, mapping, scaffold) then rewrite with cross-boundary routing and asset tracking. Supports full or section scope, and plan-only or full refactor output.
How this skill is triggered — by the user, by Claude, or both
Slash command
/notes-skills:learning-notes-organizerThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
将散乱的学习笔记重构成边界清晰、结构完整、渐进可学、可检索、长期可维护的笔记体系。
将散乱的学习笔记重构成边界清晰、结构完整、渐进可学、可检索、长期可维护的笔记体系。
做什么: 只读不写,产出结构规划清单。
scope=sections:标注指定章节的越界内容候选(粗粒度,Phase 2 细化)scaffold=true:生成 <base>-待整理.md 框架文件(详见 Scaffold 格式)输出: 清单(大纲/映射/重命名/问题),以及 scaffold 文件路径+内容(若启用)。
做什么: 对 scope 范围内的内容执行精修重写,并处理越界碎片。
asset_policy=place_correctly_and_track 时):外链/图片零丢失,输出资源去向账本
alt 为空、或 alt 仅为文件名(含扩展名如 .png/.jpg)、或为占位符(如"在这里插入图片描述")的条目⚠️ ALT_MISSING 标注,并在输出末尾提示:"发现 N 张图片缺少语义描述,建议执行 /image-alt-title-filler 补全(账本中已标注)"输出: 可直接替换的 Markdown + 越界路由清单 + 资源账本(若启用)。
target_file:目标 Markdown 文件路径| 参数 | 可选值 | 默认 | 说明 |
|---|---|---|---|
scope | full / sections: ["章节1", ...] | full | 全文 or 指定章节(支持标题名或路径) |
deliverable_mode | plan_only / full_refactor | full_refactor | 只做 Phase 1 / 两阶段都做 |
scaffold | true / false | false | 是否生成待整理框架文件(plan_only 时常用) |
| 参数 | 可选值 | 默认 |
|---|---|---|
asset_policy | place_correctly_and_track / preserve_strict | place_correctly_and_track |
asset_ledger | required / off | required |
place_correctly_and_track:外链/图片优先归位到语义合适的位置;仅"倾向删除"的放入 资料参考;必须输出账本preserve_strict:不移动资源,只修复断链格式;仍输出账本H1 ...
H2 ...(引导注释:读完你会…)
H3 ...
| 旧标题(含层级) | 动作 | 新标题路径 | 图片 | 备注 |
|---|
动作标签:KEEP / MOVE / MERGE / SPLIT / RENAME / DROP / TBD
图片列:—(无图)/ ✓(有图且有 alt)/ ⚠️(有图但缺 alt/title)
`旧标题` → `建议标题`(原因:更标准/更短/更可检索/边界更准确)| MIG-ID | 来源位置 | 内容块简述 | 目标路径 | 落点(章节/待整理) |
|---|
同时追加写入到 E 末尾的"整理记录"区块,便于文档内留档。
| 类型 | 显示文本/alt | URL/路径 | 原位置 | 状态 | 新位置 | 说明 |
|---|
状态:KEPT / MOVED / MERGED / TO_REVIEW / ⚠️ ALT_MISSING(图片缺失语义描述,建议用 /image-alt-title-filler 补全)
写入路径: dirname(target_file)/<base>-待整理.md(已存在则追加 -v2/-v3)
结构:
迁移块模板:
### <新标题>
> 引导注释:<一句话>
**来源旧标题:**
- (MOVE) `旧标题1`
- (MERGE) `旧标题2`
**重命名建议(仅列需要的):**
- `旧标题2` → `建议标题`(原因:...)
**迁移要点:**
- <注意事项>
⬇️ 在下面粘贴原文内容 ⬇️
(把原文复制到这里)
==高亮==、<u>、<mark>、粗/斜/删、行内代码、代码块、引用块、Setext 标题资料参考 只收纳"倾向删除"的资源,且每条附"待人工确认"与原因请按 learning-notes-organizer 执行。
target_file: <path/to/file.md>
scope: full # 或 sections: ["章节A", "章节B"]
deliverable_mode: full_refactor # 或 plan_only
scaffold: false # plan_only 时建议 true
asset_policy: place_correctly_and_track
asset_ledger: required
典型场景对照:
| 场景 | 参数组合 |
|---|---|
| 只要规划清单和框架文件 | deliverable_mode=plan_only, scaffold=true |
| 直接整理全文 | deliverable_mode=full_refactor, scope=full |
| 只整理指定几个章节 | deliverable_mode=full_refactor, scope=sections:[...] |
本 skill 支持渐进式进化。当实战中发现行为偏差,参照 EVOLUTION.md 协议执行迭代升级。
npx claudepluginhub z-soulx/ai-toolkit --plugin doc-processing-skillsRefines rough notes into structured documents with headings, improved phrasing, and formatting via Yuque tools. Handles links or pasted text; preserves original meaning for personal use.
Transforms messy lecture transcripts, OCR notes, screenshots, and scattered learning materials into structured WPS study notes for review and revision.
Analyzes markdown docs using Diataxis principles: classifies sections as tutorial/how-to/reference/explanation, identifies type-specific issues, and interactively refines.