Codexでランキングページを直す前にORDER BYを確認した実践ログ

今回やった作業

ランキングページを直す時、最初に見た目を変えると、表示文言と実際の並び順がずれることがあります。先にORDER BYと指標を確認することで、ランキング表現の土台を整えます。

今回の作業では、ランキング型サイトの見た目だけを整えるのではなく、ランキングとして成立する根拠を確認することを優先しました。カード一覧、順位表示、指標、並び順、内部導線を分けて確認し、Codexへの指示も「見た目を直して」ではなく、完了条件を確認する形にしました。

作業前の状態

カード一覧は存在していて、ページとしてはランキングに見せたい状態でした。ただし、実際に何順で並んでいるのか、画面上の説明とデータ取得部分が一致しているのかが曖昧でした。順位らしい見た目を足しても、ORDER BYが不明なままだと、読者にはなぜその順番なのか伝わりません。

この段階で重要だったのは、画面に出ている見た目と、裏側で実際に行われている並び替えや表示条件を分けて考えることです。見た目だけがランキング風でも、データの根拠や内部リンクが弱い場合、読者が比較できるページにはなりません。

作業前に問題だったこと

ランキングは、なんとなく上から並んでいるだけでは成立しません。何の指標で並んでいるのか、その指標が画面に出ているのか、説明文と実際の並び順が一致しているのかを確認する必要があります。この3つがずれると、ページの信頼性も、内部で比較する意味も弱くなります。

ランキング改善では、カードを大きくしたり、色を付けたり、順位バッジを足したりする前に、何を基準に順位が決まっているかを見る必要があります。ここを飛ばすと、Codexの作業報告では完了しているように見えても、実画面では根拠が伝わらない状態になります。

Codexに任せたこと

Codexには、対象ページの実ファイル、データ取得部分、SQLまたは並び替え処理、ORDER BY、画面に出している順位や指標、公開HTML上の表示文言を確認させました。修正より先に調査をさせたのがポイントです。

Codexには、修正そのものだけではなく、調査と確認も任せます。対象ファイル、公開HTML、表示文言、内部リンク、既存のcanonicalやrobotsを確認させることで、余計なファイルに触らず、必要な範囲だけを見られるようにします。

人間が判断したこと

人間側では、見た目より先に並び順の根拠を確認すること、ORDER BYが不明なままランキング表現を強めないこと、指標が弱い場合はランキングではなく一覧や注目候補のように表現を弱めることを判断しました。

Codexはファイルや表示を確認できますが、どの表現を使うべきか、どこまでをランキングと呼ぶべきか、読者に誤解を与えないかは人間が判断します。ランキング表現は便利なぶん、指標や並び順と一致しているかを人間側でも見ます。

実際に使った指示文の考え方

指示文では「ランキングっぽくして」ではなく、「現在のORDER BY、表示指標、説明文との一致を確認して」と指定します。Codexに先に調査させ、根拠がある場合だけ表示改善へ進める流れにします。

指示文では、やることだけでなく、やらないことも明記します。DB構造、cron、.htaccess、robots.txt、ads.txt、広告タグ、Search Console確認タグは触らないと書くことで、ランキング表示の調整が不要な範囲へ広がらないようにします。

うまくいった点

見た目の修正前に並び順を確認したことで、ランキング表示の根拠を曖昧にしたまま改修するリスクを避けられました。表示文言を強める前に、実際のデータと画面の関係を見る流れを作れた点がよかったです。

作業を完了条件に分解したことで、Codexの報告を確認しやすくなりました。順位、指標、並び順、公開HTML、実画面確認のように項目を分けると、どこまでできていて、どこが未確認なのかが見えやすくなります。

詰まった点・危なかった点

危なかったのは、順位バッジや強調表示だけを先に足してしまうことです。ORDER BYが分からないまま人気ランキングやおすすめ順位のように見せると、根拠不明の表示になります。

• 見た目だけを先に変える
• 順位や指標の根拠を確認しない
• 公開HTMLを見ずに完了扱いにする
• canonicalやrobotsを不用意に触る
• 内部リンクのクリック先を確認しない

ランキング系の作業は、見た目の変化が分かりやすいため、ついCSSやカード装飾から入りがちです。しかし、根拠や指標がないまま装飾すると、ページの説明力は上がりません。

作業後に確認したこと

作業後は、公開HTMLで順位や指標が見えるか、説明文と並び順が矛盾していないか、canonicalやrobotsが変わっていないかを確認します。DB構造やcronには触れず、まず表示と説明の整合性を見る範囲に留めます。

さらに、対象ページが200 OKであること、CSSが読めていること、Fatal errorや500がないこと、スマホ表示で大きく崩れていないこと、内部リンクが404になっていないことも確認します。記事化する場合は、実ドメイン名や内部情報を出さないように一般化します。

次から使える指示文テンプレート

以下は、同じ種類のランキング改善をCodexへ依頼する時に使えるテンプレートです。

以下の公開中サイトで、ランキングページを修正する前に、現在の並び順とORDER BYを確認してください。
対象ページの実ファイルを確認し、データ取得部分、SQL、ORDER BY、画面に出している順位や指標、説明文との一致を確認してください。
ランキングと呼ぶには、何の指標で並んでいるか、画面上にその指標が出ているか、表示順と説明文が一致しているかが必要です。
ORDER BYが不明な場合や指標がない場合は、ランキング表現を強めず、まず調査結果を報告してください。
DB構造の変更、cron変更、.htaccess変更、robots.txt変更、ads.txt変更、広告タグ変更はしないでください。

確認チェックリスト

作業後は、見た目だけでなくランキングとして成立しているかを確認します。

• SQLを確認した
• ORDER BYを確認した
• 何順か説明できる
• 表示文言と並び順が一致している
• 根拠不明な人気ランキングにしていない
• 順位指標が画面に出ている
• 公開HTMLで表示を確認した
• DB変更をしていない
• 既存のcanonical / robotsを変えていない

関連する使い方ガイド

注意書き

この記事は、実際の作業を一般化してまとめた実践ログ型ガイドです。具体的な案件名、内部情報、サーバーパス、秘密情報は掲載していません。

ランキング型サイトの改善では、表示文言、指標、並び順、内部導線が一致しているかを確認することが重要です。Codexに任せる場合も、作業範囲と停止条件を先に決めてから進めます。