维护

Migrate:将基于 manifest 的 Lagune 项目迁移到 skills 和插件

将基于 manifest 的 Lagune 项目迁移到基于 skills 的 Lagune,同时保留你的安全原则、产物、追踪和你自己的专项。

🔀 将基于 manifest 的 Lagune 项目迁移到基于 skills 的 Lagune,你写过的一切都会保留。

弃用通知

带有 manifest 的项目会一直照常运行到 v1.x:npx lagune 会把 init、pull、update、add、remove、list 和仪表盘交给 lagune@0.15.0 处理,这是最后一个基于 manifest 的版本。

如何迁移​

  1. 确认当前的工作都已提交,然后在项目根目录运行 migrate:

    npx lagune migrate
  2. 把它做出的改动单独提交,让这次迁移保持为一个便于审查的变更。

  3. 按照 安装页面 的说明,为你的智能体安装命令。

  4. 如果项目里已经有 detect、plan 或 harden 产物,请让 /lagune-repair 核对并更新这些产物和你自己的专项中的旧引用:

    /lagune-repair 把 `.lagune/memory/` 下各产物(`detect.md`、`plan.md` 和 `harden.md`)中已应用的专项(以前叫 sub-skills)与新目录列出的名称核对并更新,并把我在 `.lagune/catalog/` 中自己的专项对 `.lagune/hooks/` 中旧 hook 的每一次调用,都改写为对 `lagune_read` 或 `lagune_write` 工具的调用。

有哪些变化​

迁移前迁移后
.lagune/templates/、.lagune/hooks/ 和 .lagune/specializations.md已移除:每个 skill 自带模板,hook 由引擎运行
.lagune/skills/ 中内置专项的副本已移除:内置专项由引擎提供
.lagune/skills/ 中你自己的专项移至 .lagune/catalog/
.lagune/skills.json,即你自己的专项的索引合并到 .lagune/configs.json
manifest 中的类别记录在 .lagune/configs.json 中
旧的智能体命令,例如 /lagune.detect已移除:安装 Lagune 后会带来新命令,例如 /lagune-detect
.gitignore 中的 Lagune 区块已移除,如果文件里没有其他内容,文件也一并删除
.lagune/proofs/,原本由该区块忽略由它自己的 .gitignore 排除在提交之外
.lagune/manifest.json最后删除

你的安全工作保持不变:安全原则、每个阶段生成的产物,以及记录了每个发现项所指路径的追踪映射。

常见问题

是的。基于 manifest 的项目已被弃用,只能继续使用到 v1.x,所以请运行 npx lagune migrate 迁移你的项目。

你的安全原则、每个阶段产物、追踪映射、你的类别以及你自己的专项。专项会移到 .lagune/catalog/,它们的索引会和你的类别一起放进 .lagune/configs.json。

在运行 migrate 之后,按照安装页面针对你的智能体给出的说明安装。先安装也可以,因为 migrate 会保留新的 /lagune。

先拉取这次迁移,然后运行一次 npx lagune migrate。它会删除基于 manifest 的 Lagune 留在你本地克隆中的内容(这些内容从未纳入版本控制),并把你的证明文件排除在提交之外。