technical-deslop について
technical-deslopは、ステージ済みまたはブランチの差分を、動作を変えずに整理するリポジトリ向けスキルです。レビュー前に冗長なコードを取り除き、変更箇所をローカルの規約に合わせたい開発者向けです。
主な機能
- 01変更した箇所に絞って整理
- 02冗長なコメントや防御分岐を削除
- 03キャストとコードスタイルを確認
- 04明示的な依頼がなければ動作を維持
- 05整理内容を簡潔に報告
活用シーン
- 01レビューやプルリクエスト前の差分整理
- 02自動生成後のコードスタイル調整
- 03説明過多または不統一な変更の整理
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ vincentkoc/ dotskills --skill technical-deslopインストール後、Claude Code で/technical-deslopを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
agents/openai.yamlreferences/playbook.mdslop-patterns.md詳細
技術的な雑味の除去
目的
動作を変更せずに、AI らしい雑味を取り除き、リポジトリに一貫したスタイルへ戻すことで、ブランチやステージ済みの差分を整えます。
使用するタイミング
- 差分が説明過剰、過度に防御的、または周囲のコードと一貫していないと感じる場合。
- レビューや PR の前に、最後のクリーンアップを行いたい場合。
- 自動生成後にスタイルを統一したい場合。
ワークフロー
git diff --cachedとgit diff $(git merge-base origin/main HEAD)..HEADで対象範囲を確認します。- 変更されたハンク(またはユーザーが指定したファイル)のみに集中します。
references/playbook.mdのクリーンアップ手順を適用します。- 雑味のあるパターンを取り除きます。冗長なコメント、不要な防御的分岐、慣用的でないキャスト、スタイルのずれなどが対象です。
- 動作上の境界を再確認します。ユーザーが明示的に依頼した場合を除き、ロジックは変更しません。
- 実施したクリーンアップを1~3文で簡潔に報告します。
検出ルールについては references/slop-patterns.md を、実行順序については references/playbook.md を参照してください。
入力
- 任意のファイル範囲(
FILES)またはユーザーが明示的に指定したファイル。 - 現在のブランチの差分とステージ済みの差分。
- ローカルの指示や設定に基づくリポジトリの規約。
出力
- 変更対象ファイルの、動作を維持したクリーンアップ。
- どこで何を統一したかを示す簡潔な要約。
コメント
Markdown 対応