deslop について
deslopは、ブランチの差分を確認して不要な変更や過剰設計を取り除くスキルです。コミット前のコード確認に使い、編集内容を再確認してテストや型チェックを実行します。
主な機能
- 01mainとのブランチ差分を確認
- 02不要なコードやコメントを削除
- 03最小限に絞って編集
- 04差分を再確認してテストを実行
活用シーン
- 01コミット前のブランチ整理
- 02過剰設計に感じるコードの簡素化
- 03整理後も動作が変わらないことの確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ rohitg00/ pro-workflow --skill deslopインストール後、Claude Code で/deslopを入力して読み込まれたか確認します。
詳細
AIコードのスロップを削除
main との差分を確認し、ブランチで導入された AI 生成のスロップを削除します。
トリガー
変更を完了した後、コミットする前、またはコードが過剰に設計されていると感じたときに使用します。
コマンド
git fetch origin main
git diff origin/main...HEAD --stat
git diff origin/main...HEAD
ワークフロー
- diff コマンドを実行して、ブランチ上のすべての変更を確認します。
- 以下のフォーカスエリアからスロップのパターンを特定します。
- スロップを削除するための最小限で焦点を絞った編集を適用します。
git diff origin/main...HEADを再実行して、スロップのみが削除されたことを検証します。- テストまたは型チェックを実行して、動作が変わっていないことを確認します:
npm test -- --changed --passWithNoTests 2>&1 | tail -10 - 何をクリーンアップしたかを要約します。
フォーカスエリア
- 明らかなことを述べている、またはローカルのスタイルと一致しない余分なコメント
- 信頼された内部コードパスでは異常な防御的な try/catch ブロック
- 型の問題を回避するためだけに使用されている
anyへのキャスト - 一度きりの操作に対する過剰に設計された抽象化(早すぎるヘルパー、ファクトリー)
- 早期リターンで簡素化すべき、深くネストされたコード
- 後方互換性のためのハック(名前を変更した
_vars、再エクスポート、// removedコメント) - 要求された範囲を超えた機能、リファクタリング、または「改善」
- 変更されていないコードへの docstring、型アノテーション、コメントの追加
- 信頼された内部パスでは発生し得ないシナリオに対するエラーハンドリング
ガードレール
- 明確なバグを修正する場合を除き、動作を変更しないでください。
- 大規模な書き直しよりも、最小限で焦点を絞った編集を優先してください。
- 3 行の類似したコードは、早すぎる抽象化よりも優れています。
- 何かを削除する場合は、まずそれが本当に未使用であることを確認してください。
- 最終的な要約は簡潔に保ってください(1〜3 文)。
スキルファイルモード
対象が SKILL.md(コードの差分ではない)の場合、散文に適用するのと同じ
スロップの感覚でリントします。スキルを昇格する前にこれを実行します。以下にフラグを立てます。
- 古い行 - スキルの古いバージョン向けに書かれたガイダンスで、現在の動作と 一致しなくなったもの。削除します。
- 肥大化 - リンクされたリファレンスに属する詳細によって、スキルが 1 画面を 超えているもの。下に押し下げます: スキル内のステップ、次にスキル内のリファレンス、次に ポインターの向こう側にある外部ファイル。
- 死んだ文 - 削除しても何も変わらない行。削除します。
- 重複 - 同じ指示が 2 か所に記述されているため、編集がずれるもの。 信頼できる唯一の情報源を 1 つ保ちます。
- 早すぎる停止 - 作業が終わる前にメソッドが終了しているもの(質問はするが 答えを記録しない、クリーンアップはするが検証しない)。
- 弱いアンカー - スキルが依拠する単一の概念がないもの。読者が一言で 名付けられるスキルは、より少ないトークンでトリガーおよび実行されます。
- 呼び出し意図の欠如 - 人間が実行するモードか自動トリガーモードかが宣言されていないもの。
rules/skill-conventions.mdcを参照してください。 - 誤った書き込み操作 - 状態を変更するスキルで、追加、更新、追記のいずれを行うかが 述べられていないもの、または 2 回目の実行で出力が重複するもの。
スキルファイルモードの出力: 行ごとにフラグを立てた問題、適用した編集、 クリーンアップの要約、およびスキルが昇格の準備ができているかどうか。
出力(コードモード)
- 検出されたスロップパターンのリストとファイルの場所
- 適用した編集
- 何をクリーンアップしたかの 1 行の要約
コメント
Markdown 対応