用途:在 Forge 内核边界之间搬运 issue 数据——把 backlog 投影为可提交 git 的快照(并可回灌),或把已有 issue 存储导入内核。这是数据可移植性,区别于 schema/数据库迁移和云端后端同步(forge sync)。
主要能力与用法: 导出/回灌 backlog: forge export 将内核 backlog 写入 git 跟踪的 JSONL(确定性); forge export --dir <path> 指定投影目录; forge export --dry-run 仅显示将写入内容,不做改动; forge export --import 把已提交的 JSONL 快照读回内核(hydrate)。 forge export 是 D16 可移植性投影:确定性的、可提交 git 的 backlog 快照,可在 diff 中审阅,并在机器或检出之间携带。forge export --import 为反向操作,从磁盘快照回灌内核;若发现数据已存在,会报告“already hydrated”,而非声称导入了内容。
从 Beads 迁入(或预览 v2→v3): forge migrate --from beads [--dry-run] 将 Beads issue 存储导入内核; forge migrate --from beads --source <dir> 指向导出的 beads *.jsonl(默认自动检测 .beads/); forge migrate --dry-run 预览 v2→v3 迁移(无 --from 时唯一支持的模式)。 forge migrate --from beads 是来自 Beads 用户的入门路径,--dry-run 只读取并映射,不写入。无 --from 时 migrate 仅做 v2→v3 预览:必须使用 --dry-run,且应用迁移尚不可用。
边界:内核的云端/后端同步是 forge sync(云原生),属不同操作;本技能是本地、基于 git 的可移植性投影。数据库/schema 迁移(加列、改表)属应用工作,用 plan/dev,而非 forge migrate。持久化决策或笔记是 memory(forge remember),不是 export。PR 前同步 git 分支与 main 是 ship/worktree。
限制:应用 v2→v3 迁移暂未提供;其余细节以官方资料为准。