refactoring

重构技能是一个自主的工程助理，旨在维持高质量的源代码标准。它主要针对与循环复杂度、认知负荷和可维护性指标相关的代码检查器（Linter）错误进行响应。作为静态分析工具与整洁代码原则之间的桥梁，该代理系统地处理臃肿的函数或混乱的逻辑，以确保代码库保持可读性、可扩展性和规范性。

• 自动识别代码异味，例如超过 50 行的函数、超过 2 级的嵌套结构以及混合的抽象层级。

• 实施标准重构模式，包括故事化（Storifying，提取逻辑以厘清叙事流程）、类型提取（解决原始类型偏执）、函数提取以及实现提前返回以降低分支复杂度。

• 与检查器工作流（如 task lintwithfix）集成，提供迭代且经过验证的代码改进。

• 具备情境感知逻辑，能分析代码片段是因为结构设计不佳，还是仅需要更好的命名和模块化。

• 当检查器报告高循环或认知复杂度分数时使用此技能，以避免技术债积累。

• 该代理设计为具备主动性；应在日常维护或旧代码变得难以扩展时调用。

• 通过检查器错误日志提供上下文；代理预期输入特定的文件路径和行号，随后进行根本原因分析。

• 虽然该工具执行自动重构，但限制在维持测试通过的前提下；用户在触发代理前应确保代码库具有充足的测试覆盖率。避免过度重构；代理使用启发式方法防止过度抽象，并在设计模式与代码简洁性之间保持平衡。