用途:在编写任何实现逻辑之前,把高层架构规格转化为可编译的类型级骨架,用编译器验证架构是否成立,防止代理直接进入实现导致架构走样。
三个阶段:一,从用户提供的评估或设计文档中提取目标架构,产出模块图,包含模块/组件、职责、类型、依赖与边界(FFI、网络、持久化、框架边缘),并声明每层依赖规则,例如领域层不导入项目内其它模块、服务层只导入领域层、FFI 层导入前两层、应用层只导入 FFI 公开接口。二,逐层构建骨架:新建分支(git checkout -b architecture-scaffold),新模块用新文件/目录而非插入已有文件,旧文件暂不改动;从内向外逐层编译,先领域类型,再服务契约,再 FFI 边界,最后应用层。骨架只含协议/特征及其完整方法签名、全部结构体与枚举字段、可编译的桩实现(Swift 用 fatalError,Rust 用 todo!(),TypeScript 用 throw new Error)、模块声明与导入导出结构、FFI 边界类型及绑定层;不含业务逻辑、测试、配置与构建脚本。编译报错需区分偶发错误(拼写、缺导入、可见性)与架构信号(循环依赖、边界类型不匹配、抽象边界错误),后者应回到模块图修改,而非就地打补丁。骨架完成后用 grep 等机械检查依赖方向是否违规。三,映射旧代码库:为每个桩判定 PORT、ADAPT、REWRITE、NEW 或 DELETE,标注 HIGH/MEDIUM/LOW 置信度,产出 migration-manifest.md。
适用场景:大型重构、模块拆分、多语言(如 Rust 与 Swift)边界迁移。
限制:资料未提供安装命令、收费方式与具体运行环境要求;需要用户或代理先有架构评估文档,骨架阶段不写实现逻辑,最终实现不在本技能范围内。