refactor-safe について
refactor-safe は、保守性向上を目的とするリファクタリング案を見つけ、優先順位を付けるスキルです。生成コードやベンダーライブラリを除外し、位置、理由、安全性、作業量を示して、提案を最大10件に絞ります。
主な機能
- 01プロジェクトとして有効か確認
- 02一般的なリファクタリング候補の検出
- 03安全性別に提案を分類
- 04コード位置と理由を提示
- 05作業量の見積もりとテスト要否の表示
活用シーン
- 01安全な整理候補のコードベース調査
- 02リスクに応じたリファクタリングの優先順位付け
- 03未使用コードや重複パターンの発見
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/refactor-safeを入力して読み込まれたか確認します。
詳細
次の手順を実行します。
-
現在のディレクトリが有効なプロジェクトかどうかを確認します（package.json、requirements.txt など）。
-
コードのパターンを分析し、安全にリファクタリングできる箇所を特定します。
- 関数に抽出できる重複コードブロック
- 分割できる長い関数
- 定数にすべきマジックナンバー／文字列
- 未使用のインポートや変数
- 簡単な型の改善（TypeScript／Python）
- 安全に削除できるデッドコード
-
安全性のレベルごとに提案の優先順位を付けます。
- 安全：動作を変更しません（定数の抽出、未使用コードの削除）
- 低リスク：機械的なリファクタリングです（関数の抽出、変数名の変更）
- 中リスク：テストが必要な構造上の変更です
-
提案ごとに、次の情報を提示します。
- 場所（ファイル名:行番号）
- リファクタリングの内容
- 安全である理由
- 推定作業量（小／中／大）
安全性の基準：
- ビジネスロジックの変更ではなく、コードのパターンに対するリファクタリングのみを提案します
- 主観的な改善より、機械的な変換を優先します
- 安全性の確認にテストが必要な提案には、その旨を明記します
- 生成コードやベンダーライブラリと思われるファイルは除外します
- 明確なメリットがある保守性の改善に焦点を当てます
出力形式：
- 安全性のレベルごとに提案を分類します
- ファイルの場所と行番号を示します
- 各提案の簡潔な根拠を提示します
- おおよその作業量を含めます
- 影響の大きい提案を最大10件に絞ります
コメント
Markdown 対応