From notes-skills
Refactors scattered learning notes into structured, maintainable knowledge bases: reorganizes categories, removes redundancy, adds guides and learning paths from basic to advanced, preserves Markdown/HTML marks, tracks links/images without loss.
npx claudepluginhub z-soulx/ai-toolkit --plugin productivity-skillsThis skill uses the workspace's default tool permissions.
将“长期积累但逐渐散乱”的学习笔记重构成边界清晰、体系完整、渐进可学、可检索、可持续增量维护的笔记体系，并保持后续维护友好。
Compares coding agents like Claude Code and Aider on custom YAML-defined codebase tasks using git worktrees, measuring pass rate, cost, time, and consistency.
Designs and optimizes AI agent action spaces, tool definitions, observation formats, error recovery, and context for higher task completion rates.
Designs, implements, and audits WCAG 2.2 AA accessible UIs for Web (ARIA/HTML5), iOS (SwiftUI traits), and Android (Compose semantics). Audits code for compliance gaps.
将“长期积累但逐渐散乱”的学习笔记重构成边界清晰、体系完整、渐进可学、可检索、可持续增量维护的笔记体系，并保持后续维护友好。
关键附加目标（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 资源账本