プロンプト作成¶

プロンプト作成の概要¶

プロンプト作成とは、知りたいこと、作りたいもの、変更したいことを ChatGPT に伝える方法です。プロンプトは質問、指示、または目標にできます。技術的な構文や厳密な定型文は必要ありません。まず自分の言葉で始め、回答を確認し、フォローアップメッセージを使って結果を調整してください。

短いプロンプトで十分なことがよくあります。より大きなタスクや重要なタスクでは、重要な要素を含めてください。

• 目標: ChatGPT に何をしてほしいですか？
• コンテキスト: どの情報やソースが役立ちますか？
• 出力: どのような形式、長さ、詳細度が必要ですか？
• 境界: 何を変更せずに維持する必要がありますか？ChatGPT に避けてほしいことや、実行前に確認してほしいことは何ですか？

役立つ要素だけを使ってください。すべての項目を埋めたり、決められた形式に従ったりする必要はありません。

必要な結果を説明する¶

詳細な手順のリストではなく、結果から始めてください。ChatGPT が生成すべき内容に影響する場合は、対象読者や形式を含めてください。

Turn these meeting notes into a short update for the project team.
Put the decisions and next steps first.

このプロンプトは、何を作成するか、誰が読むかを説明しています。プロセス自体が重要な場合は、プロセスを説明してください。それ以外の場合は、ChatGPT が検索し、情報を比較し、アプローチを調整できる余地を残してください。

役立つコンテキストを追加する¶

結果を変える可能性のある情報を共有してください。重要なソースだけを追加し、それぞれから ChatGPT が何を読み取るべきかを説明してください。

• ChatGPT に要約、比較、変換、またはレビュー用のファイルを作成してほしい場合は、ドキュメント、スプレッドシート、プレゼンテーション、PDF ファイルを添付してください。
• タスクが視覚的なコンテキストに依存する場合は、スクリーンショット、図、その他の画像入力を追加してください。画像だけに頼るのではなく、重要な領域を示してください。
• 回答が最新情報に依存する場合は、Web 検索を使うよう ChatGPT に依頼し、結果を確認する必要がある場合はソースを求めてください。
• 関連するチャットでファイル、ソース、またはローカルフォルダーを共有する必要がある場合は、プロジェクトを使ってください。

接続されたソースを使う¶

ChatGPT が接続されたソースにアクセスできる場合は、どこを検索し、何を見つけるべきかを指定してください。実行すべき検索をすべて説明する必要はありません。

Use the latest project plan in Drive and relevant decisions and updates from
the project's Slack channel to prepare a status update.

接続されたソースには対応するプラグインが必要であり、利用できるかどうかはプランとワークスペースの設定によって異なる場合があります。

プラグインを使う¶

プラグインは、Google Drive、Gmail、Slack、GitHub などのツールへの再利用可能な指示と接続を ChatGPT に提供します。必要な結果を依頼し、利用可能なツールから ChatGPT に選択させてください。特定のプラグインを選択するには、composer に @ と入力します。

ChatGPT でプラグインを検索、インストール、使用します。

ChatGPT をパーソナライズする¶

チャット全体に適用する設定は、Settings > Personalization のカスタム指示として指定してください。現在のチャットだけに関係する詳細は、プロンプトに記載してください。

デフォルトのパーソナリティ、カスタム指示、その他のアプリ設定を指定します。

現実的な問題を防ぐ境界を設定する¶

境界とは、余計な作業を作成したり、意図しないアクションを実行したりしないよう、ChatGPT に必要な少数の指示です。間違った詳細を変更すると結果が使えなくなる場合や、他の人に影響する前に何かを確認したい場合に追加してください。

• 承認済みの日付と予算の数値は変更しないでください。
• 提供したソースのみを使用してください。推測せず、不足している情報を示してください。
• 推奨事項を指定された予算内に収めてください。
• メッセージを下書きとして準備してください。送信しないでください。

最も重要な 1 つか 2 つの境界に集中してください。ChatGPT が実行するすべての手順を制御する必要はありません。

結果をすぐ使える状態にする¶

結果をどのように使う予定かを ChatGPT に伝えてください。これにより、適切な長さ、詳細度、構成を選択しやすくなります。

• 会議前にディレクターが確認できる 1 ページの要約にしてください。最初に決定事項と次のステップを記載してください。
• これらのメモを、決定事項、担当者、期限を含むフォローアップメールにしてください。
• 予定支出と実績支出を明確な表にし、10% を超える差異を強調してください。

重要な作業では、すべてのアクションアイテムに担当者と期限があることの確認や、検証できなかった情報の指摘など、最終確認を ChatGPT に依頼してください。その後、使用または共有する前に自分で結果を確認してください。

フォローアップメッセージで結果を改善する¶

最初のプロンプトは完璧である必要はありません。結果を確認してから、必要な変更を具体的に依頼してください。

Make the opening more direct, keep the evidence, and move the recommendation
above the background section.

不足しているソースを追加したり、方向性を修正したり、別の選択肢を求めたり、詳細度を変更したりできます。最初からやり直す必要はありません。

操作とキュー¶

Codex がすでに作業中の場合、現在の実行が終わるまで待たずに別のメッセージを送信できます。

• 操作: メッセージを現在の実行に追加します。方向を変えたり、不足している詳細を追加したり、新しい情報を共有したりする場合に使います。
• キュー: メッセージを次回の実行用に保存します。現在の作業が終わるまで待つべきフォローアップに使います。

ChatGPT デスクトップアプリで、Settings > General > Follow-up behavior のデフォルトを選択します。キューに入ったメッセージは composer の上に表示され、編集、並べ替え、送信、削除ができます。この設定には、デフォルトを変更せずに 1 つのメッセージで別の動作を使うためのショートカットも表示されます。

Codex CLI では、Codex の作業中に Enter を押すと現在のターンを操作でき、Tab を押すと次のターン用にメッセージをキューに入れられます。詳細はインタラクティブショートカットを参照してください。

要素を組み合わせる¶

接続されたソースを使うプロジェクト更新の場合、完全なプロンプトは次のようになります。

Prepare a one-page project status update for Monday's leadership meeting. Use
the latest project plan in Drive and relevant decisions and updates from the
project's Slack channel.

Lead with the decisions leadership needs to make and the next steps. Summarize
progress, risks, owners, and due dates. Keep approved dates and budget figures
unchanged. Flag any conflicting or missing information, and don't send or
publish anything.

Before you finish, check that every next step has an owner and due date.

このプロンプトは、目標、コンテキスト、出力、境界を網羅し、すべての手順を細かく記述せずに最終確認を求めています。

音声入力を使う¶

ChatGPT デスクトップアプリで composer が表示されている間に Ctrl+M を長押ししてから話し始めてください。ChatGPT は音声を composer に文字起こしするため、プロンプトを送信する前に確認して編集できます。

Chat のプロンプト作成例¶

質問、アイデア、下書き、日常的な意思決定には Chat を使ってください。必要な結果から始め、回答が変わる場合にだけ詳細を追加してください。

トピックを理解する¶

Explain how compound interest works for someone who has never invested.
Use one concrete example and define any financial terms you introduce.

文章を下書きして改善する¶

Draft a friendly email declining this invitation because I will be traveling.
Keep it under 120 words and leave the door open for a future event.

選択肢を比較する¶

Compare these two phone plans for one person who travels internationally twice
a year. Show the important differences in a table, then recommend one and explain
the tradeoff.

実用的な計画を作る¶

Plan five weekday dinners that take less than 30 minutes. Avoid peanuts, reuse
ingredients across meals, and finish with one consolidated shopping list.

Work モードでプロンプトを作成する¶

簡単な質問、短い書き換え、ブレインストーミング、軽量な下書きには Chat モードを使ってください。異なるソースやツールを使うタスク、複数の手順を含むタスク、変更を加えるタスク、大きな成果物を作成するタスクには Work モードを使ってください。

Work モードでは、必要な結果を説明し、ソース資料を提供し、対象読者を示し、作業をどのように確認するかを説明してください。ChatGPT に計画、必要な情報の収集、ファイルの作成、完了前の確認を依頼してください。

Work モードを効率的に使う¶

Work モードは、時間のかかるタスクや繰り返し行うタスク、再利用できる完成ファイルに役立ちます。より多くのクレジットを使うタスクでも、時間の節約、品質の向上、重要な意思決定の支援につながるなら価値があります。

確認できる 1 つの結果から始めてください。

• 関連するソースだけを含め、適切な場合は日付範囲を限定してください。
• 対象読者、出力形式、希望する長さを定義してください。
• 必須の作業と、任意の改善または仕上げを分けてください。
• アプローチが重要な場合は計画を求めてください。ChatGPT が他の人の依存する情報を送信、公開、変更する前に、承認を必須にしてください。
• 不要になった作業を始めた場合は、タスクを絞り込むか停止してください。

最初の結果を確認し、指示を改善し、うまくいったワークフローを再利用してください。

ソース資料を完成ファイルに変換する¶

Use the attached quarterly reports to create a leadership brief and a six-slide
presentation.

The audience is the executive team. Lead with the three decisions they need to
make, distinguish reported facts from your analysis, cite each number to its
source file, and check that the brief and slides agree before you finish.

意思決定を調査する¶

Research three customer-support platforms for a 50-person company. Compare
pricing, security, integrations, and migration effort using current sources.
Deliver a recommendation memo with links, assumptions, and the questions we
should answer before signing a contract.

ローンチを調整する¶

Create a launch plan for the attached product brief. Include the timeline,
owners, dependencies, risks, announcement draft, customer FAQ, and a checklist
for launch day. Flag any missing decisions before producing the final files.

繰り返し行う作業では、まず通常のチャットでプロンプトを改善してください。出力の信頼性が確認できたら、そのチャット内でタスクをスケジュールしてください。スケジュールされた各実行で新しいチャットを開始する必要がある場合は、代わりに独立したスケジュール済みタスクを作成してください。

Codex 用のプロンプトを作成する¶

コード、コードベース、開発者ツールを ChatGPT に操作させたい場合は Codex を使ってください。役立つ Codex プロンプトでは、求める動作、関連するコードまたは再現手順、維持すべき重要な制約、変更を検証する方法を示します。

複数ステップのタスクでは、編集前に Codex に調査とアプローチの提案を行わせたい場合、アプリの composer に /plan と入力してください。Goal modeを利用できる場合は、計画後に /goal を使って永続的な目標を設定します。現在のコマンド一覧については、アプリのスラッシュコマンドを参照してください。

これらの例の読み方¶

各ワークフローには次の内容が含まれます。

• 使用するタイミングと、最適な Codex の利用先（IDE、CLI、クラウド）。
• 手順と、ユーザープロンプトの例。
• コンテキストに関する注意: Codex が自動的に認識する内容と、添付すべき内容。
• 検証: 出力を確認する方法。

注: IDE 拡張機能は、開いているファイルをコンテキストとして自動的に含めます。CLI ではパスを明示するか、/mention と @ のパス補完を使ってファイルを添付してください。

Codex は、ファイルとネットワークへのアクセスを制限するサンドボックス内でローカルコマンドを実行します。タスクでその境界を越える必要がある場合、Codex は続行する前に承認ポリシーに従います。

コードベースを説明する¶

オンボーディング中、サービスを引き継いだとき、またはプロトコル、データモデル、リクエストフローについて理解しようとしているときに使ってください。

IDE 拡張機能のワークフロー（ローカル探索に最速）¶

1. 最も関連性の高いファイルを開きます。
2. 確認したいコードを選択します（任意ですが推奨されます）。
3. Codex にプロンプトを入力します。

Explain how the request flows through the selected code.

Include:
- a short summary of the responsibilities of each module involved
- what data is validated and where
- one or two "gotchas" to watch for when changing this

検証:

• 検証できる図またはチェックリストを求めます。

Summarize the request flow as a numbered list of steps. Then list the files involved.

CLI ワークフロー（トランスクリプトと shell コマンドが必要な場合に有効）¶

1. インタラクティブセッションを開始します。

codex

1. ファイルを添付し（任意）、プロンプトを入力します。

I need to understand the protocol used by this service. Read @foo.ts @schema.ts and explain the schema and request/response flow. Focus on required vs optional fields and backward compatibility rules.

コンテキストに関する注意:

• composer で @ を使うとワークスペースからファイルパスを挿入でき、/mention を使うと特定のファイルを添付できます。

バグを修正する¶

ローカルで再現できる不具合がある場合に使ってください。

CLI ワークフロー（再現と検証の短いループ）¶

1. リポジトリのルートで Codex を開始します。

codex

1. 疑わしいファイルとともに、再現手順を Codex に伝えます。

Bug: Clicking "Save" on the settings screen sometimes shows "Saved" but doesn't persist the change.

Repro:
1) Start the app: npm run dev
2) Go to /settings
3) Toggle "Enable alerts"
4) Click Save
5) Refresh the page: the toggle resets

Constraints:
- Do not change the API shape.
- Keep the fix minimal and add a regression test if feasible.

Start by reproducing the bug locally, then propose a patch and run checks.

コンテキストに関する注意:

• ユーザーが提供するもの: 再現手順と制約（高レベルな説明よりも重要です）。
• Codex が提供するもの: コマンド出力、発見した呼び出し箇所、実行によって発生したスタックトレース。

検証:

• Codex は修正後に再現手順を再実行する必要があります。
• 標準のチェックパイプラインがある場合は、実行するよう依頼してください。

After the fix, run lint + the smallest relevant test suite. Report the commands and results.

IDE 拡張機能のワークフロー¶

1. バグがあると思われるファイルと、その最も近い呼び出し元を開きます。
2. Codex にプロンプトを入力します。

Find the bug causing "Saved" to show without persisting changes. After proposing the fix, tell me how to verify it in the UI.

テストを書く¶

テスト対象の正確な範囲を定義したい場合に使ってください。

IDE 拡張機能のワークフロー（選択範囲ベース）¶

1. 関数を含むファイルを開きます。
2. 関数を定義している行を選択します。コマンドパレットから「Add to Codex Thread」を選択して、これらの行をコンテキストに追加します。
3. Codex にプロンプトを入力します。

Write a unit test for this function. Follow conventions used in other tests.

コンテキストに関する注意:

• 「Add to Codex Thread」コマンドが提供するもの: 選択した行（「行番号」の範囲）と、開いているファイル。

CLI ワークフロー（プロンプトでパスと行範囲を指定）¶

1. Codex を開始します。

codex

1. 関数名を指定してプロンプトを入力します。

Add a test for the invert_list function in @transform.ts. Cover the happy path plus edge cases.

スクリーンショットからプロトタイプを作成する¶

デザインモック、スクリーンショット、UI リファレンスを動作するプロトタイプに変換したい場合に使ってください。

CLI ワークフロー（画像 + プロンプト）¶

1. スクリーンショットをローカルに保存します（例: ./specs/ui.png）。
2. Codex を実行します。

codex

1. 画像ファイルをターミナルにドラッグして、プロンプトに添付します。

2. 制約と構成を指定してフォローアップします。

Create a new dashboard based on this image.

Constraints:
- Use react, vite, and tailwind. Write the code in typescript.
- Match spacing, typography, and layout as closely as possible.

Outputs:
- A new route/page that renders the UI
- Any small components needed
- README.md with instructions to run it locally

コンテキストに関する注意:

• 画像は視覚的な要件を示しますが、実装上の制約（フレームワーク、ルーティング、コンポーネントのスタイル）も指定する必要があります。
• ホバー状態、検証ルール、キーボード操作など、画像に表示されない動作をテキストで含めてください。

検証:

• Codex に開発サーバーを実行させ（許可されている場合）、どこを確認すべきか正確に伝えてもらいます。

Start the dev server and tell me the local URL/route to view the prototype.

IDE 拡張機能のワークフロー（画像 + 既存ファイル）¶

1. Codex チャットに画像を添付します（ドラッグアンドドロップまたは貼り付け）。
2. Codex にプロンプトを入力します。

Create a new settings page. Use the attached screenshot as the target UI.
Follow design and visual patterns from other files in this project.

ライブ更新で UI を反復する¶

Codex がコードを編集する間、「デザイン → 調整 → 更新 → 調整」の短いループを回したい場合に使ってください。

CLI ワークフロー（Vite を実行し、小さなプロンプトで反復）¶

1. Codex を開始します。

codex

1. 別のターミナルウィンドウで開発サーバーを開始します。

npm run dev

1. Codex に変更を依頼します。

Propose 2-3 styling improvements for the landing page.

1. 方向性を選び、小さく具体的なプロンプトで反復します。

Go with option 2.

Change only the header:
- make the typography more editorial
- increase whitespace
- ensure it still looks good on mobile

1. 焦点を絞った依頼を繰り返します。

Next iteration: reduce visual noise.
Keep the layout, but simplify colors and remove any redundant borders.

検証:

• Codex がコードを更新する際に、ブラウザーで変更を確認します。
• 気に入った変更をコミットし、気に入らない変更を元に戻します。
• 編集を元に戻したり変更したりした場合は、次のプロンプトで作業する際にその編集を上書きしないよう Codex に伝えてください。

リファクタリングをクラウドに委任する¶

ローカルのコンテキストを使ってアプローチを設計し、並行して実行できるクラウドチャットに長時間の実装を委任したい場合に使ってください。

ローカルでの計画（IDE）¶

1. 変更を明確に比較できるよう、現在の作業がコミット済みか、少なくとも stash 済みであることを確認します。
2. Codex にリファクタリング計画の作成を依頼します。$plan スキルを利用できる場合は、明示的に呼び出します。

$plan

We need to refactor the auth subsystem to:
- split responsibilities (token parsing vs session loading vs permissions)
- reduce circular imports
- improve testability

Constraints:
- No user-visible behavior changes
- Keep public APIs stable
- Include a step-by-step migration plan

1. 計画を確認し、変更を調整します。

Revise the plan to:
- specify exactly which files move in each milestone
- include a rollback strategy

コンテキストに関する注意:

• Codex が現在のコードをローカルでスキャンできる場合（エントリーポイント、モジュール境界、依存関係グラフの手がかり）、計画が最も効果的になります。

クラウドへの委任（IDE → Cloud）¶

1. まだ設定していない場合は、Codex クラウド環境を設定します。
2. プロンプト composer の下にあるクラウドアイコンをクリックし、クラウド環境を選択します。
3. 次のプロンプトを入力すると、Codex は既存のチャットコンテキスト（計画やローカルのソース変更を含む）を引き継いだ新しいチャットをクラウドに作成します。

Implement Milestone 1 from the plan.

1. クラウドの差分を確認し、必要に応じて反復します。

2. クラウドから直接 PR を作成するか、変更をローカルに取り込んでテストと仕上げを行います。

3. 計画の追加マイルストーンについて反復します。

クラウドに委任されたタスクは、分離された環境で実行されます。環境で有効にしない限り、エージェントフェーズ中はインターネットアクセスが無効です。クラウドのインターネットアクセスの詳細をご覧ください。

ローカルでコードレビューを行う¶

コミットや PR の作成前に、別の視点から確認したい場合に使ってください。

CLI ワークフロー（作業ツリーをレビューする）¶

1. Codex を開始します。

codex

1. レビューコマンドを実行します。

/review

1. 任意で、独自の重点項目を指定します。

/review Focus on edge cases and security issues

検証:

• レビューのフィードバックに基づいて修正を適用し、/review を再実行して問題が解決されたことを確認します。

GitHub のプルリクエストをレビューする¶

ブランチをローカルに取り込まずにレビューのフィードバックを受けたい場合に使ってください。

これを使う前に、リポジトリで Codex Code review を有効にしてください。Code reviewを参照してください。

GitHub ワークフロー（コメント駆動）¶

1. GitHub でプルリクエストを開きます。
2. 重点項目を明示して Codex をタグ付けするコメントを残します。

@codex review

1. 任意で、より明確な指示を指定します。

@codex review for security vulnerabilities and security concerns

ドキュメントを更新する¶

正確で明確なドキュメント変更が必要な場合に使ってください。

IDE または CLI ワークフロー（ローカル編集 + ローカル検証）¶

1. 変更するドキュメントファイルを特定して開きます（IDE）。または @ を使ってそれらを指定します（IDE または CLI）。
2. 範囲と検証要件を指定して Codex にプロンプトを入力します。

Update the "advanced features" documentation to provide authentication troubleshooting guidance. Verify that all links are valid.

1. Codex が変更を下書きしたら、ドキュメントを確認し、必要に応じて反復します。

検証:

• レンダリングされたページを読みます。