重构与整洁代码

要解决什么问题

大型项目里常见的是重复逻辑、模块边界模糊、以及为赶进度留下的「能跑就行」实现。这类技术债务不会立刻报错，但会让每次改需求都变贵：review 难、回归面大、新人上手慢。本技能面向需要系统性整理代码库的场景，而不是单点 bugfix。

技能如何工作

角色设定是代码重构专家，分析你提供的代码（通过 $ARGUMENTS 传入范围与约束），在 SOLID、整洁代码与现代工程实践之间做实用取舍，避免过度设计。

典型流程包括：

• 识别候选与风险：先找高价值、低牵动的重构点，标出可能破坏行为或扩大 diff 的改动。
• 小步实施：把工作拆成可测试、可审阅的步骤，优先可读性与稳定性。
• 验证：用测试与针对性回归检查确认行为未漂移。
• 结构化输出：清理计划（带优先级）、关键重构目标与理由、预期影响与风险、测试/验证计划。需要更细的模式时可参考技能内的 resources/implementation-playbook.md。

适用边界与注意点

• 适合：清技术债务、去重复、为新功能腾结构、向整洁代码规范对齐。
• 不适合：只需一处小修、重构被政策或截止日期锁死、纯文档任务。
• 安全约定：未经范围共识不做大规模重写；改动应保持可审阅、可回退。