基于 learning-notes-organizer 的方法论,对指定文件执行"全标题索引+含义/引导注释 + 指定章节重构 + 越界内容路由到合适标题并按需新增待整理容器"的局部重构工作流;用 planning-with-files 输出抽取→规划→映射→交付,范围外章节默认不改,仅做迁移所需最小改动。
Refactors specified sections of a document, routes out-of-scope content to appropriate headings, and creates "待整理" containers for future organization.
/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在不必全篇重构的情况下,完成三件事:
待整理 并把内容放入其中;$learning-notes-organizer
$planning-with-files
必填:
target_file: 目标 Markdown 文件路径focus_sections: 需要重构的章节列表(1~N 个,可变)
["学习资源与概览", "核心概念与内存背景"]["核心概念与内存背景/ByteBuf", "Pipeline/Handler"]可选参数(v2 新增,推荐默认即可):
heading_level_support: 默认 H1-H6meaning_source: "title_plus_snippets" | "full_text"
"title_plus_snippets"(含义/引导注释基于标题+少量内容)intro_policy: "prefer_existing_then_generate" | "generate_if_missing" | "existing_only"
"prefer_existing_then_generate"section_match_policy: "prefer_path_then_title" | "title_only"
"prefer_path_then_title"duplicate_title_policy: "ask_tbd" | "pick_best_match_with_reason"
"pick_best_match_with_reason"(并在摘要说明匹配理由;实在不确定标记 TBD)routing_unit: "subsection" | "paragraph_block"
"paragraph_block"(更细粒度;必要时可按小节搬)todo_bucket_name: 默认 "待整理"add_todo_bucket_policy: "only_when_needed" | "always_when_routing"
"only_when_needed"todo_insert_position: "top_of_target_section" | "bottom_of_target_section"
"top_of_target_section"(更醒目)outside_scope_edit_policy: "minimal_only" | "allow_small_fixes"
"minimal_only"migration_id_policy: "auto_ids" | "none"
"auto_ids"(为迁移内容块生成可引用 ID)intro_policyfocus_sections:
routing_unit)待整理(按 todo_bucket_name)待整理(按 todo_insert_position)migration_id_policy=auto_ids:
MIG-xxx 标记,便于后续点名继续整理含义:...引导注释:...| MIG-ID | 来源位置(章节/小节) | 内容块简述 | 目标标题路径 | 落点(目标标题/待整理) |
|---|
待整理 清单| 目标标题路径 | 是否新增 待整理 | 插入位置(bottom) | 放入了哪些 MIG-ID/内容块 |
|---|
使用 $section-refactor-with-todo-routing(v2)
target_file: <path/to/file.md>
focus_sections: ["章节1", "章节2", ...]
# 可选:
outside_scope_edit_policy: minimal_only
add_todo_bucket_policy: only_when_needed
migration_id_policy: auto_ids
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.