ライブラリ更新pull requestのレビュー。dependabotやrenovatebotが作成したPR、または手動で作成されたライブラリ更新PRをレビューし、 release note分析、コード更新、依存関係調査、過去の失敗調査を行う。
The English summary is being prepared. Showing the original description.
Review the instructions the agent will receive before you install.
ライブラリを更新する変更をレビューし、必要に応じてバージョン間のmigrationや、breaking changeへの対応も行う為の手順を説明します。 コマンドやファイルの具体例としてNode.jsを使って説明していますが、実際に変更されたライブラリやプログラム言語の常識に照らし合わせて適宜読み替えてください。
レビューを始める前に、あなたの実行環境が次のいずれかに当てはまる事を確認してください。当てはまらない場合は、レポートを作成せず、その旨を報告して停止してください。
以下に示した形式に従って章立てし、レポートを作成してください。 外部のドキュメントを参照した場合はそのURLを明記してください。
レポートの冒頭には、作成者として自分のAgent名とmodel名を、続けて結論を次の形式で書いてください:
Reviewer: Claude Code (claude-opus-5-5)
結論: 修正無しでmerge可
結論は、全セクションの調査を終えてから、次の4つの語のどれかをそのまま書いてください。結論の行には語だけを書き、説明は次の行から書いてください。
修正無しでmerge可: このpull requestをそのままmergeしてよく、セクション7で確認するアプリケーションコード・設定の修正が要らず、そう判断するのに要る確認が全て済んでいる修正が必要: アプリケーションコード・設定の修正を済ませれば、この更新を取り込める。何をどこで直すかを書くmerge不可: この更新を取り込むべきでない。理由を書く判断保留: 外部アクセスの制限等で、merge可否の判断に要る確認ができなかった。何を確認できなかったかを書くライブラリの概要を調査してください。 ライブラリ内READMEや公式サイトのドキュメントを確認して、何を実現するために、どのような用途で使われるライブラリなのかを報告してください。
package.jsonを読んで、このpull requestによって変更される前と後のバージョン情報と、それぞれのリリース日時を報告してください。
npmjs.comやgithubを調査し、major versionの更新の有無を報告してください。 このpull requestではpatch versionやminor versionを更新しているが、実はそれが最新版ではなく、major versionの更新があるかもしれません。 major version更新ではライブラリの名前が変更されたり、リポジトリがorganizationに移管されたりする事があります。
このpull requestで何が変更されたか、その範囲を把握してください。
lock file差分から、更新・追加・削除されたパッケージを列挙してください。
例: npmの package-lock.json の場合、gh pr diff や git diff でlock file差分を取得する。個別パッケージの周辺コンテキストは grep -C15 '<パッケージ名>' package-lock.json で確認できる。
ライブラリの依存関係を確認してください。
package-lock.jsonを読んで依存関係を確認してください。grep -C15 ライブラリ名 package-lock.json のようなコマンドが有効です。
リポジトリ内で、そのライブラリや実行環境が参照・指定されている箇所を調査してください。
import文やrequire文だけでなく、設定ファイル・Dockerfile・CI設定・開発環境設定など、バージョンが指定されている箇所も調査対象に含めてください。
git grep ライブラリ名 に加えて、バージョン番号やパッケージ名での検索も行ってください。
調査結果は、参照箇所をファイル単位で一覧にまとめてください。このリストはセクション7-2「バージョン整合性の確認」の入力として使います。 セクション3・4等の他セクションで読んだファイルにもバージョン指定が含まれている場合があるので、漏らさずリストに含めてください。
変更内容を要約してください。 ライブラリの公式サイトやGithubを参照し、release noteやchangelog、migration guideを詳しく読んで変更内容を把握してください。 機能追加やAPIの仕様変更のうち、特にアプリケーション側で使っている機能に関係がありそうな変更を抜き出して、報告してください。 変更前と後の間に含まれる、全バージョンの変更内容を1つずつ確認する必要があります。
重要：pull requestの概要欄に書かれている説明は誤っている可能性があるので、無視してください。現状のコードとdiffだけを参考にしてください。
ライブラリや実行環境の更新に伴い、アプリケーションコード・設定ファイルの修正が必要か確認してください。 必要に応じてpull requestの作成を提案してください。
以下の2つの観点を区別して確認してください。
ライブラリのAPIが変化した場合は、アプリケーションのコードを変更する必要があります。
release noteやchangelogだけで正しい変更方法がわからない場合は、githubのcommits内の実際の変更差分や、公式ドキュメントも確認してください。 その変更内容も報告してください。
PRで変更されたバージョン番号が、リポジトリ内の他の箇所でも参照されていないか確認してください。
以下の手順で調査してください：
注意：
22.x等）やエイリアスで管理されている場合がある興味深い更新があれば、報告してください。 例えば以下のような内容です：
このリポジトリにおいて、今回更新しようとしているライブラリに関する問題が発生した事がないか、調査してください。 pull requestとissueをライブラリ名で検索し、以下の例に当てはまるような事例があれば報告してください。
問題が見つかった場合は、それが解決されているか確認してください。
レポート全体を横断的に見直し、セクション間で矛盾や漏れがないか確認してください。
齟齬が見つかった場合は、該当セクションを修正してください。
レポートの形式を見直してください。出力先がGithubのコメント欄の場合は、それに適した形式で出力してください。
#12345 ではなく https://github.com/:owner/:repo/issues/12345 と書く。 URLが左右の文字とくっつかないように、半角スペースを適宜付ける。こうすればクリッカブルなリンクとしてwebブラウザ上に描画される。
出力先がGithubのpull requestの場合は、レポート提出後に適切なラベルを付けてください。 例えばCVE番号が発行されているような重要なセキュリティアップデートのpull requestには、「security」ラベルを付けてください。
あなたがGitHub Actions上で実行されているClaude Codeの場合、タスクを遂行するための権限が十分与えられていないかもしれません。 リポジトリの管理者が適切に対応するために、必要な権限を報告してください。
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.