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