low-complexity

low-complexity 技能是一款专业的开发工具，旨在开发环境或编码代理工作流程中自动执行代码质量标准。它专注于 SonarSource 的认知复杂度指标与标准循环复杂度，确保每一个函数、方法、类或模块都维持在可管理的范围内。此技能针对软件工程师、技术主管以及实践 Clean Code 方法论的团队，目标是在代码进入仓库之前，就预防技术债与复杂逻辑的产生。

• 在不需要明确触发的情况下，自动监控每一项代码修改、编写与重构任务。

• 强制执行严格的复杂度阈值：维持认知与循环复杂度低于 5，并针对复杂逻辑设定 15 的绝对上限。

• 提供业界标准的简化技术指引，包含函数提取、提前返回 (early return)、防御性代码 (guard clauses)，以及将嵌套循环替换为声明式管线或函数式编程模式。

• 支持所有编程语言与框架，使其成为适用于任何现代开发堆栈的通用约束规范。

• 内置逻辑评估速查表，协助开发人员在编码过程中进行复杂度心算。

• 使用方式为将其安装至你的 Agent CLI 环境中。它会在执行代码生成、功能实现、错误修复或重构时自动启动。

• 当复杂度超过建议上限时，Agent 将会提供具体、可操作的重构步骤以简化逻辑。

• 优先顺序建议：优先考虑方法提取，接着是提前返回，再者是扁平化嵌套条件，并利用现代编程语言特性如 Optional chaining、空值合并运算符 (null-coalescing) 及模式匹配。

• 适用于任何涉及高逻辑性组件、复杂 API 处理程序或关键业务服务层的任务，其中代码的可读性与可测试性至关重要。

• 请注意，尽管 Lambda 通常是被允许的，但它们会增加嵌套深度，因此本技能鼓励保持闭包的浅层结构，以避免结构性复杂度惩罚。