Codex use case
ワークフローのスキル化
繰り返す作業の手順を、Codex がいつでも使えるスキルにまとめます。
作業がうまくいったときの Codex とのチャット、レビューのルール、テストコマンド、リリース用のチェックリスト、設計規約、文章の例、リポジトリ固有のスクリプトなどをもとに、Codex が今後のタスクで使えるスキルを作成します。
Best for
- 手順が明文化されていて、今後も Codex に任せたいワークフロー
- チャットのたびに長いプロンプトを貼り付ける手間を省き、スキルを繰り返し使いたいチーム
Contents
ワークフローのスキル化
繰り返す作業の手順を、Codex がいつでも使えるスキルにまとめます。
作業がうまくいったときの Codex とのチャット、レビューのルール、テストコマンド、リリース用のチェックリスト、設計規約、文章の例、リポジトリ固有のスクリプトなどをもとに、Codex が今後のタスクで使えるスキルを作成します。
作業がうまくいったときの Codex とのチャット、レビューのルール、テストコマンド、リリース用のチェックリスト、設計規約、文章の例、リポジトリ固有のスクリプトなどをもとに、Codex が今後のタスクで使えるスキルを作成します。
Related links
Best for
- 手順が明文化されていて、今後も Codex に任せたいワークフロー
- チャットのたびに長いプロンプトを貼り付ける手間を省き、スキルを繰り返し使いたいチーム
Skills & Plugins
- ワークフローに関する情報を集め、スキルのひな形を作成します。主な指示を簡潔にまとめ、完成したスキルを検証します。
| Skill | Why use it |
|---|---|
| Skill Creator | ワークフローに関する情報を集め、スキルのひな形を作成します。主な指示を簡潔にまとめ、完成したスキルを検証します。 |
Starter prompt
Codex で繰り返し使えるスキルの作成
スキルを使うと、繰り返し行う作業に必要な指示や資料、スクリプトを Codex に渡して再利用できます。初回の作業で Codex が役に立ったときのタスクやドキュメント、コマンド、具体例をスキルに残せます。
まずは、実際にうまくいった例を 1 つ選びます。たとえば、PR をチェリーピックした Codex のチャット、Notion のリリースチェックリスト、参考になった PR コメント集、ローンチ手順を説明した Slack スレッドなどです。
使い方
-
Codex に使ってほしいコンテキストを追加します。
残しておきたい Codex のチャットを開いたまま、Slack のスレッドやドキュメントへのリンクを貼り付け、Codex に覚えておいてほしいルール、コマンド、具体例を追加します。
-
スキル作成用のプロンプトを実行します。
プロンプトでは、まず作成したいスキルの名前を指定し、次に
$skill-creatorに残しておきたいタスク、ドキュメント、PR、コマンド、出力を渡します。 -
Codex にスキルの作成と検証を任せます。
作成されたスキルには、
$skill-nameと、そのスキルを呼び出す条件が明記され、再利用する指示が適切な場所に保存されているはずです。~/.codex/skillsに保存したスキルは、どのリポジトリからでも使えます。現在のリポジトリに保存したスキルは、コミットすればチームの他のメンバーも使えます。 -
スキルを使い、チャットから更新します。
次の PR、アラート対応、レビュー、リリースノートの作成、デザイン作業で、新しい
$skill-nameを呼び出します。テストコマンドが違っていた、レビューのルールを見落とした、ランブックの手順を飛ばした、そのままでは送れない下書きを作成したといった場合は、修正内容をスキルに反映するよう Codex に依頼します。
スキルのもとになる資料
スキルでどのように作業を進めてほしいかがわかる資料を $skill-creator に渡します。
| 手元にあるもの | 追加する内容 |
|---|---|
| Codex のチャットに残っている、再利用したいワークフロー | そのチャットで use this chat と伝えます。Codex は、チャットのコンテキスト、コマンド、編集内容、フィードバックをもとにスキルを作成できます。 |
| ドキュメントやランブック | リリースチェックリストを貼り付ける、インシデント対応ランブックへのリンクを共有する、API の PDF を添付する、リポジトリ内の Markdown ガイドの場所を Codex に伝える、といった方法があります。 |
| チーム内の会話 | アラートについて説明した Slack スレッドを貼り付けるか、フロントエンドのルールを示した PR レビューへのリンクを共有します。顧客が直面している問題がわかるサポートのやり取りを添付することもできます。 |
| スキルで再利用したいスクリプトやコマンド | 今後のタスクで Codex に実行してほしいテストコマンド、プレビューコマンド、リリーススクリプト、ログ取得スクリプト、ローカルの補助コマンドを追加します。 |
| 手本にしたい成果物 | 今後のタスクで手本にしたいものを追加します。たとえば、マージ済みの PR、変更履歴に載せた最終的な文面、承認されたローンチ告知、解決済みのチケット、変更前後のスクリーンショット、Codex の最終回答などです。 |
資料が Slack、Linear、GitHub、Notion、Sentry にある場合は、プラグインを使ってそのツールを Codex に接続するか、スキル作成用のプロンプトでツールを指定するか、該当箇所をチャットに貼り付けます。
Codex が作成するファイル
ほとんどのスキルは、最初は SKILL.md ファイルだけで構成されます。ワークフローに応じて、$skill-creator は詳しい参考資料、スクリプト、アセットも追加できます。
-
my-skill/
- SKILL.md 必須：指示とメタデータ
- references/ 任意：詳しいドキュメント
- scripts/ 任意：繰り返し実行するコマンド
- assets/ 任意：テンプレートとひな形ファイル
-
作成できるスキルの例
今後のタスクでも同じランブックを参照する、同じ CLI を実行する、同じレビュー基準に従う、同じ形式でチーム向けの進捗報告を書く、ブラウザで同じ操作フローを検証するといった場合に、この方法を使えます。たとえば、次のようなスキルを作成できます。
$buildkite-fix-ciは、失敗したジョブのログをダウンロードし、エラーの原因を特定して、必要最小限のコード修正を提案します。$fix-merge-conflictsは、GitHub の PR をチェックアウトし、ベースブランチの変更を取り込んで競合を解消し、プッシュに使う正確なコマンドを返します。$frontend-skillは、好みの UI や既存のコンポーネントに沿って Codex が実装できるようにします。スクリーンショットで繰り返し検証する手順、アセットの選び方、ブラウザでの仕上げ方も反映します。$pr-review-commentsは、レビューのメモを、場面に合った語調の簡潔なインラインコメントにまとめ、関連する GitHub のリンクを添えます。$web-game-prototyperは、最初に遊べるゲームループの範囲を決め、アセットを選び、操作感を調整し、スクリーンショットを撮ってブラウザ上で仕上げます。
Related use cases
目標に沿った作業
Codex が複数のターンにわたって作業を続け、終了条件を満たしたことを確認してから作業を終える必要がある場合は、`/goal` を使います。
Codex が使える CLI の作成
どのフォルダーからでも実行でき、リポジトリ内のスクリプトと組み合わせたり、ファイルをダウンロードしたりできる CLI の作成を Codex...
ブラウザゲームの開発
Codex を使ってゲームの企画を具体的な開発計画にまとめ、それに沿ってブラウザで遊べるゲームを作ります。画像素材は imagegen で生成し、Codex...