laravel:complexity-guardrails について
Laravel 開発者向けに、関数やモジュールの設計目標とリファクタリングの兆候を示す複雑さ管理スキルです。早期リターンやヘルパーへの抽出、処理段階の分離を提案します。
主な機能
- 01複雑度と関数長の目標設定
- 02関数ごとに単一責任を維持
- 03早期リターンとガード節の活用
- 04分岐を名前付きヘルパーへ抽出
- 05処理を段階ごとに整理
活用シーン
- 01テスト困難なコード経路の分割
- 02微妙に異なる条件分岐の整理
- 03I/O・検証・変換処理の分離
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/laravel:complexity-guardrailsを入力して読み込まれたか確認します。
詳細
複雑さのガードレール
最初から複雑さを抑える設計にします。
目標
- 関数ごとの循環的複雑度 ≤ 7（5 から分割を始めます）
- 関数の長さ ≤ 80 行（≤ 30 行を目指します）
- 関数ごとに責務を 1 つにし、モジュールごとに変動要因を 1 つにします
手法
- 早期リターンとガード節を使い、深いネストを避けます
- 分岐の本体を名前付きヘルパーに切り出します
- 長い if/else/switch をテーブル（マップ）またはストラテジーに置き換えます
- フェーズを分離します：解析 → 検証 → 正規化 → 実行
今すぐリファクタリングすべき兆候
- テストが難しいコードパス
- 微妙に異なる条件分岐の繰り返し
- 1 つのメソッド内で関心事（IO、検証、変換）が混在している
コメント
Markdown 対応