菜单
旧笔记批量导入、盘点和规范化。用于用户已经有一堆 Markdown/Obsidian/零散学习笔记，想接入本项目工作区、按项目 Obsidian 规范补 frontmatter、标签、双链、Callout、MOC，并保留原始文件时使用。触发词：旧笔记导入、已有笔记、一堆笔记、批量整理、迁移到这个项目、按项目规范、import existing notes、normalize notes。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
多篇既有学习笔记的批量更新编排。用于用户想一次更新一个目录、文件列表、Obsidian vault 子目录或多篇旧笔记，例如“批量更新这些笔记”“多篇笔记过时了”“把一组笔记更新到新版本”“refresh multiple notes”。先生成更新清单和批量计划，经用户确认后逐篇调用 note-updater 局部 patch，避免全文重写和批量误覆盖。
旧笔记批量导入、盘点和规范化。用于用户已经有一堆 Markdown/Obsidian/零散学习笔记，想接入本项目工作区、按项目 Obsidian 规范补 frontmatter、标签、双链、Callout、MOC，并保留原始文件时使用。触发词：旧笔记导入、已有笔记、一堆笔记、批量整理、迁移到这个项目、按项目规范、import existing notes、normalize notes。
学习笔记需求澄清与引导。分析用户学习需求，引导明确学习目标和方向，调用 workflow-orchestrator 生成项目结构。触发词：想学、帮我整理、研究一下、了解一下、不知道从哪开始、research planning、explore topic。
业务工作流实例化器。由 planner 技能调用，接收 workflow_id、topic、project_slug 等参数，按 .claude/workflows/{workflow-id}/state-template.md 生成 workspace/workflow-runs/{run-id}.workflow.md。不直接面向用户；通用状态格式和状态流转由 workflow-todo-state 负责。
Create or retrofit reusable named workflow state machines for multi-step agent projects. Use when a project needs recoverable workflow state files, multiple workflow definitions, phase gates, restart-safe agent workflows, explicit skipped/blocked states, workflow routing rules, or reusable workflow templates across repositories.
自我学习阶段。回顾本次学习会话，记录学习心得和错误到 .claude/rules/learnings/，当文件超阈值时自动压缩去重，更新 RULES.md，促进系统持续改进。
| name | legacy-note-importer |
| description | 旧笔记批量导入、盘点和规范化。用于用户已经有一堆 Markdown/Obsidian/零散学习笔记，想接入本项目工作区、按项目 Obsidian 规范补 frontmatter、标签、双链、Callout、MOC，并保留原始文件时使用。触发词：旧笔记导入、已有笔记、一堆笔记、批量整理、迁移到这个项目、按项目规范、import existing notes、normalize notes。 |
把用户已有的一批笔记接入 Study System。此技能不从零研究主题，而是先盘点旧笔记，再生成迁移计划，按批次规范化为本项目可管理的 Obsidian Markdown。
overwrite 或 patch-in-place。.md、.markdown。其他格式先列入清单并询问是否转换。note-beautifier；内容过时修订交给 note-updater；目录索引交给 moc-organizer。vault_path、note_folder、asset_folder、moc_path、publish_mode。启动时确认或从用户消息中提取：
source_path: "旧笔记目录或单个文件"
source_scope: all | glob | selected
source_glob: "*.md"
workspace_project: "默认 ./workspace/{project_slug}"
destination_mode: project-output-only | copy-to-vault | patch-in-place
vault_path: ""
note_folder: ""
asset_folder: ""
moc_path: ""
publish_mode: copy | overwrite | patch
stale_policy: skip | flag-only | update-with-note-updater
batch_size: 5
如果缺少 source_path，先询问用户给出旧笔记目录或文件路径。若缺少发布位置，先输出到项目工作区，不写入 vault。
使用 workflow-orchestrator 的 legacy-note-import-flow 模板创建项目目录：
${WORKSPACE_PATH:-./workspace}/{project_slug}/
写入 00_import_intent.md，记录来源、目标、发布策略、批处理大小和是否允许更新旧内容。创建后读取 todo.md，确认当前阶段是 [P0]。
只扫描文件名、相对路径、大小、修改时间和 Markdown 标题，不读取全文。输出：
01_inventory.md：按主题、目录、状态分组的人类可读清单。inventory.csv：机器可读清单。清单字段：
id,relative_path,title,heading_count,has_frontmatter,has_tags,has_wikilinks,has_callouts,size_bytes,mtime,status
status 可取：
ready：可直接规范化。needs-review：标题缺失、结构混乱、疑似重复或格式异常。non-markdown：暂不处理，等待用户确认转换策略。skip：用户排除或明显不属于学习笔记。根据清单输出 02_migration_plan.md，不要开始改文件。计划必须包含：
normalize、update、merge、split、skip。normalized/，或用户指定 vault 目录。batch_size。在用户确认计划前，不进入批量改写。
每批读取 todo.md 和 02_migration_plan.md，只处理本批文件。对每篇 normalize 笔记：
.claude/rules/obsidian/note-system.md。title、tags、created、updated、status、source_project、source_note_path。text。normalized/{safe-title}.md 或用户确认的 vault 目标。每批追加 03_batch_log.md：
| 时间 | 原文件 | 输出文件 | 动作 | 风险 | 备注 |
| --- | --- | --- | --- | --- | --- |
对计划中标为 update 的笔记，不在本技能内重写内容。逐篇调用 note-updater，并传入：
existing_note_path: "源笔记或规范化后笔记"
update_goal: "迁移盘点发现的过时点"
destination_mode: "copy-updated 或 patch-in-place"
moc_path: "{可选}"
对 merge 或 split，先生成小范围建议并等待用户确认，再执行。
如果用户提供 vault 目标：
copy：复制规范化结果到 vault，不覆盖同名文件。overwrite：覆盖前列出将被覆盖文件并等待确认。patch：尽量保留目标笔记已有本地修改，只补项目规范缺失项。如果提供 moc_path，调用 moc-organizer，只写索引项：
- [[笔记标题]] - 一句话说明 #tag
最后输出 04_import_report.md，包含数量统计、跳过原因、风险、后续建议。
todo.md。[PN] ⬜ 未开始 改为 [PN] 🔲 进行中。[PN] ✅ 已完成。todo.md 异常记录并停在当前阶段。当用户问“我有一堆旧笔记怎么用这个项目”时，给出最短可执行入口：
把旧笔记目录给我，例如 source_path=/path/to/notes。
我会先生成 inventory 和迁移计划，不会改原文件；你确认后再按批次规范化。