Codex実践会 120分 — 実際の仕事で使う

この資料でわかること

• Project、Thread、Local、Worktree、Cloudを使い分けられる
• AGENTS.mdと設定ファイルの役割を分けられる
• 繰り返す作業をskillにまとめられる
• plugin、MCP、appsを必要な時だけ選べる
• hooks、rules、automationsで安全確認と定期作業を組める
• 差分、テスト、ブラウザ、本番URLで完了を確認できる

動画で全体を見る

まず結論

順番に理解する本文

1. 仕事の場所を分ける

基本は「1事業1Project、1目的1Thread」です。迷ったらLocalで小さく試し、大きな変更だけWorktreeへ分けます。

2. 見せる資料、成果物、秘密情報を分ける

C:\VSCode\Project\
  ai-hub\
    AGENTS.md                 # 毎回守るルール
    .codex\
      config.toml             # Codexの設定
      hooks.json              # 自動チェック
      rules\default.rules     # コマンドの許可・確認・禁止
    .agents\skills\
      lecture-builder\SKILL.md
      publish-check\SKILL.md
    content\
      lectures\               # 編集する原稿
      assets\                 # 画像、PDF、動画
    docs\operations\         # 運用手順
    outputs\reports\         # 定期出力
    site\dist\               # ビルドした成果物
    .env                      # 秘密情報。共有・コミットしない

成果物の置き場を先に決めると、後から探しやすくなります。.env、APIキー、顧客情報は、必要な範囲だけ権限を確認して扱います。

3. 指示を置く場所を分ける

4. まずAGENTS.mdで共通ルールを決める

AGENTS.mdには、次の5項目があれば十分です。

1. このプロジェクトの目的
2. 触ってよい場所と、触らない場所
3. ビルド、テスト、プレビューの方法
4. 公開や外部送信の前に確認すること
5. 完了報告に書くこと

個人の話し方の好みは個人設定へ、プロジェクトの必須ルールはAGENTS.mdへ置きます。

5. 同じ作業はskillにする

skillは、Codexが必要な時に読む再利用できる手順書です。1つのskillに多くの仕事を詰めず、「受講資料を作る」「公開前に確認する」のように1作業へ絞ります。

6. 外部サービスが必要になったらplugin、apps、MCPを選ぶ

• plugin: skills、apps、MCPなどをまとめた仕事別の道具箱
• app / connector: GitHub、Gmail、Google Driveなどの認証済みサービス
• MCP: 外部の道具や情報をCodexにつなぐ共通の接続方法

OpenAIのロール別プラグインには、Data analytics、Creative production、Sales、Product design、Public equity investing、Investment bankingがあります。名称から選ぶのではなく、任せたい仕事に合うものだけ使います。

7. hooksとrulesで安全枠を追加する

hookは、作業前後に自動で動くチェック係です。ruleは、外部へ影響するコマンドを許可、確認、禁止に分ける門番です。

8. 「作った」ではなく「確認できた」で完了にする

確認は次の順で行います。

1. 変更差分を読む
2. 必要なビルドとテストを行う
3. PC幅とスマホ幅で画面を見る
4. リンク、フォーム、画像、エラー表示を確かめる
5. 公開作業なら、推測せず実際の本番URLを開く
6. 別の視点で公開前レビューを行う

Review paneは差分を見る画面です。Inline commentsは、差分の行を指して修正を頼む機能です。Stageは採用候補に入れる、Revertは変更を戻す操作です。

9. 手作業で成功した後にautomationへ移す

automationの結果はTriageという受信箱で確認します。最初に手動で1回成功させ、入力、判断基準、報告先が決まってから自動化します。

具体例 / やってみる

演習1: 今のプロジェクトを整理する

演習2: どこにルールを置くか分ける

演習3: 公開前レビューを行う

演習4: automationを設計する

120分の進め方

振り返り / 次の一歩

• 1事業1Project、1目的1Threadで分けた
• Local、Worktree、Cloudの使い分けを決めた
• 秘密情報と成果物の置き場を分けた
• AGENTS.mdに毎回のルールを残した
• 繰り返す作業を1つskillにした
• 必要な外部接続だけを選んだ
• hookとruleの役割を分けた
• 差分、テスト、画面で確認した
• 本番作業は実際のURLで確認した
• 手動で成功した作業だけ自動化した

必要になってから見る機能

公式情報の確認先

Xは速報、Changelogは仕様変更、Feature Maturityは本番利用の判断に使います。機能名や設定は更新されるため、実行時点の公式文書を確認してください。