🏃
カスタムスラッシュコマンドでClaude Code+Gitフローの自走力を爆上げする

2025/07/04に公開
 この記事はClaude Codeを使ったAgentic Codingにおいて、Gitフローの開発ルールをCLAUDE.mdからカスタムスラッシュコマンドに移動したら自走力が大幅に向上した話です。

 やりたいことCloud Code、GitHub、ghコマンドを使ってGitフローの流れで開発します。タスクは事前にIssueとして登録されています。
Issue対応
(H)Issue番号を指定して作業依頼
(AI)Issue開始報告→ブランチ作成→ファイル編集→コミット&プッシュPR作成→Issue完了報告
PRレビュ&指摘対応
(H)レビュ指摘コメントをPRに入力
(H)PR番号を指定して指摘対応依頼
(AI)PRコメント確認→ファイル編集→コミット&プッシュ→PR指摘対応完了報告
凡例 (AI):AI(Claude Code)の作業, (H):人間の作業
AIの作業は自律的に判断し自走して完了することが期待されています。

 困ったことこのルールをCLAUDE.md に書いて運用したところ、AI作業の漏れや誤りが頻発して人間のフォローが必要な状況でした。
Issue・PRの開始・完了報告コメント漏れ
コミットコメント書式誤り
誤ったマージ先ブランチでのPR起票
CLAUDE.md にはアーキテクチャ、コーディング規約、テスト戦略、開発環境など様々な情報があったので、AIが開発ルールを見落とした可能性があります。

 解決策Claude Codeのカスタムスラッシュコマンドを活用して開発ルールを移動しました。作ったコマンドは下記２つ。.claude/commands の下に配置します。
Issue開始～PR起票

ファイル名:start-issue.md

使い方:/start-issue 番号
Issue #$ARGUMENT の内容を確認して作業着手してください。

 - 作業ルール
   - 着手した旨をIssueコメントに入力してください。
   - `develop` ブランチからIssue用のブランチを切って作業開始してください。
   - コミットコメントにはIssue番号を含めてください。
   - 作業完了後は対応内容をIssueコメントに入力して、Pull Requestを提出してください。
   - Pull Requestの概要欄に `resolves #Issue番号` と入力してください 
   - 作業時には下記ドキュメントを参照してください。
PR指摘対応

ファイル名:answer-pr.md

使い方:/answer-pr 番号
Pull Request #$ARGUMENT の最新の指摘コメントを確認して対応してください。

 - 作業ルール
   - コミットコメントにはIssue番号を含めてください。
   - 作業完了後は対応内容をPull Requestコメントに入力してください。
   - 作業時には下記ドキュメントを参照してください。
期待通りに動きました！
Issue番号を指定するだけで、Issue開始からPR起票まで自走してくれるようになりました。

PR指摘対応もPR番号を指定するだけで、指摘対応コメントまで自走してくれています。

作業漏れもありません。これで心配事も減りますね。

 まとめと学びこんな小さな変更でAIの作業精度が大幅に向上する結果に驚き、プロンプトやコンテキストの最適化の重要性を実感しました。

思えば、重厚長大なドキュメントを渡してもうまく働けないのは人間もですよね。
ドキュメント生成をAIに雑に任せると肥大化・重複化しがちなので、AIの性能を引き出すため、なるべく人間が書いて必要最小限を保っていきたいと思います。
また、Claude CodeのHooksやMCPなど他のカスタマイズ・拡張ポイントも活用してコンテキスト・プロトコルの最適化を探っていきたいと思います。
この記事は

やりたいこと

困ったこと

解決策

まとめと学び

Discussion
