devlab-tech-debt-opslisted

# devlab-tech-debt-ops ## 用途 技术债**全生命周期运维**：从审计发现、分级建议，到确认后的安全重构（微观/宏观），再到回归验证。不只是"怎么拆"，还回答"该不该拆、先拆哪里、拆到什么程度"。 **边界**：只处理技术债（可维护性/结构/复杂度），**不改变业务语义**；业务需求变更走**外层 SDD 框架**（trellis/comet/mattpocock，见 `devlab-harness-ops` Step 7）。 ## 适用场景 - **审计场景**：项目需要盘点技术债分布、严重度、优先级，产出审计报告供决策。 - **微观重构**：单文件/单类内部整理（提取方法、消除重复、简化条件分支）。 - **宏观重构**：跨模块/架构级拆分（god-class 拆解、引擎解耦、分层重构）。 - **引用清零**：大范围重命名/搬迁/删除旧实现，需安全地"引用清零"。 ## 不适用场景 - 加新功能（走外层 SDD 框架，见 `devlab-harness-ops` Step 7）。 - 业务逻辑本身要变（那是业务债，不是技术债）。 - 一次性小改动（直接改即可，不必起编排）。 ## 输入 - 目标代码单元（类/模块/引擎/整个项目）与痛点描述。 - 现有测试覆盖情况。 - 约束：是否允���破坏性变更、时间盒、微观/宏观/混合。 ## 输出 - **审计报告**（债务分布图 + P0-P3 分级 + 建议优先序 + ROI 评估）。 - **现状固化文档**（架构/流程/组件职责/问题分层）。 - 拆分设计（目标模块划分 + 职责边界 + 迁移映射）。 - 分步重构任务清单（小步、每步可回退、可验证）。 - 回归结果（行为不变的证据）。 ## 工作流 ``` Phase 0: 审计（Audit） [微观] 扫描代码坏味道（长方法/重复/复杂条件/过深嵌套） [宏观] 扫描架构债（循环依赖/god-class/分层违规/耦合度）+ 深化机会（浅模块/抽象泄漏，见 references/REFERENCE-DEEP-MODULE-DESIGN.md） -> 产出审计报告：债务清单 + P0-P3 分级 + 建议优先序 + ROI 估算 -> ⛔ Gate G0：审计报告确认，用户决定处理范围 Phase 1: 现状梳理与固化（不改代码） [微观] 记录当前方法/类内部结构与职责 [宏观] 梳理目标单元的架构/执行流程/模块间依赖 -> 形成固化 md 作为重构依据 -> ⛔ Gate G1：现状与问题清单确认 Phase 2: 建立安全网 [微观] 补齐单元测试/行为快照测试 [宏观] 补齐集成测试/端到端表征测试（characterization tests） -> 无测试的高风险路径先补测试再动 -> ⛔ Gate G2：安全网是否覆盖将要改动的行为 Phase 3: 拆分设计 [微观] 提取方法/变量/参数对象/Guard Clause 设计 [宏观] 目标模块划分 + 职责边界 + 从旧到新的迁移映射 -> 按需选用设计模式（见 references/REFERENCE-DESIGN-PATTERNS.md），切勿过度设计 -> ⛔ Gate G3：拆分方案确认 Phase 4: 小步重构 + 引用清零安全移除 [微观] 逐个提取/重命名/简化 -> 单元测试通过 -> 提交 [宏观] 抽取/搬迁模块 ->