笔记知识库结构迁移
对比知识库当前配置与原始设计,生成目录、模板和链接的迁移计划,经确认后执行并检查结果。
功能与用途
适用于已用 Ars Contexta 建立的笔记知识库,在调整目录组织、笔记字段、导航层级或自动化设置后,同步更新相关文件。它会对比当前配置与原始设计,列出受影响的笔记、模板、目录和处理流程,给出迁移范围与风险。你可以先预览全部变更,也可只检查某个配置维度;确认后执行迁移,更新链接与设计记录,并检查字段、导航和链接是否一致。使用前需已有当前配置和原始设计记录。
适用场景
- 从平铺目录改为分层目录:调整笔记组织配置后,规划文件移动与导航目录变更,迁移时同步更新相关链接。
- 批量迁移笔记字段:新增必填字段或修改枚举值后,更新模板与已有笔记,并检查字段是否符合新要求。
- 调整知识库导航层级:调整主题导航配置后,规划导航页拆分或合并,同步笔记主题入口与上级导航。
- 预览自动化配置影响:修改自动化设置后,仅预览需要更新的触发规则和处理流程,确认影响范围。
适用人群
- Ars Contexta 知识库维护者
- 维护个人研究笔记的研究人员
- 管理 Markdown 知识库的知识工作者
使用步骤
- 修改 ops/config.yaml 中需要调整的配置。
- 运行 /refactor,或指定要检查的配置维度。
- 查看受影响文件、迁移范围及配置冲突。
- 确认执行计划,或用 --dry-run 仅预览。
- 查看迁移与校验报告,处理列出的遗留问题。
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 知识
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes Agent、国内 Agent
- 使用难度
- 进阶
- 版本
- 2acfd5c
- 最近更新
- 2026-11-12
- 文件数
- 4
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
使用前准备
- 已在 Claude Code 中配置 Ars Contexta,并建立可读取和修改的笔记知识库。
- 知识库中需有 ops/config.yaml 和 ops/derivation.md,分别记录当前配置与原始设计。
- 先在当前配置中保存希望实施的调整;已有词汇映射记录时可沿用知识库自定义名称。