smithery/nagasakah

refactor-clean

デッドコードの安?

Installation

$ npx skills add smithery/nagasakah --skill refactor-clean

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 5,306 B
  • docs SUMMARY.md 436 B

History

  1. First recorded snapshot · 0 installs

SKILL.md

リファクタリング - デッドコード削除(Refactor Clean)

テスト検証を行いながら、デッドコードを安全に特定・削除するためのガイド。

このスキルの目的

  1. デッドコードの分析 - 未使用のコード、エクスポート、依存関係を特定
  2. リスク評価 - 削除対象を重要度で分類
  3. 安全な削除 - テスト検証を行いながら段階的に削除
  4. 変更の追跡 - 削除した項目のサマリーを提示

言語自動検出

プロジェクトの言語は以下のファイルの存在で自動判定する:

言語 判定ファイル
TypeScript tsconfig.json, package.json
Python pyproject.toml, setup.py, requirements.txt
C# .csproj, .sln

言語が指定された場合({{language}})はその言語を優先する。

ワークフロー

ステップ1: デッドコード分析ツールの実行

プロジェクトの言語に応じて適切なツールを選択する。

TypeScript/JavaScript

ツール 検出対象
knip 未使用のエクスポート、ファイル
depcheck 未使用の依存関係
ts-prune 未使用のTypeScriptエクスポート

詳細: reference/typescript/tools.md を参照

Python

ツール 検出対象
vulture 未使用のコード全般
autoflake 未使用のインポート
ruff 未使用コード(F401, F841)

詳細: reference/python/tools.md を参照

C#

ツール 検出対象
Roslyn Analyzers 未使用コード(IDE0051, IDE0052等)
dotnet format コードスタイル違反

詳細: reference/csharp/tools.md を参照

注意: プロジェクトに適したツールを選択する。すべてのツールが必要なわけではない。

ステップ2: 包括的なレポートの生成

分析結果を .reports/dead-code-analysis.md に出力する。

レポートには以下を含める:

  • 検出されたデッドコードの一覧
  • 各項目の分類と重要度
  • 推奨されるアクション

ステップ3: 重要度による分類

検出された項目を以下の3つのカテゴリに分類する:

重要度 対象例 削除の安全性
SAFE(安全) テストファイル、未使用ユーティリティ 安全に削除可能
CAUTION(注意) APIルート、コンポーネント 慎重に確認が必要
DANGER(危険) 設定ファイル、メインエントリポイント 削除非推奨

ステップ4: 安全な削除のみを提案

重要: SAFEカテゴリの項目のみを削除対象として提案する。

CAUTIONカテゴリは追加の確認が必要。 DANGERカテゴリは原則として削除しない。

ステップ5: テスト検証付き削除プロセス

各削除に対して以下のプロセスを厳守する:

1. テストスイートを実行
2. テストがパスすることを確認
3. 対象コードを削除
4. テストスイートを再実行
5. テストが失敗した場合 → ロールバック
6. テストがパスした場合 → 次の削除へ

ステップ6: 削除サマリーの提示

作業完了後、以下の情報を含むサマリーを提示する:

  • 削除したファイル/コードの一覧
  • 削除できなかった項目(理由付き)
  • テスト結果の概要

重要な注意事項

絶対に守ること:

  • テストを実行せずにコードを削除してはならない
  • DANGERカテゴリの項目は明示的な許可なしに削除しない
  • 1つの変更ごとにテストを実行し、失敗時は即座にロールバック

レポートテンプレート

# デッドコード分析レポート

## 分析日時
{日時}

## 使用ツール
- {ツール1}
- {ツール2}

## 検出結果

### SAFE(安全に削除可能)
- [ ] {ファイル/コード1} - {理由}
- [ ] {ファイル/コード2} - {理由}

### CAUTION(要確認)
- [ ] {ファイル/コード1} - {理由}
- [ ] {ファイル/コード2} - {理由}

### DANGER(削除非推奨)
- {ファイル/コード1} - {理由}
- {ファイル/コード2} - {理由}

## 推奨アクション
1. {アクション1}
2. {アクション2}

削除サマリーテンプレート

# デッドコード削除サマリー

## 削除完了
- {ファイル/コード1}
- {ファイル/コード2}

## 削除スキップ(理由付き)
- {ファイル/コード1}: {理由}

## テスト結果
- 実行前: {パス/失敗}
- 削除後: {パス/失敗}

## 備考
{追加コメント}