用途：kk-migrate 是 kenkeep 知识库的迁移执行技能，负责处理任意待迁移步骤，而非单一版本跳转。知识库以带编号的 schema_version 记录磁盘布局，每个注册的迁移步骤把目录树从一版推进到下一版。判断工作在本会话内由模型完成，没有子代理、没有 runner、没有 -p spawn；所有文件写入都交给该步骤的确定性 CLI 原语，以保留 id 与字节内容。
主要能力与用法：先解析仓库根目录，随后查询待迁移项，例如运行 npx --yes kenkeep@latest migrate status；若已是最新版或无知识库则直接报告并停止。否则输出一行 JSON，列出待执行步骤链。按顺序找到与步骤 id 匹配的过程执行。已知步骤包括 flat-to-tree（1→2）与 okf-v3（2→3）。flat-to-tree 需要在本会话内完成叶节点聚类：先运行 place inventory 获取清单，聚类为少量主题文件夹，保证每个 id 原样保留、相关联节点就近放置，并为每个文件夹撰写单行 summary，组装为 placements 与 folders 文档，经用户审阅后用 place apply --input 写入，再用 index rebuild 重建索引。okf-v3 完全确定性：运行 migrate okf-v3，将字段重命名、迁移 kenkeep 自有字段到 kk_ 前缀、生成 Related 与 Citations 段落、迁移文件夹 summary，并重建索引，随后用 lint 与 doctor 校验。
限制：迁移仅支持交互式会话，没有无头或无人值守模式。不得直接写节点文件，不得自行调用 git（不 add、不 commit、不 restore）；迁移结果以未提交 diff 形式留给用户审阅，用 git diff 查看，由用户决定 commit 或 restore。若某步骤 id 在本文档中无对应过程，必须停止并提示升级技能，不能自创流程。每次写入前原语会校验 id 与文件夹 summary，非法计划会中止且零文件变更。