今回やった作業
Codex作業報告に、変更したファイルだけでなく、触っていないファイルやシステム要素を明記させた流れを一般化します。何を変えたかと同じくらい、何を変えていないかも重要です。
今回の作業では、表示や本文を改善するだけでなく、触らないものを守ることを重視しました。公開中サイトでは、SEOタグ、広告タグ、DB、cron、設定ファイルを意図せず変更すると、本文修正以上に大きな影響が出ることがあります。
作業前の状態
作業前は、記事やCSS、sitemapなどを変更する作業でした。DBやcron、.htaccess、robotsなどは触る予定がありませんでした。しかし報告書で対象外が明記されていないと、本当に触っていないか分かりにくい状態でした。
作業前の段階では、作業対象と対象外を分ける必要がありました。Codexに任せる範囲を明確にしないと、目的達成のために周辺ファイルまで触る可能性があります。特にhead内タグ、広告script、設定ファイル、DBやcronは通常作業から切り離して扱う方が安全です。
作業前に問題だったこと
Codex作業では、意図しないファイル変更や作業範囲の広がりが起きることがあります。変更ファイルだけを見ても、設定ファイルや広告タグを触っていないか判断しにくいことがあります。触っていない範囲を報告書に残すと、あとから事故原因を切り分けやすくなります。
Codex作業で大事なのは、作業を進めることだけではありません。何を変更しないか、どこで停止するか、変更していないことをどう報告するかを先に決めることで、レビューしやすくなり、事故の切り分けもしやすくなります。
Codexに任せたこと
Codexには、変更ファイル一覧、作成ファイル一覧、触っていないファイル一覧、DB変更なし、cron変更なし、.htaccess変更なし、robots、ads.txt、広告タグ維持確認、報告書への明記を任せました。
あわせて、公開HTMLで確認できるものは公開HTMLで確認し、変更ファイル、作成ファイル、触っていないファイルを報告書に分けて書くようにしました。確認していないものは確認済みと書かず、必要になった場合は停止して報告する条件も入れました。
人間が判断したこと
人間側では、触っていないものを報告書の固定項目にすること、DBやcronは通常作業で触らないこと、広告タグやSearch Consoleタグも触らないこと、後から確認できるように報告に残すことを判断しました。
人間側で判断するのは、作業の範囲と停止条件です。Codexは実ファイル確認や公開HTML確認に向いていますが、広告タグやDB、cron、設定ファイルを触ってよいかどうかは、人間が先に決める必要があります。
実際に使った指示文の考え方
指示文では、変更してよいファイル、触らないファイル、禁止事項、停止条件、報告書形式を先に書きました。特に、canonical、robots、AdSenseタグ、Search Console確認タグ、DB、cron、.htaccess、robots.txt、ads.txtは触らない対象として明示しました。
うまくいった点
うまくいった点は、変更内容だけでなく維持確認を報告に入れたことです。何を変えたかだけでなく、何を変えていないかが分かると、後から確認する人が安心して差分を読めます。安全確認の項目を固定化すると、次回以降のCodexオーダーにも使い回せます。
詰まった点・危なかった点
- 変更してよい範囲を書かない
- 触らないファイルを書かない
- head内のタグ維持を確認しない
- DB変更なしを報告しない
- 広告タグ変更なしを報告しない
危なかったのは、作業対象外を明記せずに進めてしまうことです。本文修正やカード改善のつもりでも、テンプレートやheadに触るとSEOタグや広告タグへ影響する可能性があります。禁止事項は細かいほど安心材料になります。
作業後に確認したこと
作業後は、公開URLが200 OKであること、canonicalが自己URLであること、robotsがindex,followであること、noindexメタがないこと、広告タグが維持されていること、DBやcronや設定ファイルを変更していないこと、報告書に触っていないものが明記されていることを確認します。
次から使える指示文テンプレート
以下は、SEOタグ維持や禁止事項をCodexへ明確に渡す時に使えるテンプレートです。
作業後の報告書では、変更したファイルだけでなく、触っていないファイルも必ず明記してください。
特に、DB、cron、.htaccess、robots.txt、ads.txt、AdSenseタグ、Search Console確認タグ、問い合わせフォーム、メール設定、WordPress本体、DNS、Git設定を触っていないか確認してください。
変更していない場合は「触っていないもの」として報告してください。確認チェックリスト
安全確認では、変更したことと変更していないことを分けて見ることが重要です。
- 変更ファイルが明記
- 作成ファイルが明記
- 触っていないファイルが明記
- DB変更なし
- cron変更なし
- .htaccess変更なし
- robots.txt変更なし
- ads.txt変更なし
- 広告タグ変更なし
- Search Consoleタグ変更なし
関連する使い方ガイド
注意書き
この記事は、実際の作業を一般化してまとめた実践ログ型ガイドです。具体的な案件名、内部情報、サーバーパス、秘密情報は掲載していません。
安全確認は、作業を止めるためではなく、作業範囲を明確にして公開後の事故を減らすためのものです。必要な変更が出た場合は、通常作業に混ぜず、別オーダーとして扱う方が安全です。