mcpField
R
refactor-safely

refactor-safely

github.com/tirth8205開発32.5k1.1k 回インストール2 週間前に更新
リポジトリ

refactor-safely について

依存グラフのツールでコードのリファクタリングを支援するスキルです。候補の提案、未参照コードの検出、確認済みの名前変更に対応し、大規模な変更の前後で影響を評価できます。

主な機能

  1. 01リファクタリング候補の提案
  2. 02未参照コードの検出
  3. 03名前変更のプレビューと適用
  4. 04影響範囲とフローの確認
  5. 05変更後の影響検証

活用シーン

  1. 01リファクタリング対象のコードを探す
  2. 02シンボル名の変更をプレビューして適用
  3. 03大規模なリファクタリング前に依存関係を確認

MCP 対応

code-review-graph MCP ツールを使い、リファクタリング候補の分析、名前変更のプレビューと適用、依存関係や影響を受けるフローの確認を行います。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/tirth8205/code-review-graph --skill refactor-safely

インストール後、Claude Code で/refactor-safelyを入力して読み込まれたか確認します。

詳細

安全にリファクタリングする

依存関係グラフをもとにリファクタリングを計画し、プレビューから名前変更を適用します。

手順
  1. リファクタリング候補を探す場合は mode="suggest" を、参照されていないコードを探す場合は mode="dead_code" を指定して refactor_tool を呼び出します。
  2. 名前を変更する場合は、mode="rename"、old_name、new_name を指定して refactor_tool を呼び出します。適用する前に、返された編集リストを確認してください。
  3. 返された refactor_id を指定して apply_refactor_tool を呼び出し、名前変更を適用します。
  4. 大規模なリファクタリングを行う前に、get_impact_radius_tool と get_affected_flows_tool を呼び出して、関係する依存先と重要なパスを確認します。
  5. find_large_functions_tool を呼び出して、分割する価値のある関数を見つけます。
  6. 変更後に detect_changes_tool を呼び出して、影響が計画と一致しているかを確認します。

トークン効率のルール

  • 他のグラフツールを使う前に、get_minimal_context_tool(task="<your task>") を呼び出してください。
  • detail_level を受け付けるツールでは、常に detail_level="minimal" を指定します。minimal では不十分な場合にのみ "standard" を使用してください。
  • 広範囲な一覧取得の呼び出しよりも、対象を絞った query_graph_tool の呼び出しを優先します。
  • 予算は、1 タスクあたり約 5 回のツール呼び出しと、グラフ出力 800 トークン程度です。
  • コードを変更する前に、実装とそのテストを読んでください。グラフは作業範囲を絞り込むためのものであり、ソースコードの代わりにはなりません。

コメント