リファクタリングガイド
コーディング上級
指定されたコードを分析し、重複コード、長い関数、複雑な条件分岐などのコードスメルを検出します。各問題に対して段階的なリファクタリング方法と改善効果の見込みを提示します。
トリガー
/refactor [file]使用頻度必要時
レガシーコードを引き継いでどこから手をつければいいか分からないときなら？ /refactorで優先順位 + 段階別計画を確保
リファクタリングコード品質設計
動作フロー
/refactor [ファイル] 実行
↓
フェーズ1: 4つの計測を並列実行
length-check
関数の長さ計測
complexity
循環的複雑度分析
dup-detect
コード重複検出
nesting-check
ネスト深度チェック
↓
健全性スコア算出 → 改善計画策定
↓
✓ 健全性スコア X/10 + 段階別リファクタリング計画
スキルコード
# Refactor Guide Skill
## Trigger: /refactor [file]
When invoked:
1. Analyze code quality:
- Function length (flag > 30 lines)
- Cyclomatic complexity
- Duplicate code blocks
- Deep nesting (> 3 levels)
- Parameter count (flag > 4)
2. Identify patterns:
- Extract Method opportunities
- Replace Conditional with Polymorphism
- Introduce Parameter Object
- Move Method / Extract Class
3. Output format:
---
## ♻️ Refactoring Report
### Code Health Score: [X/10]
### Issues Found
1. **[Issue Type]** at line [N]
- Problem: [description]
- Suggestion: [refactoring technique]
- Impact: [readability / performance / maintainability]
### Refactoring Plan
Step 1: [action] — [why]
Step 2: [action] — [why]
### Before / After Preview
[code comparison]
---
コピーしてCLAUDE.mdに貼り付ければ、すぐに使えます。
リファクタリングガイド の仕組み
Refactor Guideは対象ファイルのコードスメル（長い関数、深いネスト、重複ロジック、Godオブジェクトなど）をスキャンし、各変更のビフォー/アフター例とリスク評価を含むステップバイステップのリファクタリング計画を作成します。
リファクタリングガイド が力を発揮する場面
テストのないレガシーコードベースで、既存の動作を壊さずに構造を改善する必要があるときに最適です。各リファクタリングステップが安全かつ可逆的である必要がある場面で威力を発揮します。
主な強み
- 複数のコードスメルカテゴリを自動検出
- 安全で段階的なリファクタリングステップを生成
- 各提案変更のリスク評価を含む
- 明確さのためのビフォー/アフター例を提供