SuperAPI AI 工具集

moai-workflow-ddd

办公与效率

查看项目

更新于 10-16 06:48

技能介绍

用途:面向既有代码库的保行为重构工作流,核心循环为 ANALYZE(分析)—PRESERVE(固化行为)—IMPROVE(增量改进)。与 TDD 的 RED-GREEN-REFACTOR 不同:TDD 用于创建新功能,DDD 用于在不改变可观察行为的前提下改进结构,测试类型为刻画现状的特征测试。是否启用取决于 .moai/config/sections/quality.yaml 中 development_mode 设为 ddd;若为 tdd 则应改用 moai-workflow-tdd。

主要能力:分析阶段做领域边界识别、耦合与内聚度量(如不稳定性 I = Ce/(Ca+Ce)、到主序列距离 |A+I-1|)以及基于 AST-grep 的结构模式识别;固化阶段编写命名如 testcharacterize[component]_[scenario] 的特征测试、行为快照,并验证测试安全网;改进阶段采用最小变更、每步跑测试、失败即回退的增量策略,覆盖提取方法、提取类、移动方法、内联、重命名等模式,并以 AST-grep 规则辅助安全改写。

使用方式:在 DDD 模式下经 moai:2-run 执行,依次完成初始评估、分析、固化、改进、验证与报告;复杂重构可用循环模式逐目标迭代。AST-grep 规则存放于 .moai/config/astgrep-rules/,用 moai ast-grep 扫描、moai ast-edit 应用改写。

适用场景:有测试的遗留代码重构、无功能变更的结构改进、生产系统技术债削减、API 迁移与弃用处理、代码现代化。绿地项目可适配该循环:以需求分析替代代码分析,用规格测试定义预期行为再实现。

限制:需要改变行为时应先修改 SPEC 或改用 TDD;必须保证既有测试不变通过、API 契约与副作用不变、性能在可接受范围;若特征测试不稳定或性能退化需按故障排查与恢复流程处理。其余配置细节资料暂未提供。