refactor-project について
`refactor:code-simplifier`エージェントを使い、複数ファイルにわたるコードを分析・更新するプロジェクト全体向けのリファクタリングスキルです。動作と公開インターフェースを維持しながら、重複削減とパターン統一を目指す開発者向けです。
主な機能
- 01Gitワークスペースとリビジョンの確認
- 02プロジェクト内コードファイルの検出
- 03ファイル間の重複削減
- 04レガシーコード削除モード
- 05変更概要とロールバック案内
活用シーン
- 01複数ファイルにまたがるコードのリファクタリング
- 02重複削減とパターンの統一
- 03記録した基準リビジョンを使った変更確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ fradser/ dotclaude --skill refactor-projectインストール後、Claude Code で/refactor-projectを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/agent-configuration.mdoutput-requirements.mdscope-analysis.md詳細
プロジェクトのリファクタリングコマンド
refactor:code-simplifier エージェントを使用して、ファイル間の最適化を重視したプロジェクト全体のリファクタリングを自動実行します。
実行前の確認
目的:プロジェクト全体を対象とする実行であることを明示し、再現可能にします。
操作:
git rev-parse --is-inside-work-treeを実行します。結果が false の場合、プロジェクト全体モードには Git ワークスペースが必要であることをユーザーに伝えます- 現在のリビジョンを
git rev-parse --short HEADで記録し、ロールバックの参考情報として最終サマリーに含めます - コマンド引数は無視し、プロジェクト全体の検出を実行します
フェーズ 1:プロジェクトの範囲を分析
目的:すべてのコードファイルを検出し、対象範囲の概要を表示します。
操作:
- 一般的な拡張子に対する Glob パターンを使って、すべてのコードファイルを検索します
node_modules/、.git/、dist/、build/、vendor/、.venv/を除外します- ファイルを言語/拡張子ごとに分類し、主なソースディレクトリを特定します
- 対象範囲の概要(ファイル数、言語、ディレクトリ)を表示してから、自動的に続行します
除外パターンと例外については、references/scope-analysis.md を参照してください。
フェーズ 2:リファクタリングエージェントを起動
目的:プロジェクト全体を対象とし、ファイル間の最適化を重視して refactor:code-simplifier エージェントを実行します。
操作:
- 検出したすべてのコードファイルを指定して、
refactor:code-simplifierエージェントを起動します - ファイル間の最適化を重視するよう指定します:重複の削減、一貫したパターン
- レガシーコードを削除するため、アグレッシブモードフラグを指定します
- エージェントは
refactor:best-practicesスキルを自動的に読み込み、言語固有のパターンを適用します
Task パラメーターの詳細については、references/agent-configuration.md を参照してください。
フェーズ 3:サマリー
目的:プロジェクト全体に加えた変更の包括的なサマリーを報告します。
操作:
- リファクタリングしたファイルの合計数(件数とプロジェクト全体に対する割合)を報告します
- 改善の種類ごとに分類した変更と、実施したファイル間の改善を一覧表示します
- 適用したベストプラクティスと削除したレガシーコードを一覧表示します
- 実行するテストスイートを提案し、変更を論理的なグループごとに確認するよう推奨します
- 記録したベースラインに紐付く、より安全なロールバックコマンドを提示します(例:
git restore --worktree --staged .)
サマリーの形式の詳細については、references/output-requirements.md を参照してください。
要件
- 対象範囲を表示した後、確認を求めずに直ちに実行します
- 検出したすべてのコードファイルを対象に、プロジェクト全体をリファクタリングします
- ファイル間の重複削減と一貫したパターンを優先します
- ユーザーが明示的に動作変更を要求しない限り、動作とパブリックインターフェースを維持します
コメント
Markdown 対応