File contents Refactor Cleaner
要約 : デッドコードを検出し、安全に削除。すべての削除操作をログに記録。
📌 コマンド
コマンド
説明
/refactor analyzeデッドコード検出
/refactor clean [--safe-only]安全な削除
/refactor reportレポート表示
🔍 検出ツール (REQ-RC-001)
ツール
検出内容
コマンド
knip 未使用ファイル/エクスポート/依存
npx knip
depcheck 未使用npm依存
npx depcheck
ts-prune 未使用TSエクスポート
npx ts-prune
⚠️ 安全な削除 (REQ-RC-002)
BEFORE 削除実行DO 以下を検証
チェック
コマンド
動的インポート
grep -rn "import(" src/
テスト参照
grep -rn "<name>" tests/
ドキュメント参照
grep -rn "<name>" docs/
検出された場合 : 削除対象から除外
📊 リスク分類 (REQ-RC-004)
レベル
説明
アクション
🟢 SAFE
静的解析で参照なし
自動削除可
🟡 CAUTION
動的参照の可能性
確認必要
🔴 DANGER
公開API/エントリーポイント
自動削除禁止
出力例 :
🔍 Dead Code Analysis
━━━━━━━━━━━━━━━━━━━━━━━━
🟢 SAFE (5):
• src/utils/deprecated.ts
• src/helpers/old.ts
🟡 CAUTION (2):
• src/lib/maybe-used.ts
🔴 DANGER (1):
• src/index.ts (entry point)
━━━━━━━━━━━━━━━━━━━━━━━━
📝 Deletion Log (REQ-RC-003)
WHEN コード削除DO docs/DELETION_LOG.mdに記録
## [日付]
### Deleted
- `src/utils/deprecated.ts`
- `src/helpers/old.ts`
### Reason
knip検出: 未使用エクスポート
### Restore
`git checkout abc1234 -- <file>`
レポート保存 : .reports/dead-code-analysis.md
トレーサビリティ
REQ-RC-001: Dead Code Detection
REQ-RC-002: Safe Deletion
REQ-RC-003: Deletion Log
REQ-RC-004: Risk Classification
1 --- 2 name: refactor-cleaner 3 description: Refactor Cleaner 4 license: MIT 5 --- 6 7 # Refactor Cleaner 8 9 > **要約**: デッドコードを検出し、安全に削除。すべての削除操作をログに記録。 10 11 ## 📌 コマンド 12 13 | コマンド | 説明 | 14 |---------|------| 15 | `/refactor analyze` | デッドコード検出 | 16 | `/refactor clean [--safe-only]` | 安全な削除 | 17 | `/refactor report` | レポート表示 | 18 19 --- 20 21 ## 🔍 検出ツール (REQ-RC-001) 22 23 | ツール | 検出内容 | コマンド | 24 |--------|---------|---------| 25 | **knip** | 未使用ファイル/エクスポート/依存 | `npx knip` | 26 | **depcheck** | 未使用npm依存 | `npx depcheck` | 27 | **ts-prune** | 未使用TSエクスポート | `npx ts-prune` | 28 29 --- 30 31 ## ⚠️ 安全な削除 (REQ-RC-002) 32 33 **BEFORE** 削除実行 34 **DO** 以下を検証 35 36 | チェック | コマンド | 37 |---------|---------| 38 | 動的インポート | `grep -rn "import(" src/` | 39 | テスト参照 | `grep -rn "<name>" tests/` | 40 | ドキュメント参照 | `grep -rn "<name>" docs/` | 41 42 **検出された場合**: 削除対象から除外 43 44 --- 45 46 ## 📊 リスク分類 (REQ-RC-004) 47 48 | レベル | 説明 | アクション | 49 |--------|------|----------| 50 | 🟢 **SAFE** | 静的解析で参照なし | 自動削除可 | 51 | 🟡 **CAUTION** | 動的参照の可能性 | 確認必要 | 52 | 🔴 **DANGER** | 公開API/エントリーポイント | 自動削除禁止 | 53 54 **出力例**: 55 ``` 56 🔍 Dead Code Analysis 57 ━━━━━━━━━━━━━━━━━━━━━━━━ 58 🟢 SAFE (5): 59 • src/utils/deprecated.ts 60 • src/helpers/old.ts 61 62 🟡 CAUTION (2): 63 • src/lib/maybe-used.ts 64 65 🔴 DANGER (1): 66 • src/index.ts (entry point) 67 ━━━━━━━━━━━━━━━━━━━━━━━━ 68 ``` 69 70 --- 71 72 ## 📝 Deletion Log (REQ-RC-003) 73 74 **WHEN** コード削除 75 **DO** `docs/DELETION_LOG.md`に記録 76 77 ```markdown 78 ## [日付] 79 80 ### Deleted 81 - `src/utils/deprecated.ts` 82 - `src/helpers/old.ts` 83 84 ### Reason 85 knip検出: 未使用エクスポート 86 87 ### Restore 88 `git checkout abc1234 -- <file>` 89 ``` 90 91 **レポート保存**: `.reports/dead-code-analysis.md` 92 93 --- 94 95 ## トレーサビリティ 96 97 - REQ-RC-001: Dead Code Detection 98 - REQ-RC-002: Safe Deletion 99 - REQ-RC-003: Deletion Log 100 - REQ-RC-004: Risk Classification
commit 27d67525a4
Frequently asked questions How do I install the Refactor Cleaner skill? Run npx skillmds@latest add nahisaho/refactor-cleaner in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
What does the Refactor Cleaner skill do? Refactor Cleaner It is listed under Coding & Dev Tools on SkillMD.
Is Refactor Cleaner safe to use? This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
Which AI agents work with Refactor Cleaner? This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Is Refactor Cleaner free to use? Yes. Installing skills from SkillMD is free. This skill is licensed under MIT.
Who published Refactor Cleaner? nahisaho (@nahisaho) published this skill. Their other Agent Skills are listed on their SkillMD profile.
nahisaho