リファクタリング技法

概要

外部から見た振る舞いを変えずに、内部構造を改善する体系的手法を提供するスキル。 コードスメルの検出、適切なリファクタリングパターンの選択、テスト保護下での安全な実施を支援する。

ワークフロー

Phase 1: コードスメル分析

目的: リファクタリングが必要な箇所を特定する

アクション:

1. 対象コードをスキャンしてコードスメルを検出
2. 優先度に基づいて対処順序を決定
3. 影響範囲と依存関係を把握

Task: agents/analyze-code-smells.md を参照

Phase 2: リファクタリング計画

目的: 適切なリファクタリングパターンを選択し計画を立てる

アクション:

1. 検出されたスメルに対応するパターンを選択
2. 段階的な実施計画を策定
3. テスト戦略を確認

Task: agents/plan-refactoring.md を参照

Phase 3: リファクタリング実施

目的: 計画に基づいて安全にリファクタリングを実行

アクション:

1. テストが通ることを確認
2. 小さな変更を順次適用
3. 各ステップでテストを実行
4. 完了後に全テストを実行

Task: agents/apply-refactoring.md を参照

Task仕様ナビ

詳細仕様: 各Taskの詳細は agents/ ディレクトリを参照

ベストプラクティス

すべきこと

• テストが通っている状態でのみリファクタリングを開始する
• 一度に一つのリファクタリングに集中する
• 小さなコミットで変更を記録する
• 変更後は必ずテストを実行する
• コードの意図を明確にする命名を心がける

避けるべきこと

• テストなしでのリファクタリング
• 複数のリファクタリングの同時実施
• 外部インターフェースの変更
• パフォーマンスを検証せずに進める
• リファクタリングと機能追加の混在

リソース参照

references/（詳細知識）

scripts/（検証・実行）

assets/（テンプレート）

変更履歴