最終更新 11月8日 18:55

開発リード向け|Claude CodeによるIssue自動実装をテスト・レビュー段階で止める品質ゲートの作り方

開発リード向けです。課題票(Issue)に実装を書いて、人が見ていないあいだに直してほしい、という要望は増えています。

本記事では、プログラムのフォルダを直す開発用の画面(クロード Code)を開発サイト上の自動実行(GitHub Actions)で動かすとき、テストと書き方検査で止める品質ゲートの置き方を整理します。導入手順は公式の始め方ページで確認します。

次は、検査を完了条件に入れ、通るまで変更提案を出さない進め方から始めます。

検査なしの自動実装と、検査で止める進め方。避ける進め方は検査なしで課題票から実装を進めること、見た目だけ完了し誤りが残ること。安全な進め方はテストと書き方検査を完了条件にし、通るまで変更提案(PR)を出さないこと。
検査なしの自動実装と、検査で止める進め方。避ける進め方は検査なしで課題票から実装を進めること、見た目だけ完了し誤りが残ること。安全な進め方はテストと書き方検査を完了条件にし、通るまで変更提案(PR)を出さないこと。
目次

無人実行が止まらない理由

合格か不合格かが返る確認がないと、完了したように見えて誤りが残ります。テスト、ビルド、書き方の検査(lint)、画面比較など、結果が分かれる手段を完了条件に渡してください。検査なしで進めると、人が寝ているあいだに差分が増え、変更提案の上で直し続ける負荷が先に来ます。

  • テストや型検査の実行を、完了条件として明示する
  • 未導入の部品を推測で足させない
  • 変更提案を出す前に、書き方検査と型検査の成功を必須にする

概要でも、自動検査でのレビューや課題の仕分けを、開発サイト上の自動実行の用途として挙げています。レビュー用の流れは、草稿など対象外の変更提案を飛ばす場合があります。用途の名前より、完了条件に検査が入っているかが先です。

どこでクロード Codeを動かすか。開発サイト上の自動実行は課題票から変更提案まで進め、誰が起動できるかを先に決める。自分のPCの開発用画面は途中で確認しながら実装し、落ちたテストを手元で再現する。
どこでクロード Codeを動かすか。開発サイト上の自動実行は課題票から変更提案まで進め、誰が起動できるかを先に決める。自分のPCの開発用画面は途中で確認しながら実装し、落ちたテストを手元で再現する。

自動実行と手元の使い分け

経路 向く作業 先に決めること
開発サイト上の自動実行 課題票から変更提案、コメントからの修正 認証、実行権限、誰が起動できるか
手元のクロード Code 確認を挟む実装、失敗テストの再現 許可するコマンド、検証手順

検証手順が弱いリポジトリは、手元で小さく回してから自動実行へ移す方が安全です。検査コマンドが無いリポジトリへ自動実行を載せない、が次の一手です。手元で疑似的に寄せるなら、課題票を読み、直し、テストを通してから変更提案を出す、という段を固定します。無人実行より、失敗した確認コマンドが次の入力になる回路の方が安定します。

品質ゲートに入れる4条件。1 テスト:合格/不合格が分かるテストを完了条件にする。2 書き方検査:lintや型チェックの成功を必須にする。3 修正範囲:課題票の範囲だけ直し勝手に新機能を足さない。4 起動権限:誰が始められるか何を拒否するかを先に決める。
品質ゲートに入れる4条件。1 テスト:合格/不合格が分かるテストを完了条件にする。2 書き方検査:lintや型チェックの成功を必須にする。3 修正範囲:課題票の範囲だけ直し勝手に新機能を足さない。4 起動権限:誰が始められるか何を拒否するかを先に決める。

品質ゲートに置く4点

  1. 合格か不合格かが返るテストを完了条件にする
  2. 書き方検査や型検査の成功を必須にする
  3. 課題票の範囲だけ直し、未導入の部品は足さない
  4. 起動できる人と拒否の範囲を先に決める

依頼の例です。「この課題票の範囲だけ直す。終わったら指定のテストと書き方検査を実行し、失敗したら修正を続ける。未導入の部品は足さない。通るまで変更提案を出さない。」

起動できる人の検査もあります。拒否されると実行は始まりません。権限はアプリ単位でまとめて付くので、組織の審査では公式の権限表を先に渡します。セットアップは案内コマンドによる手順と、アプリ導入・秘密情報の追加・設定配置を手で行う手順があります。認証は管理画面のAPIキーか、有料プランのログイン用トークンです。リポジトリの管理者権限が必要です。

お願いと強制を分ける。お願いは指示ファイルで毎回読まれるが強制ではない。強制は hooks ・権限拒否で危険な操作を確実に止める。設定しないと止まらない。
お願いと強制を分ける。お願いは指示ファイルで毎回読まれるが強制ではない。強制は hooks ・権限拒否で危険な操作を確実に止める。設定しないと止まらない。

お願いと、強制の止め方

同じ誤りが二度出たら、プロジェクト用の指示ファイル(CLAUDE.md)へ残します。これは毎回読まれるお願いであり、強制設定ではありません。必ず止めたい操作は、決まったタイミングで自動実行する設定(hooks)か、権限の拒否で扱います。

品質ゲートは「書いてあるお願い」だけでは足りません。指示ファイルに検査コマンドを書いても、実行しなければ止まりません。自動実行の設定では、道具を使う前に危険操作を拒み、終わったあとに検査を走らせる、という二段があると、人が寝ているあいだの差分が増えにくくなります。hooksの置き場とイベント名は、公式のhooks案内を見てください。

課題票で@claudeする前の確認。1 手元確認:同じ検査コマンドが自分のPCで通る。2 完了条件:課題票に終わり方と禁止事項がある。3 権限:起動できる人と秘密情報の置き場が決まっている。4 人の確認:変更提案のうえで人がレビューする前提がある。
課題票で@claudeする前の確認。1 手元確認:同じ検査コマンドが自分のPCで通る。2 完了条件:課題票に終わり方と禁止事項がある。3 権限:起動できる人と秘密情報の置き場が決まっている。4 人の確認:変更提案のうえで人がレビューする前提がある。

@claude の前にそろえること

  • 手元で同じ確認コマンドが通る状態か
  • 完了条件と禁止事項が課題票に書いてあるか
  • 起動できる人と秘密情報の置き場が決まっているか
  • 変更提案の上で人が見る前提があるか

権限と起動できる人の範囲が決まる前に、課題票へ言及して実装を始めない方が、レビュー負荷は増えません。料金は月額プランと従量課金があります。上限と金額は料金ページで見てください。報告に個人の体感の金額換算は使わないでください。自動実行は、APIキーまたはログイン用トークンを秘密情報として渡します。

リードが最初の一週間で決めること

一日目は、検査コマンドが無いリポジトリを一覧にする。二日目は、手元で同じ確認が通る課題を一件選ぶ。三日目は、完了条件付きの依頼文テンプレを課題票へ置く。四日目は、起動できる人と権限表を組織の審査用にまとめる。五日目は、指示ファイルへ検査コマンドを短く残し、必ず止めたい操作だけhooks候補にする。

効果を聞かれたときは、共通の削減率ではなく、検査を通った変更提案の割合と差し戻し回数を、同じ定義で比べて答えます。

よくあるつまずき

  • 検査なしで @claude を始め、変更提案に誤りが残る
  • 指示ファイルに検査を書いただけで、実行されないまま終わる
  • 未導入の部品を推測で足し、手元では動かない
  • 権限表を渡さず、組織の審査で止まる
  • 手元で再現できない失敗を、無人実行だけで直し続ける

FAQ

課題票に書くだけで動くコードになりますか?

なりません。確認手段がないと誤りが残りやすいです。テストと書き方検査を完了条件に含め、変更提案の上で人が見る前提が必要です。

自動実行と手元のどちらから始めますか?

検証手順が弱いリポジトリは、手元で小さく回してから自動実行へ移す方が安全です。確認が自動化できてからで十分です。

APIキーと月額プランのどちらで動かしますか?

自動実行は、APIキーまたはログイン用トークンを秘密情報として渡します。上限と金額は料金ページで確認してください。

指示ファイルだけで品質ゲートになりますか?

なりません。お願いであり強制ではありません。必ず止めたい操作はhooksか権限の拒否で扱います。

レビュー用の自動実行はすべて見ますか?

公式の案内では、草稿など対象外の変更提案を飛ばす場合があります。対象範囲は設定と公式案内を見てください。

まとめ

開発リードが課題票からの自動実装を載せる前に決めるのは、検査の完了条件、手元での再現、権限、人の確認です。指示ファイルはお願い、hooksと権限は強制、と分けます。効果を語るときは、検査を通った変更提案の件数と差し戻しで測ってください。公式の料金や上限は料金ページで確認します。

参考文献

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

この記事を書いた人

コメント

コメントする

目次