用途:在代码重写或迁移前做架构分析,只产出能降低特定失败模式的产物,避免浪费代理上下文。产物分两类:实现保真(行为/契约保真、接缝契约)与设计证据(用于决定单元数量与拆分,不预先拍板)。
主要能力:生成全局产物 unit_graph.yaml、migration_boundary.yaml、wire_contracts.yaml、shared_modules.yaml、cross_unit_state.yaml、seams.yaml(无接缝则省略),以及 architecture_index.md、project-structure.md、tech-stack.md、data-model.md;每个单元生成 behavior.yaml、bindings.yaml、unit_decomposition.yaml。单元定义为可外部触发的入口点(HTTP 路由、定时任务、消息处理器、UI 页面、公共 API、CLI 命令),每个源文件最多属于一个单元,被两个及以上单元使用则归入 shared_modules.yaml。
使用方式:先加载上下文与 references/extraction-signals.md,再依次构建 unit_graph、migration_boundary、逐单元文件、wire_contracts、cross_unit_state、seams 与架构索引。完成前须执行自检:统计 unit_graph.yaml 中单元数与 units/*/behavior.yaml 数量是否一致,不一致立即补齐;确认 migration_boundary 存在、索引含每个单元的实现指南、无 TBD、unit_decomposition.commit 为 false 等。
限制:不产出 target_idiom(位于顶层 SKILL.md);不写测试/构建/部署/基础设施覆盖,无独立风险登记;禁止编造评分或置信度数字,质量值须由工具计算并附来源;分类词表仅供判断,非 CI 枚举;接缝冻结侧在迁移阶段不得重构。