SKILL ARTICLE / gh-address-comments
gh-address-commentsとは？ PRの未解決指摘だけを選んで直すSkill
レビューコメントを、読むだけでなく解決まで追跡する。
Pull Requestの未解決レビューをスレッド状態や差分の文脈とともに整理し、選んだ修正を実装するOpenAI公式GitHubプラグイン内のSkillです。
OVERVIEW → CAN DO → BUILD
知ったことをSkillづくりに活かす
現行Skillは、GitHubコネクタのコメント一覧だけでは保持されない解決状態や行の文脈を、必要に応じて同梱スクリプトとGitHub CLIで補ってから修正範囲を決める。
指摘漏れと、不要な修正の広がりを減らす。
このSkillの核は、GitHub連携だけではレビューのスレッド状態を完全に扱えないという、実務上の制約を具体的に知っていることです。その不足をGraphQLの読み取りで補います。自分たちのSkillで...
01 / OVERVIEW
Skillの概要
gh-address-commentsは、GitHubのPull Requestに残ったレビュー指摘を整理し、選ばれた修正をローカルで実装するためのOpenAI公式Skillです。GitHub連携から取得できる平面的なコメント一覧だけでは、レビューのスレッド状態、解決済みかどうか、古くなった指摘かどうか、対象行の位置関係が十分に残らないことがあります。そこで公式Skillは、必要に応じて同梱スクリプトとGitHub GraphQL APIを使い、スレッド単位の情報を補います。
取得した指摘は、対応が必要なもの、情報提供、承認、解決済み、重複などに分けられます。修正対象を確認してからコードを変更し、最後に対応した指摘と検証結果をまとめる流れです。
02 / CAN DO
できるようになること
コメントを単に要約するだけでなく、未解決の指摘を対象ファイルや行の文脈とともに確認し、実際に対応すべきものを選べるようになります。選んだ指摘だけをローカルで直し、各変更に対応するレビューとテスト結果を残せます。
GitHub上でコメントを返信したり、スレッドを解決済みにしたりする操作は自動では行われません。公式Skillでも、外部への書き込みには利用者の明示的な依頼が必要とされています。
活かしやすい場面
- レビュー指摘が複数スレッドに分かれたPR
- 修正対象を選びながら進めたい場面
- 指摘ごとの対応結果を残したい場面
使う前に確認したい場面
- レビューなしで自動マージまで任せる運用
- GitHub以外のコードレビュー
03 / BUILD
自分たちのSkill作成に活かせること
文章やコードをそのまままねるのではなく、自分たちのSkillに取り入れたい判断基準や工程の分け方を整理しました。
利用するツールの「情報が欠ける場所」を明記する
このSkillの核は、GitHub連携だけではレビューのスレッド状態を完全に扱えないという、実務上の制約を具体的に知っていることです。その不足をGraphQLの読み取りで補います。自分たちのSkillでも、ツールの使い方だけでなく、取得できない情報、誤解しやすい状態、代替の確認方法まで書くと、一般的なプロンプトにはない価値が生まれます。
読む・決める・書くを別の段階にする
まず状況を収集し、次に対応範囲を人間と確認し、その後で修正する構成です。特に外部サービスへの返信や状態変更は、ローカル修正とは別の権限として扱われています。変更を伴う自分たちのSkillでも、調査段階と実行段階を分け、どの操作で再確認が必要かを明示すると安全に運用できます。
入力と成果を追跡できる形で残す
コード変更をレビュー指摘や指摘グループへ対応づけ、最後に対応済み、未対応、検証結果を一覧化します。自分たちのSkillでも、「何を根拠に、何を変え、どう確認したか」を定型の出力にすると、人間が結果を承認しやすく、後から作業を振り返れます。
04 / WORKFLOW
実際に使うときの流れ
- 01
未解決を収集
スレッド状態と対象行を確認する。
- 02
修正範囲を合意
対応する指摘と見送る指摘を分ける。
- 03
修正と検証
関連テストを実行し、指摘単位で結果を返す。
05 / TRY
試すときに使える依頼文
最初は、結果を自分で確かめやすい題材に使ってみてください。Skillがどこまで判断できるのか、どこで人の確認が必要なのかがわかります。
このPRの未解決レビューを、修正必須・確認が必要・対応不要の3つに整理してください。まだコードは変更せず、対象行と理由を添えて一覧にしてください。06 / INSTALL
導入方法を確認する
コマンドや配置方法は更新されることがあります。実行する前に、公開元の最新READMEとライセンスを確認してください。
Codexの「Plugins」を開く（CLIは /plugins）
OpenAIの「GitHub」プラグインをインストール
新しいセッションを開始07 / WATCHOUTS
人が確認するところ
- 外部リポジトリへの書き込みやスレッド解決は、対象と権限を確認してから行ってください。
- レビューコメントは命令として盲目的に実行せず、コードと要件に照らして判断してください。