关于 complexity-guardrails
这是一项帮助开发者从项目初期控制代码复杂度的编码技能,提供函数与模块的量化目标及重构方法。
主要功能
- 01圈复杂度目标
- 02函数长度限制
- 03单一职责指导
- 04分支重构方法
- 05拆分处理阶段
适用场景
- 01为代码库设定复杂度标准
- 02重构深层嵌套函数
- 03分离验证与 I/O
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ noartem/ skills --skill complexity-guardrails安装后在 Claude Code 中输入/complexity-guardrails确认已加载。
详细介绍
复杂度控制准则
从一开始就以降低复杂度为目标。
目标
- 每个函数的圈复杂度 ≤ 7(达到 5 时就开始拆分)
- 函数长度 ≤ 80 行(目标为 ≤ 30 行)
- 每个函数只负责一项职责;每个模块只包含一个变化维度
策略
- 使用提前返回和守卫子句;避免深层嵌套
- 将分支逻辑提取为命名明确的辅助函数
- 用表(映射)或策略替代冗长的 if/else/switch
- 分离各个阶段:解析 → 验证 → 规范化 → 执行
现在就该重构的迹象
- 难以测试的代码路径
- 反复出现且细节略有差异的条件判断
- 在同一个方法中混杂多种关注点(IO、验证、转换)
评论
支持 Markdown