社内の手順書や README は、書いた直後がいちばん正しく、あとは少しずつずれていきます。システムの画面が変わった、コマンドの名前が変わった、設定の項目が増えた。そのたびに文書を直すのが理想ですが、開発の忙しさに押されて後回しになりがちです。気づいたときには「手順書のとおりにやると動かない」という状態になり、新しく入った人が最初につまずきます。
Codex はこの「動きに文書を追いつかせる」仕事を手伝えます。この記事では、社内の手順書や README の更新を Codex に任せるときの頼み方と、反映する前の確かめ方を、手順の順番に整理します。製品の動きに関わる内容は、2026年11月4日に OpenAI の公式ドキュメント(Keep documentation up-to-date・Best practices・Agent approvals & security)で確かめた範囲に絞りました。
結論: いきなり「文書を直して」と頼まず、まず「どの文書のどこが今の動きとずれているか」を洗い出させます。次に、今の構成・用語・リンクを変えずに必要な箇所だけ直させ、手順書のコマンドを試す・リンクを確かめるといった確認を通してから人が読んで反映します。繰り返し書く決めごとは AGENTS.md に移し、手作業で型が固まってから定期的な見直しに移します。
なぜ文書の更新は Codex に向いているのか
公式ドキュメントでは、文書の更新を Codex に任せる使い方を次のように説明しています。Codex はソースコードの変更・公開している文書・リリースノート・Pull Request の内容を見比べ、変更点に絞った文書の更新を、公開前に確かめる手順とあわせて下書きします。向いている文書として、開発者向けの文書・README・変更履歴の下書き・移行の手引き・運用手順書など、よく変わる動きに追いつく必要があるものが挙げられています。(出典: Keep documentation up-to-date)
人が文書を直すときに一番時間がかかるのは、文章を書くことよりも「どこが古くなったか」を探すことです。変更の記録と文書を1つずつ突き合わせる作業は、Codex が得意とする「材料を読んで比べる」仕事に当たります。人は、洗い出された箇所と直した文章が正しいかを確かめる役に回れます。
| 文書の種類 | Codex に任せやすい理由 | 人が必ず確かめること |
|---|---|---|
| README・導入手順 | コマンドや設定の名前がソースコードにあり、突き合わせやすい | 書かれた手順を最初から実際に試す |
| 運用手順書(ランブック) | 変更の記録から手順の変わった箇所を拾える | 本番に関わる操作の順番と注意書き |
| 変更履歴の下書き | Pull Request の内容から要点をまとめられる | 利用者に伝える範囲と表現 |
| 移行の手引き | 変更前と変更後を見比べて差分を書ける | 抜けている移行作業がないか |
| 社内の方針・判断の基準 | ソースコードから正しさを確かめられないため向かない | 人が書く |
最後の行が大切です。Codex が文書を正しく直せるのは、正しさを確かめる材料(ソースコード・変更の記録・実際に動く環境)があるときです。社内ルールや判断の基準のように材料がない文書は、Codex に任せても「それらしい文章」にしかなりません。
手順1: 対象の文書と材料を決める
最初に、どの文書を直すかと、何を根拠に直すかを決めます。範囲を広げすぎると、確かめる人の手が回らなくなります。試験導入の段階では「1つのリポジトリの README と、そのシステムの手順書1本」くらいから始めるのがおすすめです。
- 対象の文書を決める: 最近問い合わせが多い手順書や、新しく入った人がつまずいた README など、ずれの影響が大きいものから選ぶ
- 根拠になる材料を決める: 直近の Pull Request、リリースノート、変更したソースコードの範囲など。「先月から今日までにマージされた変更」のように期間で区切ると伝えやすい
- 触ってよい範囲を決める: 直してよいファイルと、触ってはいけないファイル(社外に出している文書、法務の確認が必要な文書など)を分けておく
- 確かめる人を決める: そのシステムを実際に運用している人を、確認の担当にする
材料の中に社外秘の情報や鍵が入っていないかも、このときに確かめます。鍵や環境変数を Codex に読ませない設定は鍵と環境変数を触らせない設定の記事にまとめています。
手順2: まず「ずれている箇所」を洗い出させる
いきなり「README を最新にして」と頼むと、Codex は文書全体を書き直しにかかることがあります。そうなると、どこが本当に変わったのかを人が確かめにくくなります。公式ドキュメントでも、まず影響を受ける文書を洗い出させ、今のページの構成・用語・相互リンクを保つよう頼むことが案内されています。(出典: Keep documentation up-to-date)
最初の依頼は、直させずに一覧を出させるだけにします。
先月1日から今日までに main にマージされた変更と、
docs/の手順書・リポジトリ直下の README を見比べてください。今の動きと合っていない記述を、ファイル名・見出し・該当の文・根拠になった変更の順に一覧にしてください。この段階ではファイルを編集しないでください。
一覧が出たら、人が目を通して「直す」「直さない」「人が判断する」に仕分けます。根拠になった変更が書かれているので、本当にずれているのかを短い時間で確かめられます。この一覧は、あとで定期実行に移すときの出力の型にもなります。
手順3: 構成と用語を変えずに直させる
仕分けが終わったら、「直す」と決めた箇所だけを直させます。ここでの指示のポイントは、直してほしい範囲と、変えてほしくないものをはっきり書くことです。
先ほどの一覧のうち、番号1・3・4だけを直してください。見出しの構成・用語の表記・ほかのページへのリンクは今のままにしてください。手順書に書くコマンドは、リポジトリにある実際の名前と引数に合わせてください。直した箇所ごとに、根拠になった変更を報告に書いてください。
| 指示に入れること | 理由 |
|---|---|
| 直す箇所の番号 | 一覧で「直す」と決めた範囲から広がらないようにする |
| 構成・用語・リンクを変えないこと | 読み慣れた人が迷わず、ほかの文書からのリンクも切れない |
| コマンドを実際の名前に合わせること | 手順書でいちばん困る「書いてあるとおりに動かない」を防ぐ |
| 直した箇所ごとの根拠 | 確かめる人が、変更と文書を自分で突き合わせられる |
社内で用語の表記を統一している場合(たとえば社名や製品名の書き方)は、その決めごとも指示に入れます。毎回書くのが手間になったら、手順5で AGENTS.md に移します。
手順4: 反映する前に確かめる
Codex が直した文書は、人が確かめてから反映します。公式ドキュメントでも、文書の更新は公開前に確かめる手順とあわせて下書きするものとされ、手元で動かせる文書の検査を用意しておくと、Codex にとっての「完了」の基準がはっきりすると説明されています。(出典: Keep documentation up-to-date)
確かめる順番は次のとおりです。
- 差分を読む: 一覧で決めた箇所以外が書き換わっていないか。見出しやリンクが変わっていないか
- 根拠と照らし合わせる: 報告に書かれた根拠の変更を開き、直した文と合っているか
- 手順を実際に試す: 手順書や README の手順を、新しく入った人と同じ条件で最初から試す。可能なら Codex にも試させ、その結果を報告させる
- リンクと書式を確かめる: リンク切れや表の崩れを検査する仕組みがあれば通す
- 担当者が読んで反映する: 普段のレビューの流れ(Pull Request のレビューなど)に乗せて取り込む
手順を Codex に試させるときは、どこまでの操作を許すかに注意します。公式ドキュメントでは、バージョン管理されたフォルダでの推奨の組み合わせは、作業フォルダ内の読み書きとコマンド実行は承認なしで行い、作業フォルダの外の編集やネットワークへの接続には承認を求める設定とされています。また、既定ではネットワークへの接続は無効です。(出典: Agent approvals & security)手順書に外部へ接続する操作や本番に関わる操作が含まれる場合は、Codex に試させず人が検証環境で試してください。設定の考え方はサンドボックスと承認ポリシーの記事にまとめています。Pull Request のレビューを Codex に手伝わせる方法はコードレビューをチームで使う記事で紹介しています。
手順5: 繰り返す決めごとを AGENTS.md に移す
数回回すと、毎回同じ注意を書いていることに気づきます。公式ドキュメントでは、リポジトリ全体に共通する文書の決めごとを AGENTS.md に書いておく方法が案内されています。(出典: Keep documentation up-to-date)また AGENTS.md は、ビルドやテストのコマンド、何をもって完了とするか、どう確かめるかなどを書いておく場所とされ、内容が大きくなったら作業ごとの別の Markdown ファイルに分ける方法も紹介されています。(出典: Best practices)
文書の更新について AGENTS.md に書いておくとよい項目の例です。
- 用語と表記: 社名・製品名・画面の名前の書き方
- 構成の決まり: 見出しの付け方、手順は番号付きで書くこと
- 変えてはいけないもの: ほかの文書からリンクされている見出し、社外に出している文書
- 確かめ方: リンクや書式の検査に使うコマンド
書き方の全体像はAGENTS.md の書き方の記事を参考にしてください。社内全体での使い方のルールは社内利用ガイドラインの作り方の記事で項目と例文を紹介しています。
手順6: 定期的な見直しに移す
手作業で回して、手順2の一覧が役に立つこと・手順4の確かめ方で漏れが見つかることが確かめられたら、定期的な見直しに移せます。公式ドキュメントには、最近の GitHub の Pull Request を取得して毎週文書を最新に保つ定期実行の例が紹介されています。(出典: Keep documentation up-to-date)
移すときは、いきなり「直して反映する」まで自動にしないことをおすすめします。まずは手順2と同じ「ずれている箇所の一覧を出す」だけを毎週回し、担当者が一覧を読んで直すかを決める形から始めます。一覧の精度が安定してから、直した下書きまで作らせる段階に進めます。どの段階でも、反映の前に人が読む流れは残してください。定期実行の設定方法は定期実行の設定ガイドにまとめています。
チームで回すときに決めておくこと
文書の更新は、担当がはっきりしないと誰も手を付けない仕事です。試験導入の段階で次の4つを決めておくと、部署に広げやすくなります。
- 文書ごとの持ち主: どの文書を誰が確かめて反映するか。持ち主がいない文書は対象にしない
- 頼み方の型: 手順2と手順3の依頼文を社内の手順書に載せて、人によるばらつきをなくす
- 確かめ方の基準: 手順を実際に試す文書と、差分を読むだけでよい文書を分けておく
- 記録: 見つかったずれの件数と、直すのにかかった時間を残しておくと、導入の効果を説明しやすくなります。記録のしかたは導入効果の測り方の記事で紹介しています
まとめ
社内の手順書や README の更新を Codex に任せるときは、まず「どこがずれているか」を一覧で出させ、人が仕分けてから、構成・用語・リンクを変えずに必要な箇所だけ直させます。直した文書は差分と根拠を照らし合わせ、手順を実際に試してから反映します。繰り返す決めごとは AGENTS.md に移し、手作業で型が固まってから一覧づくりを定期実行に移します。文書を書く手間よりも「古くなった箇所を探す手間」を Codex に任せる、という考え方が出発点です。
この記事の内容は、2026年11月4日時点の OpenAI 公式ドキュメントの記載に基づいています。機能の名前や画面の操作は変わることがあるため、使う前に最新の記載をご確認ください。デジライズでは、社内の文書や手順書の管理に Codex を組み込む手順づくりから、指示の型・社内ルール・現場向けの研修までを含めた Codex の法人導入支援のご相談を承っています。「まず1つのシステムの README で試したい」という段階からでもお問い合わせください。
- https://developers.openai.com/codex/use-cases/update-documentation
- https://developers.openai.com/codex/learn/best-practices
- https://developers.openai.com/codex/agent-approvals-security
確認日:2026年11月4日。提供条件・機能・料金は変更されるため、最新情報は各公式ページをご確認ください。
デジライズの実績はデジライズ全体の社内集計値です。Codex の機能・対応環境・料金・提供条件は記事の公開・更新時点の OpenAI 公式情報に基づき、変更される場合があります。導入効果は企業や業務によって異なります。



