deslop について
現在の Git ブランチの変更を調べ、機能を保ちながら AI 生成コードの不要な記述を取り除くエージェントスキルです。不要なコメント、過剰な防御的実装、型の回避策、スタイルの不一致を確認します。
主な機能
- 01ブランチ差分の確認
- 02冗長なコメントの検出
- 03過剰な防御的実装の発見
- 04型の回避策の特定
- 05スタイル不一致の確認
活用シーン
- 01レビュー前の生成コードの整理
- 02不要なチェックやコメントの削除
- 03変更ファイルの既存スタイルへの適合
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ rawkode-academy/ rawkode-academy --skill deslopインストール後、Claude Code で/deslopを入力して読み込まれたか確認します。
詳細
このスキルは、現在のブランチの変更から AI が生成したコードのスロップを特定して削除します。
プロセス
1. diff を取得する
git diff main...HEAD を実行して、このブランチで導入されたすべての変更を確認します。
2. 変更された各ファイルを分析する
変更のある各ファイルについて、次のような AI スロップのパターンを探します。
不要なコメント
- 人間なら書かないような、明らかなコードを説明するコメント
- ファイルの他のコメントスタイルと一貫性のないコメント
- 他の場所では付いていないような、単純な内部関数に追加された JSDoc や docstring
- 実行可能な内容ではない「// TODO」や「// NOTE」コメント
防御的な過剰設計
- 上流で既に検証済みの内部コードパスにある try/catch ブロック
- 型システムや呼び出しコンテキストによって存在が保証されている値に対する null/undefined チェック
- 決して到達し得ないフォールバック値
- 既に型付けされたパラメータに対する型ガード
型の回避策
- 型エラーを回避するための
anyへのキャスト @ts-ignoreや@ts-expect-errorコメント- コンパイラを満足させるための過度に広いユニオン型
スタイルの不整合
- ファイルの他の部分と異なる命名規則
- 異なるフォーマットパターン(たとえ有効であっても)
- ファイルのスタイルに合わない過剰な空行やグルーピング
- 本番コードに残された Console.log ステートメント
3. クリーンアップ
特定した各問題について、次のことを行います。
- 周囲のコンテキストを読んで、ファイルの既存のスタイルを理解する
- 実際の機能を維持しつつ、スロップを削除または簡素化する
- コードが引き続き正しく動作することを確認する
4. 報告
すべての変更後、何を変更したかを 1~3 文の要約 で提供します。すべての変更を列挙するのではなく、削除したスロップの種類とおおよその量をまとめるだけにしてください。
出力例:
API ハンドラー内で、明らかなコードを説明する不要なコメントを 12 個、冗長な try/catch ブロックを 3 個削除しました。また、実際の型の問題を隠していた 2 つの
anyキャストも整理しました。
コメント
Markdown 対応