読み方の1ポイント
目的、対象、確認項目を分けて読む
このページでは、Codex作業を安全に進めるための考え方を整理します。実行前に、対象、触らないもの、確認項目を分けて見ると迷いにくくなります。
このページも、全部を一度に覚えないとダメ?
必要なところから読めば大丈夫です。作業前に対象と停止条件、作業後に確認項目を見ると安全です。
今回やった作業
カードに複数のボタンがある時、「詳しく見る」は内部詳細ページへ進む主導線として使いやすい要素です。今回の実践ログでは、外部リンクばかりが目立つ状態を避け、内部で比較してから外部へ進める導線に整理した考え方をまとめます。
今回の作業では、カードの見た目を大きく作り替える前に、ユーザーがクリックする場所を分解して確認しました。サムネイル、タイトル、詳しく見るボタン、外部確認リンクは、同じカード内にあっても役割が違います。どのリンクを主導線にし、どのリンクを補助導線にするかを決めることで、ランキング型ページや情報メディアの回遊が分かりやすくなります。
作業前の状態
作業前は、カード内の外部確認リンクが目立ち、内部詳細ページへ進む導線が弱く見える状態でした。「詳しく見る」という文言があっても、そのリンク先が内部なのか外部なのか、また詳細ページが存在するのかが明確ではありませんでした。ユーザーはカードを見た直後に外部へ出やすく、サイト内で比較・確認する流れが育ちにくい状態です。
特に注意したのは、クリックできる場所が多いほど、ユーザーが次に何をすればよいか迷いやすくなる点です。カードが並んでいるだけでは、サイト内で比較するページなのか、外部へ送る入口なのかが曖昧になります。リンク先の役割を確認せずにボタンだけ整えると、導線の問題は残ったままになります。
作業前に問題だったこと
ランキング型サイトでは、一覧ページだけで判断するのではなく、内部詳細ページで理由や関連情報を確認できることが重要です。外部リンクが主導線になりすぎると、サイト内の説明を読む理由が弱くなります。「詳しく見る」ボタンは、内部詳細ページへの入口として意味づけしやすいので、リンク先と文言を一致させる必要があります。
内部リンクを強める作業では、リンクを増やすこと自体が目的になりがちです。しかし、存在しない内部ページへリンクすれば404になりますし、外部リンクを強く出しすぎればサイト内の比較導線が弱くなります。つまり、リンク確認では、href、リンク先の存在、ボタン文言、クリック後の体験をまとめて確認する必要があります。
Codexに任せたこと
Codexには、「詳しく見る」ボタンのhref、内部詳細ページの有無、外部リンクとの配置、ボタン文言、公開HTML上のhref、クリック先の確認観点を整理させました。見た目のボタン修正だけではなく、サムネイルやタイトルのリンク先も合わせて確認させています。
Codexには、現在のファイル構造と公開HTMLを見比べる役割を任せました。作業報告だけではなく、実際にHTML上でどのhrefが出ているか、内部ページが存在するか、公開URLが200 OKか、リンクを追加したことで別のページへ混入していないかを確認させます。見た目の修正だけに寄せず、導線の確認まで含めるのが安全です。
人間が判断したこと
人間側では、「詳しく見る」は内部詳細ページへの主導線にすること、外部リンクは削除せず補助導線として残すこと、内部詳細ページがないカードは無理にリンクしないことを判断しました。ボタンの文言も、クリック先の役割と一致するようにしています。
人間が判断するのは、リンクの正しさだけではありません。ユーザーにどの順番で読んでもらいたいか、外部リンクをどの程度目立たせるか、内部詳細ページがないカードをどう扱うかも判断対象です。Codexは確認と実装に向いていますが、サイト内での読ませ方や公開してよい導線の設計は人間が決めます。
実際に使った指示文の考え方
指示の考え方としては、「ボタンを追加して」ではなく、「詳しく見るボタンの役割を内部詳細ページへの主導線として確認して」と伝えることが重要です。外部リンクを残すこと、404を避けること、公開HTMLと実画面で確認することまで指定すると、作業後のズレを減らせます。
この種の作業では、「リンクを追加して」だけでは不十分です。どの要素のhrefを見るのか、内部詳細ページがある場合とない場合をどう分けるのか、外部リンクを消すのか残すのか、公開HTMLと実画面のどちらを確認するのかまで指示します。停止条件として、404リンクが出そうな場合や、存在しないページへのリンクが必要になりそうな場合は作業を止めるようにします。
うまくいった点
うまくいった点は、ユーザーがどこから内部詳細ページへ進めばよいか分かりやすくなったことです。外部リンクも残したため、情報確認の出口を失わず、サイト内比較を優先する導線に寄せられました。
リンク導線を分解したことで、カード一覧の改善が見た目だけの話ではなくなりました。内部詳細ページへ進む導線、外部で確認する導線、リンクを出さない判断を分けられるようになり、公開前チェックでも確認しやすい状態になります。
詰まった点・危なかった点
危なかった点は、外部リンクを弱めるつもりで消しすぎてしまうこと、または内部詳細ページがないのに「詳しく見る」を出して404へつなげてしまうことです。ボタン文言が分かりやすくても、リンク先が存在しなければ導線としては失敗です。
- hrefを見ずに見た目だけで完了扱いにする
- 内部ページがないのにリンクを出す
- 外部リンクを主導線にしすぎる
- 公開HTMLではなく作業報告だけで判断する
- 実画面でクリック先を確認しない
カード一覧のリンク修正は小さな変更に見えますが、hrefを間違えるとユーザーの移動先が変わります。特に、内部ページがないカードを無理にリンク化すること、外部リンクを主導線にしすぎること、実画面クリックを確認しないことは避けたいポイントです。
作業後に確認したこと
作業後は、「詳しく見る」が内部リンクになっているか、外部リンクより主導線として自然に見えるか、リンク先が200 OKかを確認します。公開HTMLでhrefを見たうえで、実画面でもクリック先を確認するのが安全です。
あわせて、対象ページが200 OKであること、canonicalとrobotsが変わっていないこと、noindexが入っていないこと、CSSが読めていること、スマホ表示でカードやボタンが崩れていないことも確認します。リンク導線の作業でも、SEOタグや公開状態の確認を省かないことが重要です。
次から使える指示文テンプレート
以下は、同じようなリンク導線整理をCodexへ依頼する時に使えるテンプレートです。
以下の公開中サイトで、カード一覧の「詳しく見る」ボタンの役割を確認してください。
「詳しく見る」ボタンは、内部詳細ページがある場合は内部ページへの主導線にしてください。
外部リンクは削除せず、補助導線として残してください。
サムネイル、タイトル、詳しく見るボタン、外部リンクのhrefを分けて確認し、公開HTMLと実画面の両方でリンク先を確認してください。
内部詳細ページが存在しない場合は、無理にリンクを作らず、404を避けてください。
確認チェックリスト
作業後は、リンクを追加したかどうかではなく、クリック先と役割が合っているかを確認します。
- 詳しく見るが内部リンクになっている
- 外部リンクより先に見える
- ボタン文言が分かりやすい
- 404にならない
- 外部リンクは補助として残している
- サムネイルhrefを確認した
- タイトルhrefを確認した
- 公開HTMLでhrefを確認した
- 実画面でクリック先を確認した
関連する使い方ガイド
注意書き
この記事は、実際の作業を一般化してまとめた実践ログ型ガイドです。具体的な案件名、内部情報、サーバーパス、秘密情報は掲載していません。
リンク先の確認は、作業報告だけで完了扱いにせず、公開HTMLと実画面の両方で確認することを前提にしています。Codexに任せる部分と、人間が導線の意味を判断する部分を分けることで、404や不自然な外部誘導を避けやすくなります。


