Codexを「会話」ではなく
「作業環境」として使う

1. この講座で扱うこと

ChatGPTなどのAIを使ったことがある人に向けて、Codexならではの作業の進め方を説明する。

2. Codexでできること

Codexの本質は、AIとの会話そのものではなく、会話を通じてPC上の作業を進められることにある。

3. Codexを使い始める

最初から高度な指示を書く必要はありません。まず、CodexまたはClaudeを利用できる環境を用意し、作業場所を決め、ファイルを一つ扱うところから始めます。

3-0. 利用環境を用意する

プランの名称や料金は変わるため、契約前に各サービスの公式情報を確認する。講座では特定のプランを一律に推奨せず、用途に応じて選ぶ考え方を扱う。

3-1. プロジェクトフォルダを用意する

ai-agent/
├── AGENTS.md
├── input/
│   ├── 参考資料.pdf
│   └── 会議メモ.docx
└── output/
    └── 完成物.html

3-2. Codexに最初の依頼をする

このプロジェクトのファイル構成を確認してください。
inputフォルダにある資料の一覧と、それぞれ何に使えそうかを整理してください。
まだファイルの編集はせず、まず確認結果だけ説明してください。

最初に「確認だけ」と伝えると、Codexが何を読んだかを把握してから次の作業に進められる。

3-3. CodexがPC上で行うこと

4. AGENTS.mdとは何か

AGENTS.mdは、プロジェクトごとの「Codex向け作業ルール」を書くMarkdownファイル。Codexはプロジェクト内のこのファイルを読み、そこに書かれた条件を前提として作業する。

ここに書くとよいこと

見本

# このプロジェクトの作業ルール

## 目的
社内で確認・共有するHTML資料を作成する。

## ファイル
- 読み込む資料はinputフォルダに置く
- 完成物はoutputフォルダに保存する
- 既存ファイルを上書きする前に、変更内容を説明する

## 品質
- 数値は元データを確認し、推測で補わない
- 不明点は不明点として示す
- HTMLはPCとスマートフォンの両方で確認する

## 表現
- 読み手が次の判断をできるように書く
- 抽象的な表現ではなく、何がどう変わるかを書く

5. Skillsとは何か

Skillは、特定の作業を再現しやすくするための手順・判断基準・テンプレート・参考資料のまとまり。Codexに専門的な作業の進め方を覚えさせるための仕組みとして使える。

Skillにまとめる内容

1. 作業の開始条件と、必要な入力資料
2. 作業の順番と、途中で判断するポイント
3. 品質チェックと、よくある失敗
4. 完成物の形式・保存場所・命名方法
5. 必要なテンプレートや参考資料

Skillは、既存のものを参照して使うことも、自分の業務で確立した手順をもとに作ることもできる。レポート作成、広告分析、議事録整理、提案書作成などに応用できる。

6. GistとHTML共有

6-1. Gistとは何か

GitHub Gistは、コードやテキストなどの小さなファイルをGitHub上に保存するサービス。HTMLファイルを置き、Raw URLをhtmlpreviewに渡すと、ファイルの中身ではなく、レポートとしてブラウザに表示できる。

6-5. 社内共有での使い分け

6-2. 使えるようになるまで

6-3. 共有URLの形

https://htmlpreview.github.io/?https://gist.githubusercontent.com/ユーザー名/Gist ID/raw/バージョン/report.html

Gistを更新した場合は、Raw URLの内容が最新版になっているかを確認してから共有する。表示されない場合は、HTMLが単一ファイルになっているか、外部画像や外部CSSのリンクが切れていないかを確認する。

6-4. 実例

7. ていねい通販の実例

Codexに依頼した内容は、短い指示から始まり、必要に応じて追加指示を重ねる形だった。Codexが一度で全部を決めるのではなく、成果物を見ながら方向を調整できる。

/Users/shoudaiyamamoto/Projects/ai-agent/input/202607301008_cv_attr.csv

これの分析をしてほしい。
_Mとついている広告がうち（マテリアルデジタル）が運用代行しているもの、それ以外はインハウス
知りたいのは、うちの広告がどれだけのラストCVを取れているかに加えて、
間接効果としての寄与がどれくらいあるのかを知りたい

その指示をもらった会議の文字起こしを載せておくので参考にして、
レポーティングを欲しいです
/Users/shoudaiyamamoto/Projects/ai-agent/input/ていねい通販.docx

8. 実際に講座で話した補足

ここでは、資料だけでは伝わりにくかった内容を、実際の講座で説明した順番に近い形で整理する。

8-1. Codexは「会話」ではなく「作業」をする

通常のチャット型AIは、質問に答えることが中心。一方、Codexは、PC上のファイルを読み、グラフやHTMLを作り、既存ファイルを修正し、ブラウザを操作しながら作業を進められる。

たとえば、HTMLレポートを作るだけでなく、ブラウザでGistや社内サーバーを開き、ログインが必要な画面で作業を進めることもできる。APIが用意されていないサービスでも、ブラウザで操作できるなら情報取得や入力を任せられる場合がある。

8-2. プロジェクトはローカルの作業フォルダ

Codexのプロジェクトは、AI専用のオンライン空間というより、Finder上のローカルフォルダを作業場所として使うイメージ。そこに資料を置き、Codexが読み、作ったファイルを同じ場所に残す。

8-3. AGENTS.mdに「常に守ること」を書く

AGENTS.mdは、プロジェクトの最上位に置くルールファイル。Codexは、そのフォルダ内で作業するときにこのファイルを読むため、毎回伝える必要がない条件を書いておく。

# このプロジェクトの作業ルール

- 入力資料はinputフォルダに置く
- 作成した成果物はoutputフォルダに保存する
- レポートはMarkdownではなくHTMLで作成する
- 音声入力のフィラーや言い淀みは無視する
- 不明な数値や事実は推測せず、不明と示す
- 既存ファイルを変更する前に、変更内容を説明する

プロジェクトの構成やファイル名は自分の好みに合わせてよい。重要なのは、毎回守ってほしい条件を自然言語で明文化すること。

8-4. Skillは「再現できる作業の手順書」

Skillは、特定の作業を再現しやすくする手順・判断基準・チェック項目・テンプレートのまとまり。提案書作成、広告バナー分析、CV寄与分析、文章編集など、繰り返す業務に使える。

8-5. 短い指示から始めて、自然言語で調整する

ていねい通販の分析では、最初から長大な指示を書いたわけではない。CSVのパス、分析したいこと、会議メモの場所を伝え、出力を見ながら追加指示を重ねた。

このCSVを分析してください。
知りたいのは、ラストCVだけでなく、間接的に寄与したCVです。
会議メモも参考にしてください。
まず対象条件と、確認できたデータの範囲を整理してください。

その後、「最終的にどの広告で刈り取られているか」「対象商品だけに絞る」「提出用HTMLにする」など、目的に合わせて指示を追加した。自然言語で作業を進めながら要件を明確にできる。

8-6. AIを使いすぎないための線引き

ブラウザ操作やスマートフォンからの遠隔操作ができると、移動時間や隙間時間まで仕事にできる。一方で、便利さがそのまま仕事時間の拡大にならないよう、「どこまで任せるか」「いつ止めるか」を自分で決める必要がある。

Codexは常に使うべきものではなく、ファイルを扱う作業・繰り返し作業・調査から成果物まで一気に進めたい作業に向いている。スライド作成や会議メモなど、別のAIの方が使いやすい作業は役割分担してよい。

9. 講座アジェンダ