今回やった作業
Codexに内部リンク改善を依頼する時の指示文テンプレートを整理します。内部リンク改善は、ただ「リンクを増やして」と頼むと、404リンクや不自然な導線が生まれる可能性があります。
今回の5本は、1/8から7/8までで増やしてきたランキング、リンク、CSS、公開確認、表示確認、安全確認の実践ログを、運用として使いやすい形にまとめるためのページです。作業単体ではなく、次の作業で再利用できるテンプレートとして残します。
作業前の状態
作業前は、カード内にサムネイル、タイトル、詳しく見るボタン、外部リンクなど複数のクリック箇所がありました。内部詳細ページがあるカードとないカードが混ざる場合、一律リンク化すると存在しないURLへ進む危険があります。
作業前の段階では、実装、確認、報告、記事化候補が別々に扱われていました。実務では、この4つを分けて書くほどレビューしやすくなり、同じ失敗を繰り返しにくくなります。
作業前に問題だったこと
内部リンク改善はリンクの本数を増やす作業ではありません。どこを主導線にするか、外部リンクをどう残すか、内部ページがない時はどうするか、公開HTMLにhrefがどう出るかまで確認する必要があります。
特にCodex作業では、作業そのものが速いぶん、確認や報告が薄くなると危険です。何を確認したのか、何を確認していないのか、どのファイルを触っていないのかを残さないと、公開中サイトの運用では判断材料が不足します。
Codexに任せたこと
Codexには、サムネイルhref確認、タイトルhref確認、詳しく見るhref確認、外部リンク確認、内部詳細ページの有無確認、条件分岐確認、公開HTML確認、404リンク確認を任せました。
Codexには、ファイル作成やHTML修正だけでなく、確認項目の整理、公開HTMLの裏取り、内部リンクの確認、触っていない範囲の報告、実践ログ化候補の整理まで任せます。ただし、公開可否や表現の最終判断は人間が行います。
人間が判断したこと
人間が判断したのは、内部リンクを主導線にし、外部リンクを補助導線にすることです。内部ページがない場合は非リンクにし、404を出さないことを優先します。href確認まで報告させるとレビューしやすくなります。
人間の役割は、作業の目的、公開してよい情報、停止条件、最終確認の基準を決めることです。Codexの報告は重要な材料ですが、公開判断やサイト全体の方向性は人間が確認します。
実際に使った指示文の考え方
指示文では、目的、対象ページ、変更してよいファイル、触らないファイル、禁止事項、停止条件、確認項目、報告書形式を分けます。長い指示文でも、項目が分かれていればレビューしやすくなります。
今回のような運用改善系では、作業結果だけでなく「次に使える形に残す」ことが大切です。チェックリストやテンプレートを記事内に残すことで、似た作業を始める時の迷いを減らせます。
うまくいった点
うまくいった点は、作業の目的と確認項目を分けて扱えたことです。Codexに実装だけを任せるのではなく、確認対象、停止条件、報告形式まで渡したことで、報告書を読み返した時に判断しやすくなりました。
また、公開HTML、実画面、リンク先、触っていないファイルを分けて確認したことで、単なる作業完了ではなく、公開中サイトとして見てもよい状態かを確認できました。
詰まった点・危なかった点
危なかった点は、確認項目が曖昧だと「作業しました」という報告だけで進んでしまうことです。実装済み、調査済み、公開確認済みは別の状態なので、報告書では分けて書かせる必要があります。
特に公開中サイトでは、本文やカードの修正に見えても、SEOタグ、広告タグ、内部リンク、CSS、sitemapへ影響する場合があります。触らないファイルと停止条件を最初に書くことで、作業範囲の広がりを抑えられます。
作業後に確認したこと
作業後は、対象ページのHTTP 200、title、description、canonical、robots、noindexなし、CSS読み込み、関連ページへの内部リンク、スマホ表示を確認します。
さらに、公開HTMLに対象文言やリンクが出ているか、実画面で読めるか、クリック先が想定通りか、触っていないものが報告書に残っているかを確認します。ここまで見て、初めて実務上の完了に近づきます。
次から使える指示文テンプレート
次のような指示文にしておくと、Codexの作業報告を確認しやすくなります。
以下の公開中サイトで、内部リンク改善を行ってください。
カード内のサムネイル、タイトル、詳しく見るボタン、外部リンクのhrefを分けて確認してください。
内部詳細ページがある場合は、サムネイル、タイトル、詳しく見るボタンを内部詳細ページへ向けてください。
内部詳細ページがない場合は、無理に内部リンクを出さず、404リンクを避けてください。
外部リンクは削除せず、補助導線として残してください。
作業後に、公開HTML上のhrefと実画面でのクリック先を確認して報告してください。確認チェックリスト
作業後は、次の項目を確認します。チェックリストは作業内容によって増減しますが、公開HTML、実画面、リンク先、触っていない範囲は毎回見たい項目です。
- サムネイルhref確認
- タイトルhref確認
- 詳しく見るhref確認
- 外部リンクhref確認
- 内部ページがある場合だけリンク
- 内部ページがない場合は非リンク
- 外部リンクは補助導線
- 404リンクなし
- 公開HTML確認
- 実画面確認
注意書き
この記事は、実際の作業を一般化してまとめた実践ログ型ガイドです。具体的な案件名、内部情報、サーバーパス、秘密情報は掲載していません。
Codexや関連サービスの仕様は変わる可能性があります。作業対象サイトのルール、最新の公式情報、公開前チェックを確認し、最終判断は人間が行ってください。