メインコンテンツへスキップ
見出し画像

続・【中級でつまづいた人のための】Codexで迷ったときに戻る、プロジェクト・推論・Skillsの基本

    この記事はCodexが何者なのか?の記事の続編として書いております。
    最初から読みたい方は以下の記事から読んでいただくとさらに理解が深まります。

    【中級でつまづいた人のための】Codexは結局何者?迷ったときに戻る、プロジェクト・推論・Skillsの基本
    https://note.com/egashi_aiwork/n/n5dd629f31e92

     

    Codexへ作業を頼んだものの、完成したものを見て、
    「間違ってはいないけれど、欲しかったものと違う」
    と感じたことはありませんか?
    自分も、こうしたずれが起きるたびに、指示文を長くしていました。
    ただ、それでも初稿が安定しないことがあります。

    そこで参考になったのが、OpenAI Academyで紹介されているエージェント活用のワークフローです。
    前回の記事では、Codexが結局何をするものなのか、プロジェクト、推論、Skillsなどの基本を整理しました。
    今回はその続編として、Codexへ仕事を頼むときの進め方を整理します。
    初級から中級にステップアップしたが、やっぱり難しいといった悩みを持つすべての人に読んでほしい記事に仕上げました。

    目次

    1. 最初に結論:Codexには「完成品」ではなく「確認できる下書き」を作らせる

    2. 1.背景情報を収集する

    3. コンテキストとは「作業前に読ませる材料」

    4. ファイル

    5. メモ

    6. スクリプト

    7. 会議情報

    8. プロジェクト資料

    9. メッセージ

    10. データ

    すべて表示


    最初に結論:Codexには「完成品」ではなく「確認できる下書き」を作らせる

    Codexを使うとき、最初から完成品を求めたくなります。
    たとえば、
    「この資料をまとめてください」
    「このアプリを作ってください」
    「この文章を書き換えてください」
    と頼みます。
    ただ、完成条件や使用する情報が曖昧なまま進めると、Codexは不足部分を推測して埋めることがあります。
    そこで、最初の目標を変えます。
    最初から完成させることではなく、確認できる初稿を作ること。
    この考え方なら、次の流れになります。

    背景情報を渡す
    ↓
    目的を決める
    ↓
    出力形式を指定する
    ↓
    初稿を作らせる
    ↓
    人間が確認する
    ↓
    指示を修正する
    ↓
    次回も使える形で残す
    

    copy
    Codexへ丸投げするのではなく、人間が確認する場所を最初から作っておきます。


    1.背景情報を収集する

    最初に必要なのは、長い命令文ではありません。
    Codexが作業を始める前に読むべき情報です。
    たとえば、週次チームアップデートを作る場合、次の情報が必要になります。

    • プロジェクトの進捗メモ

    • 会議で決まったこと

    • 現在のタスクリスト

    • 作業を止めている問題

    • 担当者

    • 期限

    • 前回の週次報告

    これらがない状態で、

    今週のチームアップデートを作ってください。
    

    copy
    と頼んでも、Codexは正確な内容を作れません。
    文章として自然でも、事実が足りない初稿になります。
    そのため、まずはCodexが使用する情報を集めます。


    コンテキストとは「作業前に読ませる材料」

    コンテキストという言葉は難しく見えます。
    初心者向けにいうと、
    Codexが作業を始める前に知っておくべき情報
    です。
    コンテキストには、さまざまな形があります。

    ファイル

    • Word文書

    • PDF

    • スプレッドシート

    • スライド

    • Markdownファイル

    • テキストファイル

    メモ

    • ラフメモ

    • 計画メモ

    • 調査メモ

    • 個人的なリマインダー

    スクリプト

    • 動画の台本

    • プレゼンのトーク内容

    • デモの進行台本

    • 電話対応のスクリプト

    会議情報

    • 会議の議題

    • 会議概要

    • 決定事項

    • 次に行うこと

    プロジェクト資料

    • プロジェクト概要

    • 計画書

    • ロードマップ

    • 進捗管理表

    • ステータス報告

    メッセージ

    • Slackの会話

    • メールの要約

    • コメント

    • 関係者からのフィードバック

    データ

    • スプレッドシートの行

    • アンケート回答

    • 売上や閲覧数などの指標

    • 顧客からの意見

    過去の成果物

    • 前回の草稿

    • アウトライン

    • テンプレート

    • 理想に近い作成例

    Codexへ細かい指示を書く前に、
    今回の仕事に必要な材料はそろっているか
    を確認します。


    コンテキストを渡す方法は主に2つ

    1.チャットへ直接貼り付ける

    短いメモや、今回だけ使う情報に向いています。

    以下は今週のプロジェクトメモです。
    
    ---
    新しい記事投稿機能は実装完了。
    画像アップロード機能はテスト中。
    担当者は田中さん。
    公開予定日は6月30日。
    現在の問題は画像サイズの上限が未決定。
    ---
    

    copy
    情報量が少ない場合は、この方法が早いです。

    2.ファイルやリンクの場所を伝える

    長い資料や、今後も使う情報に向いています。

    次のファイルを確認してください。
    
    ・project-notes.md
    ・meeting-notes.md
    ・task-list.xlsx
    ・blockers.md
    

    copy
    ウェブ上の資料を読ませる場合は、URLを伝える方法もあります。
    ただし、リンク先を見るには、アクセス権限やCodex側のウェブ利用設定、接続しているアプリなどが必要になる場合があります。
    読めなかったときに推測で進まないよう、次の一文も加えます。

    アクセスできないファイルやリンクがある場合は、推測で進めず、読めなかったものを報告してください。
    

    copy


    2.目標を定義する

    背景情報を渡したら、次は目標を決めます。
    目標とは、
    今回の作業で何を作り、何を前進させたいのか
    です。
    週次チームアップデートなら、次のように書けます。

    共有前に人間が確認できる、週次チームアップデートの初稿を作成してください。
    

    copy
    ここで重要なのは、単に「まとめてください」と書かないことです。
    次の内容を決めます。

    • 誰が使うのか

    • 何に使うのか

    • どの状態まで作るのか

    • そのまま送信するのか

    • 人間の確認前提なのか

    今回の例では、共有前の初稿を作ることが目標です。
    自動で送信することは目標に含めていません。


    目標が曖昧な例

    今週の情報をまとめてください。
    

    copy
    これでは、何をまとめるべきか判断できません。

    • 上司への報告なのか

    • チーム内共有なのか

    • 顧客向けなのか

    • 詳細な議事録なのか

    • 短い進捗報告なのか

    が分かりません。

    目標を明確にした例

    チーム内で共有する前に確認できる、週次プロジェクトアップデートの初稿を作成してください。
    
    目的は、進捗、現在の課題、次の作業、担当者を短時間で確認できる状態にすることです。
    

    copy
    これなら、Codexが作るべきものが明確になります。


    3.出力を指定する

    目標を決めたあと、完成する下書きの形を指定します。
    週次報告なら、次の項目が考えられます。

    • 今週の進捗

    • 現在の課題

    • 次のステップ

    • 担当者

    • 期限

    • 未解決の疑問

    • 確認が必要な情報

    次のように伝えます。

    以下の順番で、簡潔な週次アップデートを作成してください。
    
    1. 今週の進捗
    2. 現在の課題
    3. 次のステップ
    4. 担当者と期限
    5. 未解決の疑問
    6. 人間による確認が必要な箇所
    

    copy
    出力形式を指定する理由は、見た目を整えるためだけではありません。
    確認する場所を固定するためです。
    毎回同じ順番で出力されれば、抜け漏れを見つけやすくなります。


    4.制約を決める

    Codexへ作業を頼むときは、やってほしいことだけではなく、やってはいけないことも伝えます。
    週次アップデートなら、次の制約が考えられます。

    ・作成した内容は送信、投稿、公開しない
    ・確認できない担当者や日付を作らない
    ・不足情報を推測で補わない
    ・機密情報を外部向け文章へ含めない
    ・不明な点は、不明と明記する
    

    copy
    特に重要なのは、
    所有者や日付を捏造しないこと
    です。
    人間は文章を読むと、担当者名や期限が書かれているだけで、事実だと思い込みやすくなります。
    そのため、確認できないものは空欄にするか、レビュー対象として残します。


    5.まず下書きを作成する

    背景、目標、出力、制約を伝えたら、初稿を作らせます。
    ここでは、完成度100%を求めません。
    確認できる状態になっていれば十分です。
    OpenAI Academyの例を、実務で使いやすい形にすると、次のようになります。

    # ゴール
    
    チームへ共有する前に、人間が確認できる週次アップデートの初稿を作成してください。
    
    # コンテキスト
    
    以下の情報を使用してください。
    
    ・プロジェクトノート
    ・会議メモ
    ・タスクリスト
    ・障害メモ
    ・前回の週次アップデート
    
    # 制約
    
    ・作成した内容を送信、投稿、公開しない
    ・担当者や期限を推測で作らない
    ・不足している情報は、不明と明記する
    ・機密情報を外部向けの表現へ変更しない
    ・確認できない内容は、レビュー対象として残す
    
    # 出力
    
    以下の順番で簡潔にまとめてください。
    
    1. 今週の進捗
    2. 現在の課題
    3. 次のステップ
    4. 担当者と期限
    5. 未解決の疑問
    6. レビューが必要な箇所
    
    作成後も送信せず、私の確認を待ってください。
    

    copy
    これが最初の初稿を作るためのテンプレートです。


    6.よく確認する

    Codexが初稿を作ったら、すぐに使いません。
    先にレビューします。
    確認する項目は、最初から決めておきます。

    事実は元の資料と一致しているか

    会議メモやタスクリストに書かれていない内容が追加されていないかを確認します。

    担当者と期限は正しいか

    名前や日付は、見た目以上に間違いの影響が大きい情報です。

    課題が明確になっているか

    「対応中」だけで終わらず、何が作業を止めているのか確認します。

    機密情報の扱いは適切か

    共有範囲を超えた情報が入っていないかを確認します。

    不明な情報が明記されているか

    推測で補われず、「確認が必要」と残っているかを確認します。

    次のステップが実行できる形になっているか

    「検討する」だけではなく、誰が何をするかまで分かるか確認します。


    レビューチェックもプロンプトに入れる

    確認項目は、人間だけが覚えておく必要はありません。
    Codex自身にも、初稿を確認させられます。

    初稿を作成したあと、次の項目で自己確認してください。
    
    ・事実が提供資料と一致しているか
    ・担当者と期限が正確か
    ・課題が具体的に書かれているか
    ・機密情報が適切に扱われているか
    ・不明な点がレビュー対象として明記されているか
    ・送信や公開を行っていないか
    
    確認結果も最後に記載してください。
    

    copy
    ただし、Codexが「確認済み」と書いたからといって、人間の確認が不要になるわけではありません。
    重要な情報は、元資料と照らし合わせます。


    7.指示を改善する

    初稿を確認すると、改善点が見えてきます。
    たとえば、次のような問題です。

    • 進捗が長すぎる

    • 課題と未解決事項が重複している

    • 担当者が分からない

    • 次のステップが抽象的

    • 専門用語が多い

    • 重要な決定事項が埋もれている

    これらを、その場限りの修正で終わらせません。
    次回の指示へ追加します。

    修正前

    今週の進捗をまとめてください。
    

    copy

    改善後

    今週の進捗は、重要度の高い順に最大5項目でまとめてください。
    
    各項目は2文以内にしてください。
    
    決定事項と、まだ検討中の内容を分けてください。
    
    担当者や期限が確認できない場合は、推測せず「要確認」と記載してください。
    

    copy
    人間が修正した内容は、次回のルール候補です。


    8.効果のあったものを再利用する

    何度か使って、安定してよい初稿が出るようになったら、その指示を保存します。
    保存方法は複数あります。

    • テキストファイルへ残す

    • プロジェクト内のMarkdownへ保存する

    • AGENTS.mdへルールを書く

    • Skillとしてまとめる

    • カスタムGPTへ登録する

    • チーム用のテンプレートとして共有する

    最初からSkillや大きな仕組みにする必要はありません。
    まずは通常のチャットで試します。
    効果が確認できたものだけを再利用します。

    一度試す
    ↓
    初稿を確認する
    ↓
    指示を直す
    ↓
    もう一度試す
    ↓
    安定したら保存する
    

    copy
    この順番なら、使えないテンプレートを量産せずに済みます。


    【保存版】:コピペで使えるCodexへ仕事を頼む基本テンプレート

    週次報告だけでなく、記事作成、資料作成、コード修正などにも使える形にしました。

    # ゴール
    
    今回作成・前進させたいもの:
    [作りたいもの]
    
    使用する人:
    [誰が使うか]
    
    完成と判断する状態:
    [完成条件]
    
    # コンテキスト
    
    以下の情報を使用してください。
    
    ・[ファイル、資料、メモ]
    ・[過去の成果物]
    ・[参考にするデータ]
    
    アクセスできないものがある場合は、推測で進めず報告してください。
    
    # 制約
    
    ・[してはいけないこと]
    ・[変更してはいけないもの]
    ・[推測してはいけない情報]
    ・[今回は行わない作業]
    
    # 出力
    
    以下の順番で作成してください。
    
    1. [出力項目]
    2. [出力項目]
    3. [出力項目]
    
    # レビューチェック
    
    作成後、次の項目を確認してください。
    
    ・提供した情報と一致しているか
    ・不足情報を推測していないか
    ・禁止事項を守っているか
    ・完成条件を満たしているか
    ・人間が確認すべき箇所が明記されているか
    
    # 進め方
    
    まず確認用の初稿を作ってください。
    
    送信、公開、本番反映は行わず、私の確認を待ってください。
    

    copy


    今回の学び

    OpenAI Academyのワークフローを見て、Codexの使い方は、良いプロンプトを1回書くことではないと感じました。
    重要なのは、
    背景を集める
    目標を決める
    出力を指定する
    まず初稿を作る
    人間が確認する
    指示を直す
    効果のあったものを残す
    という繰り返しです。
    AIに一度で完成品を作らせようとすると、条件が増え、指示が長くなります。
    それよりも、初稿とレビューを前提にした方が、結果的に早く完成へ近づけます。
    Codexは、人間の確認をなくすためのものではありません。
    人間が判断しやすい下書きを、早く作るための作業相手です。


    今回のメモ

    • 最初に長い命令を書くより、必要な背景情報をそろえる

    • コンテキストは、Codexが作業前に読む材料

    • 目標には、誰が使うかと完成条件も含める

    • 出力形式を固定すると、確認が速くなる

    • 送信や公開をしないなどの制約も明記する

    • 最初から完成品ではなく、確認用の初稿を作らせる

    • レビューチェックもプロンプトへ入れられる

    • 人間が直した内容は、次回の指示へ戻す

    • 効果が確認できた指示だけを再利用する

    • 安定した手順は、SkillやAGENTS.mdへ発展させられる


    次に読む記事

    Codexが何をするものなのか、プロジェクト、推論、Skillsなどの基本から確認したい方はこちらです。
    ▼Codexは結局何者?使っていて迷ったときに戻る基本

    Codexへ伝える目的や完成条件を整理したい方はこちらです。
    ▼ChatGPTの回答がずれる原因は「ゴールの曖昧さ」でした|プロンプトエンジニアリング入門


    この記事が参加している募集

     
     
    AIの活用事例や最新情報を、実際に使った活用事例、中級者でもつまづきそうになる点などを、日本一わかりやすくを目標に取り組んでいます。 【メインコンテンツ】 大規模言語モデル、ChatGPT、CodeX、画像生成、アプリ制作、デザインなど

    あなたへのおすすめ