CI で動かす Claude のプロンプトは Issue 本文に置き、Issue を直すだけで試せるようにする
Claude Code Action のプロンプトをワークフローの YAML に書くと、直すたびに PR とマージが要る。プロンプトを Issue 本文に切り出して CI から読ませれば、Issue を編集するだけで次の実行から新しいプロンプトになる。ナレッジワークの事例では、さらに Issue の Assignees を「購読者」にし、判断理由を HTML コメントで残させている。
どんな時に使う？
- PR ごとに Claude にチェックさせる仕組みを育てている途中で、プロンプトを何度も変えたい
- 「AI ではレビューできない確認項目」（実機での見た目、並び順、長い文字列のはみ出し、Figma との一致など）を、変更内容に応じて PR にチェックリストとして出したい
手順
- プロンプトごとに Issue を1つ作り、本文にプロンプトを書く。ラベル（例:
pr-checklist-prompt）を付ける - ワークフローでは、そのラベルの Issue を
gh issue list --label ...で取り、本文を Claude Code Action に渡す。ラベルで選ぶので、Issue を足すだけで新しいプロンプトが増える - Issue の Assignees を、そのチェックを受け取りたい人の一覧（オプトイン）として使う。PR の作者が購読していない Issue はスクリプトで先に外し、Claude を呼ばない（費用を抑える）
- 出力は Claude に直接投稿させず、スクリプトが受け取って PR にコメントする。投稿の形や重複の扱いを決定的にできる
- Claude には「なぜその項目を出した／出さなかったか」を HTML コメント（
<!-- ... -->）で書かせる。PR 上では見えず、プロンプトを直すときの手がかりになる
注意点
- Issue を編集できる人がプロンプトを変えられる。リポジトリの権限と、Issue の編集履歴で追えることを確認しておく
- 本番のレビュー観点が固まったら、YAML か
.github/配下のファイルに戻してレビュー対象にするのも手 - 関連: CI の AI コードレビューは「専門レビュアー＋取りまとめ役」に分け、差分の大きさで人数を変える、UI は「画像モック→承認→Issue→並列実装」の順で作らせる
出典
- X の投稿より: @yoshiko_pg · 2026-03-06
- 記事（ナレッジワーク, Zenn）: zenn.dev