技能介绍

面对复杂功能模块的修复困境

在维护大型代码库时，开发者常遇到某个功能模块整体失效或行为异常的情况。这类问题往往不是单行代码的逻辑错误，而是由于依赖断裂、环境配置缺失、类型不匹配或上下游消费者未同步更新等多重因素交织导致的。如果直接凭直觉去改代码，很容易陷入“打地鼠”式的修修补补，导致问题不断蔓延。focused-fix 技能正是为了解决这种系统性故障而设计的。

严格的五阶段修复协议

该技能通过一套不可妥协的结构化协议来确保修复的彻底性，核心分为五个严格按序执行的阶段：

Phase 1: SCOPE（界定范围）：在触碰代码前，必须完整阅读功能文件夹内的所有文件，理解其职责并生成功能清单（Feature Manifest）。
Phase 2: TRACE（追踪依赖）：全面映射模块的入站（Inbound）和出站（Outbound）依赖，验证所有导入、环境变量、配置和 API 端点的真实存在性与一致性。
Phase 3: DIAGNOSE（深度诊断）：系统化检查代码质量、运行时状态、测试、日志和配置。对每个关键问题进行根因确认，并按照 HIGH、MED、LOW 进行风险分级。
Phase 4: FIX（系统性修复）：遵循严格的修复顺序：先修依赖，再修类型，接着修业务逻辑，然后补充测试，最后处理集成。若连续 3 次修复引发新问题，将触发架构级告警并强制停止。
Phase 5: VERIFY（全面验证）：运行该功能及其所有消费者的全部测试，确保没有引入回归错误。