mcpField
T
technical-deslop

technical-deslop

github.com/vincentkoc開発11190 回インストール2 日前に更新
リポジトリ

technical-deslop について

technical-deslopは、ステージ済みまたはブランチの差分を、動作を変えずに整理するリポジトリ向けスキルです。レビュー前に冗長なコードを取り除き、変更箇所をローカルの規約に合わせたい開発者向けです。

主な機能

  1. 01変更した箇所に絞って整理
  2. 02冗長なコメントや防御分岐を削除
  3. 03キャストとコードスタイルを確認
  4. 04明示的な依頼がなければ動作を維持
  5. 05整理内容を簡潔に報告

活用シーン

  1. 01レビューやプルリクエスト前の差分整理
  2. 02自動生成後のコードスタイル調整
  3. 03説明過多または不統一な変更の整理

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/vincentkoc/dotskills --skill technical-deslop

インストール後、Claude Code で/technical-deslopを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

agents/
openai.yaml
references/
playbook.md
slop-patterns.md

詳細

技術的な雑味の除去

目的

動作を変更せずに、AI らしい雑味を取り除き、リポジトリに一貫したスタイルへ戻すことで、ブランチやステージ済みの差分を整えます。

使用するタイミング

  • 差分が説明過剰、過度に防御的、または周囲のコードと一貫していないと感じる場合。
  • レビューや PR の前に、最後のクリーンアップを行いたい場合。
  • 自動生成後にスタイルを統一したい場合。

ワークフロー

  1. git diff --cached と git diff $(git merge-base origin/main HEAD)..HEAD で対象範囲を確認します。
  2. 変更されたハンク(またはユーザーが指定したファイル)のみに集中します。
  3. references/playbook.md のクリーンアップ手順を適用します。
  4. 雑味のあるパターンを取り除きます。冗長なコメント、不要な防御的分岐、慣用的でないキャスト、スタイルのずれなどが対象です。
  5. 動作上の境界を再確認します。ユーザーが明示的に依頼した場合を除き、ロジックは変更しません。
  6. 実施したクリーンアップを1~3文で簡潔に報告します。

検出ルールについては references/slop-patterns.md を、実行順序については references/playbook.md を参照してください。

入力

  • 任意のファイル範囲(FILES)またはユーザーが明示的に指定したファイル。
  • 現在のブランチの差分とステージ済みの差分。
  • ローカルの指示や設定に基づくリポジトリの規約。

出力

  • 変更対象ファイルの、動作を維持したクリーンアップ。
  • どこで何を統一したかを示す簡潔な要約。

コメント