polish-before-commit

My Code Polish

提案だけでなく、自動修正まで行う。

Arguments

• $ARGUMENTS: リファクタ対象のファイルパス（省略可）
  • 指定あり: 指定されたファイルのみをリファクタ
  • 指定なし: git diff --name-only origin/develop...HEAD で取得。0件なら終了

Workflow

1. プロジェクト規約の収集

以下のコマンドでプロジェクト内の規約ファイルを列挙し、Read で全件読み込む:

find . -maxdepth 4 -name "CLAUDE.md" -type f 2>/dev/null
find . -maxdepth 5 -path "*/.claude/rules/*.md" -type f 2>/dev/null

ユーザーのグローバル規約 (~/.claude/CLAUDE.md) も読み込む。

抽出対象:

• コーディング規約、命名規則、禁止事項、推奨パターン、コメント記載原則

規約ファイルが 0 件、または対象テーマ（命名・エラーハンドリング・コメント等）の記載が無い場合は、該当ステップでのフォールバック挙動を各ステップの指示に従う（下記ステップ 7 参照）。

2. 変更ファイルの特定と分類

引数指定時は $ARGUMENTS を使用。なければ git diff で取得。

3. 処理方式の選択

条件	処理方式
ファイル ≤ 5	直接処理（main thread で 1M context を活用）
ファイル > 5 かつ 複数言語が混在	サブエージェント並列（subagent_type: "general-purpose"）

サブエージェントには収集した規約・対象ファイル・references/pattern-consistency.md を渡す。

4. パターン一貫性チェック

references/pattern-consistency.md の手法に従い実行:

1. 対象ファイルの既存パターンを分析
2. 同一ファイル内のパターン混在を検出
3. 類似ファイル間の不整合を検出（同じコンテキストのファイルと比較）
4. プロジェクト規約との整合性を確認
5. パターンを統一（既存パターンに合わせる）
6. 同種違反の網羅確認 (必須、本サブステップは「4.6」と呼称し外部 Workflow ステップ 6 (Dead mock) と区別): ある1ファイルでパターン違反を修正したら、変更ファイル群の他箇所に同じ違反が残っていないか grep 等で網羅確認し、見つけた違反は同時に修正する。1ファイルだけ修正して残りを放置すると、CI またはレビューで残りが指摘され追加修正コミットが必要になる
   • 汎用ルール: ある partial / module / class でパターンを変更したら、同ディレクトリ / 同名前空間 / 同責務の他ファイルも同様に変更する
   • 例 (Rails Slim partial の場合): ある partial の @instance_var を local 変数化したら、grep -l '@<varname>' $(git diff --name-only origin/develop...HEAD | grep '_.*\.html\.slim') で他 partial の同種違反を列挙して同時修正
   • 検査コマンドの汎用形 (grep -l '<違反パターン>' $(git diff --name-only origin/${BASE_BRANCH:-develop}...HEAD) のように、ステップ 2 で確定した変更ファイル群を入力にして残箇所を列挙する)
   • 同種違反を修正したら、次のステップ 5 (lint) はステップ 2 で確定した変更ファイル群全体をカバーするため、本サブステップ 4.6 で広げた範囲も自動的に再検証される
   • 補足: Ruby/RSpec の場合は本サブステップ 4.6 の後に外部 Workflow ステップ 6 (Dead mock 削除) でも網羅確認を行う (発想は同型 = 「1 箇所修正したら関連箇所も同時に直す」)

5. 自動修正と検証ループ

修正後は必ず lint を実行し、成功するまで繰り返す（最大3回）。

言語	検証コマンド
Ruby	bundle exec rubocop ${files} --autocorrect-all
TypeScript/JavaScript	yarn eslint ${files} --fix
Python	プロジェクトに応じて ruff check --fix ${files} または black ${files}
その他（Go / Rust / Shell 等）	プロジェクト内の Makefile / package.json / pyproject.toml 等から lint タスクを探索。見つからなければ lint スキップし [lint: 未定義言語のためスキップ（手動確認要）] と最終レポートに明記

3回試行しても解決しない場合は手動対応として報告。

6. Dead mock 削除 (Ruby/RSpec)

目的: 実装側で delegate :X / def X を撤去した PR で、spec の対応 mock (receive(:X) / receive_messages(X:)) が残置していないか検証し、残っていれば削除する。

なぜ必要か: 呼ばれなくなった mock は CI ではエラーにならない（RSpec は未使用 stub を error にしない）。lint でも検出されない。レビュー時に発見され差し戻しになる。

スキップ条件: 変更ファイルに *.rb が無い、または spec/ ディレクトリが存在しない。スキップ時は [dead mock: スキップ (Ruby/RSpec 対象外)] を最終レポートに明記。

検出手順:

1. 削除された identifier を抽出 (impl 側のみ、spec/ 自身は除外):

   git diff origin/${BASE_BRANCH:-develop}...HEAD -- '*.rb' ':!spec/**' \
     | grep -E "^-\s*(delegate\s+:|def\s+)" \
     | grep -vE "^---"
   

   • - delegate :foo, :bar, to: ... → identifiers: foo, bar
   • - def foo / - def self.foo → identifier: foo
   • 同一 PR 内で同名メソッドが追加し直されている (+ def foo) なら除外する

2. spec/ で残存 mock を検出 (identifier ごとに):

   rg --no-heading -n -e "receive\(:${ID}\)" -e "receive_messages\([^)]*\b${ID}:" spec/
   

3. 削除前にユーザーへ提示 (1 ヒットでも以下を必須):

   • ヒットしたファイル/行
   • 削除後の差分プレビュー
   • 削除単位の分類 (auto / Manual Review):
     • receive(:X) の単独 stub で X が削除済 → 行ごと自動削除 (auto)
     • receive_messages(a:, b:) で a, b すべてが削除済 identifier → 行ごと自動削除 (auto, full removal)
     • receive_messages(a:, b:) で 一部 (例: a だけ) が削除済、他は実装に残存 → Manual Review Items に回す (auto しない)

4. 承認後、該当 mock を削除 → 編集した spec ファイル全件を bundle exec rspec <file1> <file2> ... (複数指定可) で実行し 0 failures を確認。失敗した場合は変更を revert し報告。

注意:

• caller 側で obj.X 呼出を撤去しただけ (実装は残存) の場合は対象外。delegate / def の 定義削除 に限る。
• allow_any_instance_of(...).to receive(:X) 形式や instance_double(..., X: ...) 形式も同様に検出対象に含める (rg パターンを追加):

  rg -e "receive\(:${ID}\)" -e "receive_messages\([^)]*\b${ID}:" \
     -e "instance_double\([^)]*\b${ID}:" -e "double\([^)]*\b${ID}:" spec/
  

7. コメント改善

ステップ 1 で収集した規約テキストに「コメント」「comment」キーワードを含む節がある場合のみ、その原則に従ってコメントを改善する。

規約にコメント原則の記載がない場合はこのステップをスキップする（独自判断でコメントを追加・削除しない）。スキップした旨は最終レポートに [コメント改善: スキップ（規約に原則なし）] と明記する。

8. 最終レビュー

全ての改善が完了したら、feature-dev:code-reviewer で見落としをキャッチ:

Task(subagent_type="feature-dev:code-reviewer", prompt="変更ファイルの git diff をレビューし、バグ・規約違反を報告せよ")

Manual Review Items

以下は自動修正せず、提案として報告:

1. 設計判断が必要: サービス切り出し、モジュール化、責務分離
2. 影響範囲調査が必要: メソッド名/引数/戻り値の変更
3. ビジネスロジックのチェックが必要: バリデーション追加、認可変更
4. Dead mock の部分削除: receive_messages(a:, b:) のうち一部の identifier だけ削除する場合（残す側との整合確認が必要）。書換え候補 (例: receive_messages(b:) 化 / 行ごと削除 / テスト見直し) を併記してユーザーに選択させてよい。最終編集は必ずユーザー承認後。

Quality Standards

• Accuracy: 明確に問題であるものだけを修正
• Safety: 既存の機能を壊さない
• Completeness: 変更されたファイルをすべてチェック
• Respect: プロジェクトの規約に従う

併用推奨 skill

• /review-code-quality — 設計レベルの品質課題をコミット前に検出する
• /create-pr — 仕上げが完了したらカレントブランチから PR を作成する