結論
最初にやること：OSのターミナルでclaude -p "現在の git diff をレビューし、バグ、セキュリティ、テスト不足を重大度順にJSONで出力して"を実行します。
おすすめは、調査、実装、検証を一度に丸投げするのではなく、成果物と停止条件を明記した小さなワークフローです。
Claude Codeはファイル検索、編集、コマンド実行を繰り返すため、失敗時の扱いまで指定すると安全に自律実行できます。
大規模変更ではPlan mode、限定的なレビューではprint modeを使い分けます。
実行場所：OSのターミナルで実行します。
# 変更せずにレビューだけ実行
# ターミナルで実行：非対話モードで単発処理を実行
claude -p "現在の git diff をレビューし、バグ、セキュリティ、テスト不足を重大度順にJSONで出力して"
# 対話モードで計画から開始
# ターミナルで実行：Claude Codeを指定条件で起動
claude --permission-mode plan具体的な手順
レビューは差分と評価基準を指定する
実装は対象範囲と非目標を明記する
検証は実際のコマンド名と成功条件を書く
失敗時は無限再試行せず停止して報告させる
プロジェクト全体のテスト生成は対象が広すぎるため、最初に未テスト領域を列挙させ、優先順位の高い単位から進めます。
同種の依頼を繰り返すなら、.claude/skills/にSKILL.mdとして保存し、/skill-nameで呼び出す方がシェルaliasより共有しやすくなります。
実践プロンプト
リファクタリングと検証を安全に進める例です。
入力場所：Claude Codeの対話画面へ貼り付けます。
src/services/payment/ だけを対象にしてください。
目的は重複している入力検証を共通関数へ集約することです。
公開API、例外メッセージ、DBスキーマは変更しないでください。
最初に重複箇所と変更計画を示してください。
承認後、1ファイルずつ編集し、各変更後に npm test -- payment を実行してください。
同じ失敗が2回続いたら作業を停止し、原因と未完了項目を報告してください。注意点
「すべて自動修正して」は、意図しない大量編集や依存更新を含む可能性があります。
テストが存在しない領域では、先に現状を固定するcharacterization testを作らせてからリファクタリングしてください。
Gitの作業ツリーに未保存の変更がある場合は、開始前にgit status --shortを確認し、必要なら別ブランチやworktreeを使います。