菜单
旧笔记批量导入、盘点和规范化。用于用户已经有一堆 Markdown/Obsidian/零散学习笔记，想接入本项目工作区、按项目 Obsidian 规范补 frontmatter、标签、双链、Callout、MOC，并保留原始文件时使用。触发词：旧笔记导入、已有笔记、一堆笔记、批量整理、迁移到这个项目、按项目规范、import existing notes、normalize notes。
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/Treasoni/Study-Notes --skill legacy-note-importer命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
Collect and curate technical research in two gated stages with compact source records. Use for systematic research, source gathering, research materials, or when a learning-note workflow is at collection phase P1 or P2.
发现当前运行时可用于资料收集的网页、浏览器、MCP 与研究技能，并刷新项目资料工具指南。用于询问可用工具、搜索工具、研究能力或资料收集方案时。
Obsidian 笔记智能美化与发布。用于将最终学习笔记处理成 Obsidian Markdown，补 frontmatter、标签、Callout、双链，并保存到用户指定位置。触发词：美化、Obsidian、优化格式、笔记美化、发布到 vault、beautify。
基于 SOC 职业分类
正在显示 SKILL.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 创建项目目录和命名 workflow state file：
${WORKSPACE_PATH:-./workspace}/{project_slug}/
写入 00_import_intent.md，记录来源、目标、发布策略、批处理大小和是否允许更新旧内容。创建后读取 workflow state file，确认当前阶段是 [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。在用户确认计划前，不进入批量改写。
每批读取 workflow state file 和 02_migration_plan.md，只处理本批文件。对每篇 normalize 笔记：
.codex/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，包含数量统计、跳过原因、风险、后续建议。
${WORKFLOW_STATE_FILE}。.codex/scripts/todo-state.sh "${WORKFLOW_STATE_FILE}" start PN 将当前阶段改为 [PN] 🔲 进行中。.codex/scripts/todo-state.sh "${WORKFLOW_STATE_FILE}" complete PN 改为 [PN] ✅ 已完成。.codex/scripts/todo-state.sh "${WORKFLOW_STATE_FILE}" skip PN "原因" 明确跳过。当用户问“我有一堆旧笔记怎么用这个项目”时，给出最短可执行入口：
把旧笔记目录给我，例如 source_path=/path/to/notes。
我会先生成 inventory 和迁移计划，不会改原文件；你确认后再按批次规范化。