Codex use case
ワークフローをスキルとして保存
繰り返し行う作業用のスキルを作成し、Codex がいつでも使えるようにします。
うまくいった Codex チャット、レビューのルール、テストコマンド、リリースチェックリスト、デザイン規約、文例、リポジトリ固有のスクリプトを、今後のタスクで Codex が利用できるスキルに変換します。
最適な用途
- Codex に繰り返し使わせたい、明文化したワークフロー。
- チャットごとに長いプロンプトを貼り付ける代わりに、再利用可能なスキルを使いたいチーム。
Contents
ワークフローをスキルとして保存
繰り返し行う作業用のスキルを作成し、Codex がいつでも使えるようにします。
うまくいった Codex チャット、レビューのルール、テストコマンド、リリースチェックリスト、デザイン規約、文例、リポジトリ固有のスクリプトを、今後のタスクで Codex が利用できるスキルに変換します。
うまくいった Codex チャット、レビューのルール、テストコマンド、リリースチェックリスト、デザイン規約、文例、リポジトリ固有のスクリプトを、今後のタスクで Codex が利用できるスキルに変換します。
関連リンク
最適な用途
- Codex に繰り返し使わせたい、明文化したワークフロー。
- チャットごとに長いプロンプトを貼り付ける代わりに、再利用可能なスキルを使いたいチーム。
スキルとプラグイン
- ワークフローに関する情報を集め、スキルのひな型を作成し、中心となる指示を簡潔にまとめ、結果を検証します。
| Skill | Why use it |
|---|---|
| Skill Creator | ワークフローに関する情報を集め、スキルのひな型を作成し、中心となる指示を簡潔にまとめ、結果を検証します。 |
開始用プロンプト
Codex がいつでも使えるスキルの作成
スキルを使うと、繰り返し行う作業向けの再利用可能な指示、リソース、スクリプトを Codex に提供できます。スキル には、Codex が最初にうまく対応できたタスクや、その際に使ったドキュメント、コマンド、例を保存できます。
まず、うまくいった例を 1 つ用意します。たとえば、PR をチェリーピックした Codex チャット、Notion のリリースチェックリスト、役立つ PR コメント一式、ローンチ手順を説明した Slack スレッドなどです。
使用方法
-
Codex に使わせたいコンテキストを追加します。
保存したい Codex チャットを開いたまま、Slack スレッドまたはドキュメントのリンクを貼り付け、Codex に記憶させたいルール、コマンド、例を追加します。
-
スタータープロンプトを実行します。
プロンプトでは、作成するスキルに名前を付けたうえで、保存するタスク、ドキュメント、PR、コマンド、または出力を
$skill-creatorに渡します。 -
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 を実行する、同じレビュー基準に従う、同じ形式のチーム向け更新文を書く、または同じブラウザフローを QA するときにも、このパターンを使えます。たとえば:
$buildkite-fix-ciは、失敗したジョブのログをダウンロードし、エラーを診断して、必要最小限のコード修正を提案します。$fix-merge-conflictsは GitHub PR をチェックアウトし、ベースブランチに合わせて更新し、競合を解決して、正確な push コマンドを返します。$frontend-skillは、Codex が UI に関する好み、既存コンポーネント、スクリーンショットを使った QA ループ、アセットの選び方、ブラウザでの最終調整から逸れないようにします。$pr-review-commentsは、レビューのメモを、適切なトーンと GitHub リンクを含む簡潔なインラインコメントに変換します。$web-game-prototyperは、最初にプレイ可能なゲームループの範囲を定め、アセットを選び、ゲームの操作感を調整し、スクリーンショットを撮影して、ブラウザ上で仕上げます。
関連するユースケース
ゴールに沿った作業
Codex が複数のターンにわたり、検証可能な停止条件に達するまで作業を続ける必要があるタスクには、`/goal` を使用します。
依存関係インシデントの監査
Codex を使って、パッケージやサプライチェーンに関する公開アドバイザリを読み取り専用の監査に落とし込み、信頼されていないコードを実行せずに、マニフェスト、ロックファイル、CI...
Codex が使える CLI の作成
どのフォルダーからでも実行でき、リポジトリスクリプトと組み合わせたり、ファイルをダウンロードしたりでき、付属スキルを通じて使い方を記憶できる、組み合わせ可能な CLI を Codex...