refactor-safely について
依存グラフのツールでコードのリファクタリングを支援するスキルです。候補の提案、未参照コードの検出、確認済みの名前変更に対応し、大規模な変更の前後で影響を評価できます。
主な機能
- 01リファクタリング候補の提案
- 02未参照コードの検出
- 03名前変更のプレビューと適用
- 04影響範囲とフローの確認
- 05変更後の影響検証
活用シーン
- 01リファクタリング対象のコードを探す
- 02シンボル名の変更をプレビューして適用
- 03大規模なリファクタリング前に依存関係を確認
MCP 対応
code-review-graph MCP ツールを使い、リファクタリング候補の分析、名前変更のプレビューと適用、依存関係や影響を受けるフローの確認を行います。
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ tirth8205/ code-review-graph --skill refactor-safelyインストール後、Claude Code で/refactor-safelyを入力して読み込まれたか確認します。
詳細
安全にリファクタリングする
依存関係グラフをもとにリファクタリングを計画し、プレビューから名前変更を適用します。
手順
- リファクタリング候補を探す場合は
mode="suggest"を、参照されていないコードを探す場合はmode="dead_code"を指定してrefactor_toolを呼び出します。 - 名前を変更する場合は、
mode="rename"、old_name、new_nameを指定してrefactor_toolを呼び出します。適用する前に、返された編集リストを確認してください。 - 返された
refactor_idを指定してapply_refactor_toolを呼び出し、名前変更を適用します。 - 大規模なリファクタリングを行う前に、
get_impact_radius_toolとget_affected_flows_toolを呼び出して、関係する依存先と重要なパスを確認します。 find_large_functions_toolを呼び出して、分割する価値のある関数を見つけます。- 変更後に
detect_changes_toolを呼び出して、影響が計画と一致しているかを確認します。
トークン効率のルール
- 他のグラフツールを使う前に、
get_minimal_context_tool(task="<your task>")を呼び出してください。 detail_levelを受け付けるツールでは、常にdetail_level="minimal"を指定します。minimal では不十分な場合にのみ "standard" を使用してください。- 広範囲な一覧取得の呼び出しよりも、対象を絞った
query_graph_toolの呼び出しを優先します。 - 予算は、1 タスクあたり約 5 回のツール呼び出しと、グラフ出力 800 トークン程度です。
- コードを変更する前に、実装とそのテストを読んでください。グラフは作業範囲を絞り込むためのものであり、ソースコードの代わりにはなりません。
コメント
Markdown 対応