用途:该技能负责 Java 到 Zig 迁移的治理,把迁移视为可观察契约的保留,而非语法翻译或生产文件数量统计。Java 在 Zig 完整证明约定分母前始终是兼容性基准。
主要能力:建立基线与范围,记录 Java/Zig 的 SHA、JDK/构建工具版本、Zig 版本、目标三元组、优化模式等;维护四份迁移文档(迁移路线图.md、对象级对照表.md、语义迁移对照表.md、对象名称一致性检查.md);使用 MISSING、MISPLACED、STUB、PARTIAL、UNVERIFIED、IMPLEMENTED、DEPENDENCY_REUSED、PLATFORM_NA、ZIG_EXTENSION 等状态精确标记;按依赖批次实现,冻结完整对象、方法、测试与资产分母;统一验证格式化、构建、测试、差分、真实主机与回滚演练。
使用方式:与 Zig 技能包组合使用,如 $zig-0.16 或 $zig-0.15、$zig-project-structure、$zig-build-system、$zig-testing、$zig-java-migration-testing 等;在 build.zig 中注册 zig build migration-test 步骤,并建立非生产的 <project>-test/ 模块承载完整源套件回放与差分证据。
适用场景:迁移 Java 仓库、模块、框架、API、测试、夹具、脚本与示例;审计不完整移植;需要逐用例差分验证与真实主机集成验证的项目。
限制:不得简化 Java 语义、遗漏重载或异常行为、以文件存在或构建成功充当实现、使用占位错误或空测试、把分配器泄漏或 ABI 变更视为内部细节、修改复制的源夹具、以两套独立通过的套件当作等价、使用抽样差分或覆盖率百分比作为完成声明。真实主机、负载、安全、发布与回滚声明需独立证据。具体命令与模板细节暂未提供。