refactoring-patterns

設計パターンを用いた段階的リファクタリングの判断・計画・適用・検証を支援するスキル。変化点の見極めとテスト保護を前提に、過剰な抽象化を避けて構造改善を進める。Anchors:• Refactoring to Patterns (Joshua Kerievsky) / 適用: パターン導入手順 / 目的: 段階的移行• Design Patterns (GoF) / 適用: パターン選定 / 目的: 責務分離と拡張性• Working Effectively with Legacy Code (Michael Feathers) / 適用: レガシー安全性 / 目的: 変更の安全確保Trigger:Use when refactoring legacy or complex code by introducing design patterns incrementally while preserving behavior.refactoring patterns, design patterns, legacy code, strategy pattern, adapter pattern, template method, factory

⭐3stars🔀0forks📁View on GitHub🕐Updated Jan 10, 2026

When & Why to Use This Skill

This Claude skill provides a systematic framework for incremental refactoring using industry-standard design patterns. It enables developers to transform legacy or complex codebases into maintainable architectures by identifying change points, planning pattern-based transitions, and executing refactoring steps under strict test protection to ensure behavioral consistency.

Use Cases

  • Modernizing legacy systems by incrementally introducing GoF design patterns like Strategy, Adapter, and Factory.
  • Decoupling complex business logic to improve code maintainability and scalability through structured architectural improvements.
  • Executing safe code transitions in large-scale projects by following a 'Refactoring to Patterns' workflow with built-in verification.
  • Documenting architectural decisions and refactoring plans to maintain technical debt transparency and team alignment.
namerefactoring-patterns
description|
• Refactoring to Patterns (Joshua Kerievsky) / 適用パターン導入手順 / 目的: 段階的移行
• Design Patterns (GoF) / 適用パターン選定 / 目的: 責務分離と拡張性
• Working Effectively with Legacy Code (Michael Feathers) / 適用レガシー安全性 / 目的: 変更の安全確保

refactoring-patterns

概要

設計パターンを使ったリファクタリングを、判断→計画→段階的適用→検証の順で進めるためのスキル。 コードスメルの背後にある変化点を特定し、最小限のパターン導入で保守性を高める。 判断理由を記録し、再現性のある改善プロセスにする。


ワークフロー

Phase 1: パターン機会の特定

目的: パターン導入が有効な変化点と候補パターンを洗い出す

アクション:

  1. 影響範囲と既存テストを確認する
  2. references/pattern-opportunities.md で変化点/スメルを整理する
  3. references/pattern-selection-matrix.md で候補パターンを絞り込む
  4. パターン機会レポートを作成する

Task: agents/identify-pattern.md を参照

Phase 2: パターン導入計画と段階的適用

目的: 段階的な導入計画を作り、テスト保護下で小さく適用する

アクション:

  1. assets/pattern-refactor-plan-template.md で計画を作成する
  2. references/incremental-application-steps.md の手順で変更を分割する
  3. scripts/validate-pattern-plan.mjs で計画の欠落を検出する
  4. 変更を段階的に適用し、各段階でテストを通す

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

Phase 3: 適用結果の検証と記録

目的: 振る舞い維持とパターン適合を確認し、意思決定を残す

アクション:

  1. assets/pattern-application-checklist.md で検証する
  2. references/validation-criteria.md で品質条件を確認する
  3. assets/pattern-decision-record.md に判断理由を記録する
  4. 必要なドキュメント/テスト更新を行う

Task: agents/validate-pattern.md を参照


Task仕様ナビ

Task 起動タイミング 入力 出力
identify-pattern Phase 1 開始時 対象コード/テスト/現状課題 パターン機会レポート
apply-pattern Phase 2 開始時 機会レポート/制約/テスト状況 パターン導入計画/段階的適用結果
validate-pattern Phase 3 開始時 適用結果/テスト結果/設計判断メモ 検証レポート/意思決定記録

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


ベストプラクティス

すべきこと

推奨事項 理由
変化点を先に特定する パターン選定の前提が明確になる
段階的に導入する テスト保護下での安全性が高まる
置き換え単位を小さく保つ 差分が理解しやすくレビューしやすい
パターン適用の目的を記録する 過剰適用や意図の喪失を防ぐ
既存の振る舞い維持を最優先する レガシーの安全性を確保できる

避けるべきこと

禁止事項 問題点
パターン名ありきで導入する 不要な抽象化と複雑化を招く
一度に大きく置き換える 影響範囲が拡大し回帰リスクが高い
テストなしで進める 振る舞い維持の検証ができない
既存設計の意図を無視する 本質的な問題の解決にならない
パフォーマンス検証を省略する 遅延や負荷増大に気づけない

リソース参照

scripts/(決定論的処理)

スクリプト 機能
scripts/validate-pattern-plan.mjs 導入計画テンプレの必須項目を検証
scripts/log_usage.mjs 使用記録と評価メトリクス更新

運用ファイル

ファイル 目的
EVALS.json レベル評価・メトリクス管理
LOGS.md 実行ログの蓄積

references/(詳細知識)

リソース パス 読込条件
パターン機会の判断基準 references/pattern-opportunities.md Phase 1 で判断する時
パターン選定マトリクス references/pattern-selection-matrix.md 候補パターンを絞る時
段階的導入ステップ references/incremental-application-steps.md 計画を立てる時
パターン適用のアンチパターン references/pattern-anti-patterns.md 過剰適用の兆候を確認する時
検証基準 references/validation-criteria.md Phase 3 で検証する時

assets/(テンプレート・素材)

アセット 用途
assets/pattern-refactor-plan-template.md 導入計画テンプレート
assets/pattern-application-checklist.md 適用後の検証チェックリスト
assets/pattern-decision-record.md 意思決定記録テンプレート

変更履歴

Version Date Changes
2.1.0 2026-01-06 log_usage.mjs追加、EVALS.json追加、skill-creator準拠
2.0.0 2026-01-02 skill-creator手順に沿って全面改訂。ワークフロー/Task/テンプレを再設計。
1.0.0 2025-12-31 18-skills.md仕様に基づいて新規作成。