Codexに完了と言わない条件を
指定した実践ログ

今回やった作業

Codexに作業を頼む時は、何を満たせば完了かだけでなく、どの状態なら完了と言わないかも重要です。今回の実践ログでは、順位が見えない、内部リンクがない、指標がない、公開HTMLに出ていない場合は完了と言わない条件を指定した流れをまとめます。

今回の作業では、Codexの作業報告をそのまま完了扱いにせず、公開URL、公開HTML、HTTPステータス、エラー文字列、確認したURL一覧を使って裏取りしました。公開中サイトでは、ローカルやファイル上の変更と、ユーザーが見る公開ページが一致しているとは限らないためです。

作業前の状態

作業前は、Codexが「完了」と報告しても、実画面では見えない、リンク先が想定と違う、順位や指標が不足している、といった状態が起こり得ました。完了条件だけでなく、未完了条件が必要でした。

作業前の問題は、実装したつもり、確認したつもり、完了したつもりが混ざりやすいことでした。特に公開HTML、Fatal error、SQLSTATE、代表URLの確認範囲は、指示文で明確にしておかないと報告から抜けやすくなります。

作業前に問題だったこと

作業指示でやることだけを書くと、Codexが最低限の変更で完了報告してしまうことがあります。しかし、ユーザーに見えない、リンク先が違う、根拠がない、公開HTMLに出ていない状態では、実務上は完了とは言えません。

Codex作業では、作成・変更・調査・公開反映・実画面確認が別の段階です。どこまで終わっているかを分けて見ないと、公開ページで見えない状態や500エラーを見逃します。完了条件だけでなく、完了と言わない条件も必要です。

Codexに任せたこと

Codexには、完了条件、未完了条件、順位表示、内部リンク、指標、公開HTML、実画面、報告書での完了判断を確認させました。未確認事項がある場合は、未確認と書かせることも重要です。

Codexには、対象URLの取得、公開HTMLの確認、grep対象の確認、HTTP 200、Fatal errorなし、SQLSTATEなし、sitemap.xml、robots.txt、関連ページの確認を任せます。確認したURLを報告書に残すことで、後から確認範囲を追えるようにします。

人間が判断したこと

人間側では、見えない場合は完了にしないこと、クリック先が違えば完了にしないこと、指標がなければランキング改善として完了にしないこと、公開HTMLに出ていなければ完了にしないことを判断しました。

人間が判断するのは、公開確認の範囲と完了扱いにする基準です。全ページ確認が必要なのか、代表URLでよいのか、エラーが出た時に停止するのか、未確認事項をどう扱うかは、人間が先に決めてCodexへ渡します。

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

指示文では、「確認して」だけではなく、何を確認するかを具体化します。公開HTMLで見る文言、リンク、class、HTTPステータス、Fatal error、SQLSTATE、確認したURL、未確認範囲を報告対象にします。DB、cron、.htaccess、robots.txt、ads.txt、広告タグ、Search Console確認タグには触らないことも明記します。

うまくいった点

うまくいった点は、報告と実態を分けられたことです。Codexの「実装済み」や「完了」という言葉だけではなく、公開HTML上の証拠、HTTP 200、エラー文字列なし、確認URL一覧で裏取りできるようになりました。

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

• ファイル変更だけで完了扱いにする
• 公開HTMLを確認しない
• HTTP 200を確認しない
• 確認したURLを報告しない
• 未確認範囲を隠す

危なかったのは、ファイル上の変更で満足してしまうことです。公開HTMLに出ていない、HTTPが200ではない、Fatal errorが出ている、確認範囲が曖昧という状態では、公開作業としてはまだ不十分です。

作業後に確認したこと

作業後は、対象ページが200 OKであること、Fatal errorやSQLSTATEがないこと、公開HTMLに対象文言やリンクがあること、canonicalとrobotsが維持されていること、noindexが入っていないこと、CSSが読み込まれていることを確認します。

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

以下は、公開確認や完了条件をCodexへ依頼する時に使えるテンプレートです。

以下の作業では、完了条件だけでなく、完了と言わない条件も守ってください。

順位が画面に見えない場合、順位指標がない場合、内部詳細ページへのリンクがない場合、クリック先が想定と違う場合、公開HTMLに対象文言が出ていない場合は、完了と言わないでください。

その場合は、未完了の理由、足りない要素、次に確認すべきことを報告してください。

完了報告をする場合は、公開URL、公開HTML、実画面、リンク先を確認した結果を報告してください。

確認チェックリスト

公開確認は、確認したURLと確認内容を残すことが大切です。

• 完了条件あり
• 未完了条件あり
• 見えない場合は完了にしない
• クリック先が違えば完了にしない
• 根拠がなければ完了にしない
• 指標がなければ完了にしない
• 公開HTMLに出ていなければ完了にしない
• 未確認事項を明記した
• 完了報告に確認結果がある

関連する使い方ガイド

注意書き

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

公開確認では、Codexに任せる確認作業と、人間が判断する完了基準を分けることが重要です。確認していないことは未確認と書き、見えていないものを完了扱いにしない運用にします。