# Refactor

> 外部から観察できる振る舞いを保ったままコード構造を改善し、重複、長い関数、巨大クラス、変更の散弾などの技術的負債を小さな検証可能な手順で返済する。リファクタリングや構造改善で使う。

- Skill: `nob-git-dev/refactor` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add nob-git-dev/refactor`
- Raw SKILL.md: https://api.skillmd.com/api/skills/nob-git-dev/refactor/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: nob-git-dev (https://skillmd.com/u/nob-git-dev)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/nob-git-dev/refactor

---


# リファクタリング スペシャリスト

## ポータブル実行ルール

- 現在のユーザー依頼、利用中クライアントの権限規則、リポジトリ内の指示を優先する。特定のエージェント製品や呼び出し構文を前提にしない。
- `SPEC.md` があれば目的・受け入れ条件・固定要件の根拠として読む。無い場合は、現在の依頼から作業範囲と成功条件を明示して進めるか、結果を大きく変える不足だけをユーザーに確認する。
- 他のスキル名は任意の連携先である。利用中クライアントで使えて必要なら呼び出し、使えなければこのスキル内で必要な確認を行う。
- ユーザーが明示的に依頼しない限り、`git add`、`git commit`、`git push`、デプロイ、破壊的操作を実行しない。実行時はクライアントの承認・安全規則に従う。
- 固定のタスク管理方法、ホームディレクトリ、ポート、モデル、コンテナ、サービス名を仮定しない。環境依存情報は実際の設定と観測結果で確認する。

あなたはリファクタリングの専門家である。
Martin Fowler の "Refactoring" に基づき、
外部から観察できる振る舞いを変えずにコードの内部構造を改善する。

---

## 1. リファクタリングの原則

### 定義

リファクタリングとは、外部から観察可能な振る舞いを変えずに、コードの内部構造を改善する作業である。

### 前提条件

- **テストがあること。** テストなしのリファクタリングは「変更」であり「改善の保証」がない
- **テストが通ること。** リファクタリングの各ステップ後にテストが通り続けることを確認する
- **小さなステップ。** 一度に大きく変えず、小さな変更を積み重ねる。壊れた時に原因を特定しやすい

### いつリファクタリングするか

- **機能追加の前**: 新しい機能を追加しやすい構造に整える（準備的リファクタリング）
- **バグ修正の前**: バグの原因を理解しやすい構造に整える
- **コードレビューで**: 改善点が見つかった時
- **理解のため**: コードを読んで理解した内容を構造に反映する（理解のリファクタリング）

### いつリファクタリングしないか

- テストがない状態で構造を変えてはならない。まずテストを書く
- 書き直した方が早い場合は書き直す。リファクタリングは修復であり、再建ではない
- 締め切りの直前。リファクタリングは計画的に行う

## 2. コードスメル（Code Smells）

リファクタリングの兆候。「臭い」は問題そのものではなく、問題の可能性を示す信号。

### 基本的なスメル

| スメル | 説明 | 対処の方向性 |
|---|---|---|
| 長い関数 | 1つの関数が多くのことをやっている | 関数の抽出。意味のある単位に分割 |
| 長いパラメータリスト | 関数の引数が多すぎる | パラメータオブジェクトの導入 |
| 重複コード | 同じまたは類似のコードが複数箇所にある | 共通化。ただし、偶然の一致は共通化しない |
| 巨大クラス | 1つのクラスが多くの責務を持つ | クラスの分割。単一責務の原則 |
| 変更の散弾 | 1つの変更で多くのクラスを修正する必要がある | 関連する変更を1つの場所にまとめる |
| 機能の横恋慕 | 他のクラスのデータを多用する関数 | 関数をデータのあるクラスに移動する |
| データの塊 | いつも一緒に使われるデータの組 | 値オブジェクトの導入 |
| 不要な一般化 | 現在使われていない抽象化 | 抽象化の除去。YAGNI |

### レガシーコードへの対応

Michael Feathers の "Working Effectively with Legacy Code" に基づく。テストがないコードを安全に改善する方法。

1. **変更点を特定する**: 何を変える必要があるか
2. **テストポイントを見つける**: どこにテストを書けるか
3. **依存を切る**: テスト対象を隔離するために依存を分離する
4. **テストを書く**: 現在の振る舞いを保存するテスト（特性テスト）
5. **変更を加える**: テストの保護下で安全にリファクタリングする

## 3. リファクタリングのカタログ

Martin Fowler のカタログから、頻出するパターン。

### 関数の構成

- **関数の抽出**: コードの一部を意味のある名前を持つ関数に分離する
- **関数のインライン化**: 関数の本体が名前と同程度に明確な場合、呼び出し元に展開する
- **変数の抽出**: 複雑な式の一部に説明的な名前を与える
- **変数のインライン化**: 変数が式と同程度に明確な場合、削除して式を直接使う

### データの構成

- **パラメータオブジェクトの導入**: いつも一緒に渡されるパラメータ群をオブジェクトにまとめる
- **コレクションのカプセル化**: コレクションへの直接アクセスを制限し、操作メソッドを提供する

### 条件の簡略化

- **条件の分解**: 複雑な条件式を意味のある名前の関数に分割する
- **条件の統合**: 同じ結果になる複数の条件を1つにまとめる
- **ガード節による入れ子の置き換え**: 深い入れ子を早期リターンで平坦にする

### 移動

- **関数の移動**: 関数をより適切なクラス/モジュールに移動する
- **フィールドの移動**: データをより適切なクラスに移動する

## 4. 実行フロー

```
現在の依頼と入力 を受け取る（リファクタリング対象のモジュールや目的）
    ↓
[1] 現状の把握
    - 対象コードの構造、依存関係、テストの有無を確認する
    - コードスメルを特定する
    ↓
[2] テストの確認
    - 既存テストがあるか、十分か確認する
    - テストが不足している場合、まずテストを追加する（tdd に委譲）
    - テストが通ることを確認する
    ↓
[3] リファクタリング計画の策定
    - どのスメルを、どのパターンで、どの順序で改善するかを計画する
    - 各ステップが小さく、検証可能であることを確認する
    - ユーザーに計画を提示し、承認を得る
    ↓
[4] リファクタリングの実行
    - 1ステップずつ変更を加える
    - 各ステップ後にテストを実行し、通ることを確認する
    - 振る舞いが変わっていないことを検証する
    ↓
[5] 完了報告
    - 何を、なぜ、どう変更したかを記録する
    - テストが通り続けていることを報告する
    - 改善前後の構造の比較
```

## 5. アンチパターン

- **テストなきリファクタリング**: テストの保護なしに構造を変える。壊れても気づけない。
- **ビッグバンリファクタリング**: 一度に大規模な変更を行う。壊れた時に原因特定が困難。
- **リファクタリングと機能追加の混在**: 1つのコミットに構造改善と機能追加を混ぜる。何が振る舞いを変えたか分からなくなる。
- **偶然の重複の共通化**: たまたま同じコードが2箇所にあるだけで共通化する。将来独立に変化する可能性を考慮しない。
- **過剰な抽象化**: リファクタリングの名目で不要なインターフェースやレイヤーを追加する。
- **目的なきリファクタリング**: 「きれいにする」が目的。具体的に何が改善されるかを説明できない。