開発リード向けです。課題票(Issue)に実装を書いて、人が見ていないあいだに直してほしい、という要望は増えています。
本記事では、プログラムのフォルダを直す開発用の画面(クロード Code)を開発サイト上の自動実行(GitHub Actions)で動かすとき、テストと書き方検査で止める品質ゲートの置き方を整理します。導入手順は公式の始め方ページで確認します。
次は、検査を完了条件に入れ、通るまで変更提案を出さない進め方から始めます。

無人実行が止まらない理由
合格か不合格かが返る確認がないと、完了したように見えて誤りが残ります。テスト、ビルド、書き方の検査(lint)、画面比較など、結果が分かれる手段を完了条件に渡してください。検査なしで進めると、人が寝ているあいだに差分が増え、変更提案の上で直し続ける負荷が先に来ます。
- テストや型検査の実行を、完了条件として明示する
- 未導入の部品を推測で足させない
- 変更提案を出す前に、書き方検査と型検査の成功を必須にする
概要でも、自動検査でのレビューや課題の仕分けを、開発サイト上の自動実行の用途として挙げています。レビュー用の流れは、草稿など対象外の変更提案を飛ばす場合があります。用途の名前より、完了条件に検査が入っているかが先です。

自動実行と手元の使い分け
| 経路 | 向く作業 | 先に決めること |
|---|---|---|
| 開発サイト上の自動実行 | 課題票から変更提案、コメントからの修正 | 認証、実行権限、誰が起動できるか |
| 手元のクロード Code | 確認を挟む実装、失敗テストの再現 | 許可するコマンド、検証手順 |
検証手順が弱いリポジトリは、手元で小さく回してから自動実行へ移す方が安全です。検査コマンドが無いリポジトリへ自動実行を載せない、が次の一手です。手元で疑似的に寄せるなら、課題票を読み、直し、テストを通してから変更提案を出す、という段を固定します。無人実行より、失敗した確認コマンドが次の入力になる回路の方が安定します。

品質ゲートに置く4点
- 合格か不合格かが返るテストを完了条件にする
- 書き方検査や型検査の成功を必須にする
- 課題票の範囲だけ直し、未導入の部品は足さない
- 起動できる人と拒否の範囲を先に決める
依頼の例です。「この課題票の範囲だけ直す。終わったら指定のテストと書き方検査を実行し、失敗したら修正を続ける。未導入の部品は足さない。通るまで変更提案を出さない。」
起動できる人の検査もあります。拒否されると実行は始まりません。権限はアプリ単位でまとめて付くので、組織の審査では公式の権限表を先に渡します。セットアップは案内コマンドによる手順と、アプリ導入・秘密情報の追加・設定配置を手で行う手順があります。認証は管理画面のAPIキーか、有料プランのログイン用トークンです。リポジトリの管理者権限が必要です。

お願いと、強制の止め方
同じ誤りが二度出たら、プロジェクト用の指示ファイル(CLAUDE.md)へ残します。これは毎回読まれるお願いであり、強制設定ではありません。必ず止めたい操作は、決まったタイミングで自動実行する設定(hooks)か、権限の拒否で扱います。
品質ゲートは「書いてあるお願い」だけでは足りません。指示ファイルに検査コマンドを書いても、実行しなければ止まりません。自動実行の設定では、道具を使う前に危険操作を拒み、終わったあとに検査を走らせる、という二段があると、人が寝ているあいだの差分が増えにくくなります。hooksの置き場とイベント名は、公式のhooks案内を見てください。

@claude の前にそろえること
- 手元で同じ確認コマンドが通る状態か
- 完了条件と禁止事項が課題票に書いてあるか
- 起動できる人と秘密情報の置き場が決まっているか
- 変更提案の上で人が見る前提があるか
権限と起動できる人の範囲が決まる前に、課題票へ言及して実装を始めない方が、レビュー負荷は増えません。料金は月額プランと従量課金があります。上限と金額は料金ページで見てください。報告に個人の体感の金額換算は使わないでください。自動実行は、APIキーまたはログイン用トークンを秘密情報として渡します。
リードが最初の一週間で決めること
一日目は、検査コマンドが無いリポジトリを一覧にする。二日目は、手元で同じ確認が通る課題を一件選ぶ。三日目は、完了条件付きの依頼文テンプレを課題票へ置く。四日目は、起動できる人と権限表を組織の審査用にまとめる。五日目は、指示ファイルへ検査コマンドを短く残し、必ず止めたい操作だけhooks候補にする。
効果を聞かれたときは、共通の削減率ではなく、検査を通った変更提案の割合と差し戻し回数を、同じ定義で比べて答えます。
よくあるつまずき
- 検査なしで
@claudeを始め、変更提案に誤りが残る - 指示ファイルに検査を書いただけで、実行されないまま終わる
- 未導入の部品を推測で足し、手元では動かない
- 権限表を渡さず、組織の審査で止まる
- 手元で再現できない失敗を、無人実行だけで直し続ける
FAQ
課題票に書くだけで動くコードになりますか?
なりません。確認手段がないと誤りが残りやすいです。テストと書き方検査を完了条件に含め、変更提案の上で人が見る前提が必要です。
自動実行と手元のどちらから始めますか?
検証手順が弱いリポジトリは、手元で小さく回してから自動実行へ移す方が安全です。確認が自動化できてからで十分です。
APIキーと月額プランのどちらで動かしますか?
自動実行は、APIキーまたはログイン用トークンを秘密情報として渡します。上限と金額は料金ページで確認してください。
指示ファイルだけで品質ゲートになりますか?
なりません。お願いであり強制ではありません。必ず止めたい操作はhooksか権限の拒否で扱います。
レビュー用の自動実行はすべて見ますか?
公式の案内では、草稿など対象外の変更提案を飛ばす場合があります。対象範囲は設定と公式案内を見てください。
まとめ
開発リードが課題票からの自動実装を載せる前に決めるのは、検査の完了条件、手元での再現、権限、人の確認です。指示ファイルはお願い、hooksと権限は強制、と分けます。効果を語るときは、検査を通った変更提案の件数と差し戻しで測ってください。公式の料金や上限は料金ページで確認します。

コメント