用途:把 Java Maven 或 Gradle 项目(整项目、单个模块、一致性审计、迁移规划或已有 Rust 移植的续做)迁移为按项目形态组织的 Rust Cargo 工作区。核心理念是迁移契约与可观察行为,而非 Java 语法;保留 Java 的公开概念与源码可追溯性,改用 Rust 原生的所有权、错误、并发、异步、序列化与框架机制。
主要能力:确定 Rust 目录布局(按 Java 包根之后的路径派生,保留有意义的嵌套包,不压平或双重嵌套;对象名转为感知缩写的 snake_case.rs,Rust 类型保持 PascalCase);以“一个 Java 对象对应一个 Rust 对象边界”为原则,500 行内视为正常、501–800 行做内聚性评审、超过 800 行阻断;lib.rs 与 mod.rs 只放声明与再导出;单元测试放 #[cfg(test)],公开边界、跨模块、差分与整项目测试放 tests/ 或非发布 <project>-test 包。
使用方式:先冻结基线与范围,再实现、冻结、审计、统一验证。工具包括 python3 "$SKILL_DIR/scripts/audit_migration_layout.py"(带 --java-package-root、--rust-root、--retain-segments 2、--require-source-comments、--fail-on-warning 等参数)做布局审计,以及 python3 "$SKILL_DIR/scripts/scaffold_migration_docs.py" 生成迁移路线图.md、对象级对照表.md、语义迁移对照表.md、对象名称一致性检查.md 四份文档。对象状态用 MISSING、MISPLACED、STUB、PARTIAL、UNVERIFIED、IMPLEMENTED、DEPENDENCY_REUSED、PLATFORM_NA、RUST_EXTENSION 如实分类,只有前三类计入已处理。
适用场景与限制:适合需要保持行为与公开契约的 Java→Rust 迁移及其审计、规划。仅要求审计、规划或文档时不得修改迁移代码;plan-only 或只读请求不授权运行会写文件的脚手架,应返回四份文档内容、使用 --dry-run 或只写用户批准的目标;未经授权不得把模块迁移扩大为仓库重写,也不得默默更改基线。依赖选择需按契约、许可、MSRV/目标、运行时、协议、安全与维护等门禁筛选。缺失信息需显式标注为未知,其余事实暂未提供。