mcpField
C
complexity-guardrails

complexity-guardrails

github.com/noartem开发1378 次安装2 周前更新
代码仓库

关于 complexity-guardrails

这是一项帮助开发者从项目初期控制代码复杂度的编码技能,提供函数与模块的量化目标及重构方法。

主要功能

  1. 01圈复杂度目标
  2. 02函数长度限制
  3. 03单一职责指导
  4. 04分支重构方法
  5. 05拆分处理阶段

适用场景

  1. 01为代码库设定复杂度标准
  2. 02重构深层嵌套函数
  3. 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