codepatrol
リポジトリのセキュリティ調査を領域ごとに進める。 このsessionは調査を指揮し、領域ごとに起動したsubagentが調査してレポートを出力する。 レポートの問題のトリアージと、問題の自動修正、問題を直すpull requestの状態の同期も指揮する。 複数sessionにまたがる長期作業を想定し、実行するたびに現状を確認して続きの作業を行う。 ユーザーが手動で起動する。
shokai · 已有静态检查记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add shokai/agent-skills --skill codepatrol技能说明
name: codepatrol description: >- リポジトリのセキュリティ調査を領域ごとに進める。 このsessionは調査を指揮し、領域ごとに起動したsubagentが調査してレポートを出力する。 レポートの問題のトリアージと、問題の自動修正、問題を直すpull requestの状態の同期も指揮する。 複数sessionにまたがる長期作業を想定し、実行するたびに現状を確認して続きの作業を行う。 ユーザーが手動で起動する。 argument-hint: "[未調査の領域だけ | 全領域 | 領域名... | 調査対象リストを更新しろ | トリアージ | 状態同期 | 自動修正]" disable-model-invocation: true
セキュリティ調査の指揮
リポジトリのソースコードを領域ごとにセキュリティ観点で調査し、レポートを揃える。ユーザーに依頼された時は、揃ったレポートの問題をトリアージし、問題を自動修正し、問題を直すpull requestの状態をページに反映する。 このsessionは指揮役になる。ユーザーと対話し、調査する領域を決め、subagentに作業を任せ、結果を確かめて記録する。調査する領域が1つでも同じである。
指揮役としての振る舞いは、kuden:orchestrator skillを読み込み、その基準に従う。指揮役は調査対象のコードを読まない。
作業は、以下のskillを実行するsubagentに任せる。
| skill | 作業 | 読む物 |
|---|---|---|
| codepatrol-setup | 調査対象リストと観点リストを生成・更新する | コード |
| codepatrol-report | 1つの領域を調査してレポートを出力する | コード |
| codepatrol-triage | レポートの問題を分類し、トリアージページを作る | レポート |
| codepatrol-sync-state | 問題を直すpull requestの状態を、ページに反映する | レポートとpull request |
| codepatrol-autofix | 1つの問題を修正し、pull requestを仕上げる | レポートとコード |
| codepatrol-autofix-deploynote | デプロイの前後にやる事を、release pull requestのコメントにまとめる | pull request |
subagentには、Opus以上のtierのmodelを指定する。
ファイル構成
.dev/codepatrol/
config.md ← レポートの書き出し先設定
checklist.md ← 観点リスト。リポジトリの実装に合わせて生成する
targets.md ← 調査対象リスト。各H2見出しが調査領域
{領域名}-{YYYY-MM-DD}.md ← 領域ごとの調査レポート(書き出し先がローカルの場合)
実行環境の確認
いずれかを満たさなければ、何も行わず、満たさない条件をユーザーに報告して停止する。トリアージと、状態同期だけを行う時は、条件2と条件3の確認は要らない:
- 自分のmodelがOpus以上のtierである(Opus、Fable、Mythos等)。Sonnet・Haiku等の下位tierは問題の検出能力が足りない
- Codex CLIがインストールされている。Bashツールで
command -v codexを実行して確認する - CodexのmodelがSol以上のflagship(Sol、Astra等)で、reasoning effortがmedium以上である。短いプロンプトを作業ツリー外のファイルに書き、
codex exec --ephemeralにstdinで渡して1回実行し、出力のヘッダから読む。Luna・Terra等の軽量tierと、Solより前の世代のmodelは相談相手として足りない
codex exec を直接実行するのはこの確認だけにする。Codexへの相談は、subagentがSkill toolで codex-consultation を呼び出して行う。
調査用の作業ツリー
調査と、リストの生成・更新は、調査用のbranchをcheckoutしたgit worktreeで行う。調査は長時間かかるので、その間もユーザーが自分のcheckoutで他の作業を続けられるようにする。
- 調査用のbranchは、最新のdefault branchから切る。前のsessionが作った調査用のworktreeが残っていれば、それを使い、最新のdefault branchに追従させる
- 調査対象が他のリポジトリにもある時は、それらも最新のdefault branchの状態で読めるようにする
- ユーザーのcheckoutでは、branchの切り替えもファイルの変更もしない
.dev/codepatrol/ の置き場所は、リポジトリがこのディレクトリをgitで管理するかどうかで決まる。
- 管理するリポジトリでは、調査用のworktreeの中の物を使う。設定ファイルやレポートが、default branchではなく他のbranchやユーザーのcheckoutにある時は、調査用のbranchに引き継ぐ。引き継がないと、設定を作り直し、調査済みの領域を未調査として扱ってしまう
- gitignoreしている等、管理しないリポジトリでは、ユーザーのcheckoutの中の物を使う。worktreeには現れないためである。ユーザーのcheckoutで書き換えてよいのは、このディレクトリだけである。commitはしない
作業ツリーを用意したら、ユーザーに報告する。作業がどこで行われ、変更がどこに残るのかを、ユーザーが把握できるようにする。
- 調査用のworktreeの場所とbranchの名前。新しく作ったのか、前のsessionの物を使うのか
.dev/codepatrol/の場所- 設定ファイルやレポートを引き継いだ時は、引き継いだ元
subagentには、コードを読む場所と、.dev/codepatrol/ の場所の両方を伝える。
セットアップ
.dev/codepatrol/ の3つの設定ファイルが揃っていなければ、無い物を用意する。
config.md
無ければ、レポートの書き出し先を決めて記録する。
- AskUserQuestionツールで書き出し先をユーザーに確認する:
Cosenseに集約する— レポートをCosenseのページとして作成し、hubページに被リンクで集約する。チームでの共有・議論に向くローカルファイル—.dev/codepatrol/{領域名}-{YYYY-MM-DD}.mdに書き出す
- Cosenseの場合は、project URLとhubページ名(例:
{プロダクト名} セキュリティレポート)をユーザーに確認する - config.mdに記録する。フォーマット:
# Codepatrol Report Destination
レポートの書き出し先設定。
- 書き出し先: {Cosense または ローカル}
- project URL: {https://scrapbox.io/プロジェクト名}
- hubページ: {hubページ名}
- レポートページのタイトル規則: `{hubページ名} {YYYY/M} ({領域名})`
- 年月はレポート作成時点、月はゼロ埋めなし(例: 2026/7)
- 前提: cosense CLI(`npm install -g @helpfeel/cosense-cli`)のインストールとログイン
ローカルの場合は「書き出し先: ローカル」だけを記録する。
targets.md と checklist.md
次の場合に、codepatrol-setupを実行するsubagentを起動し、生成・更新を任せる。
- ファイルが無い
- ユーザーが更新を指示した
Generated byの記録から、生成したmodelが「実行環境の確認」の条件1を満たすと確認できない。Sonnet・Haiku、Codex、記録なし等である。両方を作り直させるGenerated byの記録から、レビューしたCodexが条件3を満たすと確認できない。「Codexレビュー未実施」の記録がある、Codexの実行環境が書かれていない、条件外のmodel等である。リストのレビューだけをやり直させる
codepatrol-setupでのCodexのレビューを経ていないリストで、調査を始めない。Codexが止まってレビューが完了しなかった時は、ユーザーに報告して判断を待つ。
調査を始める前に checklist.md を読み、checklistとレポートの責任境界 に合わない記述が入り込んでいないかを確かめる。問題の断定・深刻度・レポートの問題への言及があれば、調査の担当が読む前に取り除く。事実の記述に書き直すのにコードの確認が要る時は、codepatrol-setupを実行するsubagentに任せる。
subagentの報告から、targets.mdの領域の一覧をユーザーに伝える。領域の分割・統合は、ユーザーがtargets.mdを編集して行う。
調査する領域を決める
targets.md の領域と既存のレポートを突き合わせ、領域ごとに未調査か調査済みか、調査済みなら最後の調査時期を把握して、ユーザーに報告する。
- 書き出し先がCosenseの場合: hubページに集約された既存レポートのタイトルから把握する。hubページやレポートが無ければ、全領域を未調査として扱う
- 書き出し先がローカルの場合:
.dev/codepatrol/にレポートのファイルがある領域が調査済みである。調査時期は、ファイル名の日付から読む
進み具合の判定は、レポートの存在と調査時期だけで行う。コードの変更内容から再調査の要否を推定しない。
範囲が指定されていなければ、AskUserQuestionツールで1回だけ確認する。未調査の領域だけか、調査済みの領域の再調査も含めるか、領域を指定するか、である。 再調査を含める時は、いつより前のレポートしか無い領域を再調査するのか、境目の時期も確認する。中断した後に起動し直した時に、同じ境目から残りの領域を求められる。
順番は指揮役が決める。
- 未調査の領域を先にする。その中では、他の領域のレポートが主担当として名指しした領域と、認可・認証・外部通信に関わる領域を先にする
- 再調査は、最後の調査が古い領域から行う
中断した後に起動し直した時は、範囲と既存のレポートから残りの領域を求め直す。
調査をsubagentに任せる
レポート1本ごとに新しいsubagentを起動し、codepatrol-reportを実行させる。
指示に含める事
- 担当する領域の名前
- 再調査の場合は、前回として扱う既存レポートの場所
- コードを読む場所と、
.dev/codepatrol/の場所 - 作業用ディレクトリ。session用の一時ディレクトリの下に、領域ごとに分ける。Codexの出力や途中結果が、並走するsubagentの物と混ざらないようにする
- 問題の名前の一覧のファイル
- 並走している領域と、担当する領域とファイルが重なる領域
既存の問題の内容は、指示に含めない。
問題の名前の一覧
既存のレポートにある問題の名前を、レポートごとに並べたファイルである。領域をまたいで同じ問題に別の名前が付くのを防ぐ。
- 各領域の最新のレポートから、問題の深刻度・見出し・名前だけを拾う。問題の本文は入れない
- 最初のsubagentを起動する前に作り、レポートが1本できるたびに作り直す
- レポートを読んで一覧を作る作業も、subagentに任せてよい
並列に調査する
読むファイルが重ならない領域の組だけを、並列にする。近い領域を並列にすると、同じ問題に別の名前が付く。並列は3本までを目安にする。
並列にした組が終わったら、各subagentの報告にある「他の領域と重なりそうな問題」を突き合わせる。同じ問題に別の名前が付いていたら、両方のレポートの該当する問題に、相手の問題への参照と、どちらの名前で1件として扱うかを、1行ずつ足す。
subagentの報告を確かめる
ユーザーに報告する前に、以下を自分で確かめる。
- レポートが、設定された