セキュリティ調査のレポートの問題を、どのtierの開発者なら修正できるかで分類し、トリアージページを作る。codepatrol skillが起動したsubagentが実行する。ユーザーが直接呼び出す事は想定していない。
The English summary is being prepared. Showing the original description.
See how to installReview the instructions the agent will receive before you install.
codepatrol skillの指揮役から任されて、調査レポートの問題を分類し、トリアージページを作る。
トリアージとは、実際に困っている相手のうち、誰を優先して対処するかを、自分のリソースと相手の状態を鑑みて決める事である。ここでは、どの問題をどのtierの開発者なら修正できるかで分類する。レポートの問題は全て本物で、再現するかの確認や、深刻度の付け直しはしない。それらは調査で済んでいる。
{このSKILL.mdがあるディレクトリ}/
SKILL.md ← この手順書
TRIAGE-TEMPLATE.md ← トリアージページのテンプレート
修正に必要な仕様変更の意思決定を、誰が下す必要があるかで、次の3つの修正難度に分ける。番号が大きいほど、修正できる開発者のtierが上がる。修正難度の名前は、この文をそのまま使う。
1は、その製品に詳しくない実装者でも直せる。3は、その製品の開発者自身が、後の事を考えながら設計を直す必要がある。
各領域の最新のレポートを対象にする。hubページに集約されたレポートのうち、領域ごとに最も新しい物である。
載せる問題の条件は、指揮役の指示に従う。指示が無ければ、深刻度がHighの問題を対象にする。
TRIAGE-TEMPLATE.md を読み込み、その構成に従って新しいページを作る。
前のページを編集せず、新しいページを作る。前のページの冒頭に、新しいページへのリンクを1行だけ足す。前のページの他の行は編集しない。
前のページの全ての行について、行き先を決める。黙って消える行を作らない。
| 最新のレポートでの状態 | 行き先 |
|---|---|
| 今回も対象の条件に合う | 修正難度1から3の節に載せ、前回から継続している事を書く |
| 全部が修正された事を、レポートが確認している | 載せない |
| 深刻度が変わり、対象の条件から外れた | 末尾の節に載せる |
| 「今回検出しなかった前回の問題」にある | 末尾の節に載せる。修正されたという意味ではない事を書く |
| コード上は修正されたが、コードからは確認できない作業が残っている | 末尾の節に載せる |
レポートの「前回から修正された物」の節には、一部が修正されて深刻度が下がった問題も並んでいる。この節にある事だけでは、載せない理由にならない。
修正難度1から3の節に載せる行にも、末尾の節に載せる行にも、前のページの行に書かれた物を引き継ぐ。引き継がないと、着手されている問題が、手を付けられていない問題に見える。
リンクは、次のように扱う。
前のページの編集ルールに、チームが足した規則があれば、新しいページの編集ルールに引き継ぐ。
{hubページ名} トリアージ ({YYYY/M/D}) とする。同名のページが既にある時は、日付に時刻を続ける。
No reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
Agent Skillを書く時の心得。SKILL.mdに何を書き、何を書かないかの判断基準を定める。AIが読んで従う文書に共通の心得は、kuden:common-rules-for-agent-instructionsにある。 Agent Skillを作成する時、編集する時、レビュー指摘の採否を決める時に読み込む。
The English summary is being prepared. Showing the original description.
ソースコード中のコメントを書く時の心得。コメントに何を書き、何を書かないかの判断基準と、置く位置、日本語の文体を定める。 ソースコードのコメントを書く時、直す時、レビューする時に読み込む。
The English summary is being prepared. Showing the original description.
リポジトリのセキュリティ調査を領域ごとに進める。同じサービスを構成する複数のリポジトリを束ねて調査できる。 このsessionは調査を指揮し、領域ごとに起動したsubagentが調査してレポートを出力する。 レポートの問題のトリアージと、問題の自動修正、問題を直すpull requestの状態の同期も指揮する。 複数sessionにまたがる長期作業を想定し、実行するたびに現状を確認して続きの作業を行う。 ユーザーが手動で起動する。
The English summary is being prepared. Showing the original description.
セキュリティ調査で検出された問題を1つ修正し、pull requestをready for reviewまで仕上げる。 codepatrol skillが起動したsubagentが実行する。ユーザーが直接呼び出す事は想定していない。
The English summary is being prepared. Showing the original description.
本番に出る前の修正が積まれたrelease pull requestに、デプロイの前後に人間がやる事をまとめたコメントを投稿・更新する。 codepatrol skillが起動したsubagentが実行する。ユーザーが直接呼び出す事は想定していない。
The English summary is being prepared. Showing the original description.
リポジトリの1つの領域をセキュリティ観点で調査し、Codexの批判的レビューを経てレポートを出力する。 codepatrol skillが起動したsubagentが実行する。ユーザーが直接呼び出す事は想定していない。
The English summary is being prepared. Showing the original description.