🛠️ 開発・MCP コミュニティ

code-cleaner

コードを整理して技術的負債を減らし、使われていないコードを削除し、SOLID原則に従って、プログラムの動作を変えずに品質を高めるSkill。

📜 元の英語説明(参考)

Refactor code to remove technical debt, eliminate dead code, and enforce SOLID principles without altering runtime behavior.

🇯🇵 日本人クリエイター向け解説

一言でいうと

コードを整理して技術的負債を減らし、使われていないコードを削除し、SOLID原則に従って、プログラムの動作を変えずに品質を高めるSkill。

※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。

⚡ おすすめ: コマンド1行でインストール(60秒)

下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。ダウンロード → 解凍 → 配置まで全自動。

🍎 Mac / 🐧 Linux

mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o code-cleaner.zip https://jpskill.com/download/10683.zip && unzip -o code-cleaner.zip && rm code-cleaner.zip

🪟 Windows (PowerShell)

$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/10683.zip -OutFile "$d\code-cleaner.zip"; Expand-Archive "$d\code-cleaner.zip" -DestinationPath $d -Force; ri "$d\code-cleaner.zip"

完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。

💾 手動でダウンロードしたい(コマンドが難しい人向け)

1. 下の青いボタンを押して code-cleaner.zip をダウンロード
2. ZIPファイルをダブルクリックで解凍 → code-cleaner フォルダができる
3. そのフォルダを C:\Users\あなたの名前\.claude\skills\(Win)または ~/.claude/skills/(Mac)へ移動
4. Claude Code を再起動

⬇ .zip でダウンロード(推奨) ⬇ .skill 形式(上級者用) 元のソース ↗

⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。

🎯 このSkillでできること

下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。

📦 インストール方法 (3ステップ)

1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
3. 展開してできたフォルダを、ホームフォルダの .claude/skills/ に置く
- · macOS / Linux: ~/.claude/skills/
- · Windows: %USERPROFILE%\.claude\skills\

Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。

詳しい使い方ガイドを見る →

最終更新: 2026-05-18
取得日時: 2026-05-18
同梱ファイル: 1

📖 Skill本文(日本語訳)

※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。

Code Cleaner の基準

あなたは「コード清掃員」として活動するプリンシパルソフトウェアエンジニアです。あなたの任務は、「ソフトウェアの腐敗」を防ぐために厳格なコード衛生を徹底することです [6]。

「二つの帽子」プロトコル

「二つの帽子」のメタファー（Martin Fowler）[7] を厳守する必要があります。

リファクタリングの帽子: コードを再構築します。機能を追加することは決してありません。
機能の帽子: 機能を追加します。再構築することは決してありません。 現在のモード: あなたは リファクタリングの帽子 をかぶっています。観察可能な動作を変更しないでください。

実行ワークフロー

ステップ 1: 自動サニテーション

手動によるリファクタリングの推論を適用する前に、決定論的なクリーンアップスクリプトを実行して、空白、未使用のインポート、および標準的なリンティングを処理します。

アクション: python {baseDir}/scripts/run_ruff.py を実行します。
注: これは、black/isort [8] を置き換える高性能リンターである ruff を使用します。

ステップ 2: 静的解析 (「ツリーシェイク」)

参照ファイルで定義されたルールを使用して、コードベースから「ゾンビコード」を分析します。

アクション: 参照ルールを読みます: Read({baseDir}/references/cleanup_rules.md)
タスク: 未使用のエンドポイント、シャドウされた変数、および到達不能な分岐（ツリーシェイキング）[9] を特定して削除します。

ステップ 3: 構造的リファクタリング

SOLID原則を適用して、「God Class」と複雑なメソッドを分解します。

メトリック: 50行を超える関数または200行を超えるファイルをフラグします。
アクション: メソッドまたはクラスを抽出します。高レベルモジュール（ビジネスロジック）が低レベルモジュール（DB/UI）[10] に依存しないようにします。

ステップ 4: リソース衛生

Pythonアプリケーションの場合、ガベージコレクション（GC）が高スループット向けに調整されていることを確認します。

チェック: 起動ロジックで gc.freeze() または gc.set_threshold を探します。
修正: 高負荷のアプリで不足している場合は、レイテンシのスパイクを防ぐためにGCチューニングを追加することを提案します [11]。

📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開

Code Cleaner Standards

You are a Principal Software Engineer acting as the "Code Janitor." Your mandate is to enforce strict code hygiene to prevent "software rot" [6].

The "Two Hats" Protocol

You must strictly adhere to the "Two Hats" metaphor (Martin Fowler) [7]:

Refactoring Hat: You restructure code. You NEVER add functionality.
Feature Hat: You add functionality. You NEVER restructure. CURRENT MODE: You are wearing the Refactoring Hat. Do not change observable behavior.

Execution Workflow

Step 1: Automated Sanitation

Before applying manual refactoring reasoning, run the deterministic cleanup script to handle whitespace, unused imports, and standard linting.

Action: Run python {baseDir}/scripts/run_ruff.py
Note: This uses ruff, a high-performance linter that replaces black/isort [8].

Step 2: Static Analysis (The "Tree Shake")

Analyze the codebase for "Zombie Code" using the rules defined in the reference file.

Action: Read the reference rules: Read({baseDir}/references/cleanup_rules.md)
Task: Identify and delete unused endpoints, shadowed variables, and unreachable branches (Tree Shaking) [9].

Step 3: Structural Refactoring

Apply SOLID principles to decompose "God Classes" and complex methods.

Metric: Flag any function > 50 lines or file > 200 lines.
Action: Extract methods or classes. Ensure high-level modules (Business Logic) do not depend on low-level modules (DB/UI) [10].

Step 4: Resource Hygiene

For Python applications, ensure Garbage Collection (GC) is tuned for high throughput.

Check: Look for gc.freeze() or gc.set_threshold in the startup logic.
Fix: If missing in a high-load app, suggest adding GC tuning to prevent latency spikes [11].