Codex work log
CodexでGitHub IssueとPR reviewを安全に作業単位へ分けた実践ログ
このページは、GitHub Issue と PR review の反応語を、Codex作業で安全に受けるために既存ページを小補強した記録です。実際のIssueやPRを操作したログではなく、公開してよい範囲に一般化した実践ログです。
認証情報、検証タグ値、内部パス、バックアップ詳細、個別の非公開設定は本文に載せていません。重要操作は人間確認を前提にしています。
今回の作業で見た反応語
Search Console側では、GitHub IssueやPR reviewをCodexでどう扱うかという実務寄りの検索意図が見えていました。
- codex github issue
- codex github pr review
- github codex レビュー
- codex issue
- codex pr review
- GitHubレビューコメント対応
新規ページを増やす前に既存受け皿を確認した
まず CodexとGitHub Issue と CodexのGitHub PR review が既に存在するかを確認しました。どちらも受け皿として使えるため、似た新規ページを乱立させず、既存ページを小さく補強する判断にしました。
あわせて、sitemap掲載、認証確認タグ、広告タグ、canonical、robots、内部リンク、スマホ表示を確認し、本文補強と技術的な同期作業を分けました。
Issueは「本文」ではなく作業単位に分ける
Issue本文をそのままCodexに渡すと、作業範囲が広がりすぎることがあります。今回の補強では、Issueを次の単位に分けてから渡す考え方にしました。
| 分ける項目 | 確認する内容 |
|---|---|
| 目的 | 何を直したいのかを一文で確認します。 |
| 再現手順 | どの操作や画面で問題が出るかを分けます。 |
| 期待結果 | 本来どうなってほしいかを明確にします。 |
| 実際の結果 | 今起きている表示、挙動、エラーを整理します。 |
| 対象ファイル | 触ってよい範囲と触らない範囲を分けます。 |
| 不明点 | 不明な点は勝手に実装せず、確認待ちにします。 |
PR reviewはコメントごとに対応を分ける
PR reviewでは、すべてのコメントを同じ作業として扱わないことが重要です。対応必須の指摘、suggestion、任意コメント、仕様確認が必要なコメントを分けます。
- requested changes は優先して確認する
- suggestion は、そのまま適用してよいかを見る
- 任意コメントは、今対応するか後回しにするか分ける
- 仕様確認が必要なコメントは、実装前に止める
- 修正後は差分、テスト結果、コメントとの対応関係を見る
Codexに渡す前に確認したこと
今回の作業では、Codexに実装を広げさせる前に、対象URLと安全確認の状態を分けて見ました。
- 変更対象URLが既存受け皿として使えるか
- sitemapに掲載されているか
- 広告タグと所有権確認タグが維持されているか
- canonicalが自己URLか
- robotsがindex,followか
- noindexが入っていないか
- 内部リンクや画像に404がないか
- 390px幅で横スクロールしないか
今回やらなかったこと
実践ログにするうえで、やったこと以上に「やらなかったこと」も明確にしました。
- GitHubのIssueやPRを操作しない
- 統合、削除、履歴変更、強制反映のような重要操作をしない
- 認証情報や鍵の実値を扱わない
- 未作成の差分確認ページを作らない
- 未作成URLへリンクしない
- 既存ページのSEOタグを変えない
次に同じ作業をするときのチェック
- Issueを読み、目的と再現手順を分ける
- PR reviewコメントを対応単位に分ける
- 既存受け皿ページがあるか確認する
- sitemapとタグ状態を先に確認する
- 補強は小さく切り、作業範囲を広げすぎない
- 差分、内部リンク、スマホ表示を確認する
- 公開してよい範囲だけ実践ログに残す
関連ページ
FAQ
GitHub IssueをそのままCodexに渡してもよいですか？
そのまま渡すより、目的、再現手順、期待結果、対象ファイル、触らない範囲を分けてから渡す方が安全です。
PR reviewのコメントは全部Codexで直してよいですか？
まず、対応必須の指摘、任意コメント、仕様確認が必要な内容に分けます。すぐ実装できるものだけを対象にする方が安全です。
Codexに重要なGitHub判断まで任せてよいですか？
このログでは、GitHub issueやPRの操作、統合、削除、履歴変更などは行っていません。Codexには確認と修正範囲の整理をさせ、重要操作は人間確認にするのが安全です。