整理与重构已有学习笔记:重划边界、归类重组、合并冗余、精简口语化表达;优化排版与可读性;为各部分补充引导与注释;按从基础到高级建立学习路径并打通知识关联;同时尽量保留原文 Markdown/HTML 强调标记(如 ==高亮==、<u>、Setext 标题等),输出结构清晰、可检索、便于长期维护的笔记体系。
Refactors scattered study notes into a structured, searchable knowledge system with asset tracking.
/plugin marketplace add z-soulx/ai-toolkit/plugin install notes-skills@ai-toolkitThis skill inherits all available tools. When active, it can use any tool Claude has access to.
SKILL_副本.md将“长期积累但逐渐散乱”的学习笔记重构成边界清晰、体系完整、渐进可学、可检索、可持续增量维护的笔记体系,并保持后续维护友好。
关键附加目标(v2.2):
资料参考 并标注待人工确认plan_only:只输出规划清单(新大纲/映射/重命名/迁移步骤/检查清单),不输出最终正文full_refactor:输出最终整理后的正文(同时也包含规划清单)默认建议:
full_refactor
headings_only:仅依据标题做规划(不确定性较高,映射需更多 TBD)headings_plus_snippets:标题 + 每节少量片段(推荐用于“先出清单/框架”)full_text:通读全文(推荐用于 full_refactor)默认建议:
full_text
asset_policy(默认:place_correctly_and_track)
place_correctly_and_track:外链/图片绝不丢失;优先按方法论放到“应该放的位置”(可移动/合并/归类);仅对“倾向删除”的资源放入 资料参考 并标注待人工确认;必须输出资源去向账本preserve_strict:外链/图片绝不丢失且不移动(仅允许修复断链格式);仍输出资源去向账本(全部为 KEPT)references_heading_name(默认:资料参考)
asset_ledger(默认:required)
required:必须输出资源去向账本off:不输出账本(不推荐)keep_heading_numbering: false(标题不自动编号;原文自带编号则保留)preserve_marks: true(保留强调标记与形态)max_intro_lines_per_section: 1(每个一级/二级标题引导注释最多 1 行)max_questions: 7(待确认问题最多 3-7 条)若任务较大,可先创建
task_plan.md与notes.md,按阶段更新计划与记录,再进入内容整理。
full_text:通读全篇;抽取章节结构、主题域、重复点与跨章节关联headings_plus_snippets:提取全部标题;每节读取前 N 行/1-3 段,仅用于判断主题归属与边界headings_only:只提取标题树;所有归类与映射需保留较多 TBD输出:标题树 + 初步诊断要点(不改正文)。
v2.2:在 full_refactor 模式下,必须先抽取“资源清单基线”(外链/图片列表),用于后续账本比对。
输出:新的规划大纲(含引导注释)。
输出:章节质量稳定后再推进下一章,避免全局杂乱返工。
当 asset_policy=place_correctly_and_track 时,遵循以下规则:
资料参考 中(仅当 TO_REVIEW)资料参考 仅收纳:整理后判断对主线不必要、重复、旁支,且“倾向删除”的资源。资料参考 的每条资源必须附:
(待人工确认是否删除) + 简短原因(例如:重复/旁支/已被更权威资源替代)资料参考。资料参考(待人工确认是否删除)v2.2 关键:即使正文中只保留“bbb 的链接”,aaa 的链接也必须出现在账本中并标注“MERGED/TO_REVIEW”,并说明去向,否则视为违规(疑似遗忘)。
plan_only:只输出规划清单(不输出整理后的正文)full_refactor:输出规划清单 + 最终整理正文(可直接替换原文版本)asset_ledger=required:交付中必须包含《资源去向账本》==高亮==、<u>、<mark>、粗斜删、行内代码、代码块围栏、引用块、分隔线、Setext 标题资料参考 或“资源去向账本”中找到明确去向![]() / <img> 等均可追踪,整理后仍存在于正文或 资料参考资料参考 只收纳 TO_REVIEW(倾向删除) 的资源,且每条带“待人工确认是否删除”与原因资料参考(仅当 asset_policy=place_correctly_and_track)杂谈/随记/一些坑/总结一下/记录/待完善概念/机制/协议/模型/实践/排障/性能/源码| 旧节(含层级) | 动作(KEEP/MOVE/MERGE/SPLIT/RENAME/DROP/TBD) | 新节路径 | 备注 |
|---|
旧标题 -> 建议标题(原因:更标准/更短/更可检索/边界更准确)asset_policy=place_correctly_and_track:
资料参考(待人工确认是否删除)| 资源类型 | 原文显示文本/alt | URL/路径 | 原位置(标题路径) | 状态(KEPT/MOVED/MERGED/TO_REVIEW) | 新位置(标题路径/资料参考) | 说明 |
|---|
请按 skill: learning-notes-organizer 执行。
目标文件:{目标文件路径}
交付模式:{deliverable_mode=plan_only|full_refactor}
阅读范围:{read_scope=headings_only|headings_plus_snippets|full_text}
资源策略:
asset_policy=place_correctly_and_track
asset_ledger=required
references_heading_name=资料参考
要求:
- 标题不自动编号(原文已有编号保留)
- 尽量保留原文强调标记与形态(==、<u>、Setext 等)
- 外部链接与图片绝不丢失:优先归位到应该放的位置;仅“倾向删除”的放入对应小节的“资料参考”(待人工确认是否删除)
- 必须输出资源去向账本(Link/Image Ledger),避免“删了还是忘了”的不透明
- 先给出 A-E(大纲/映射/重命名/问题/验收)
- 若 deliverable_mode=full_refactor,再给 F 最终正文与 G 资源账本
You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements and design before implementation.