
2025/12/20 17:09
**スキルが正式にCodexへ登場**
RSS: https://news.ycombinator.com/rss
要約▶
Japanese Translation:
エージェントスキルは、Codex ユーザーが
SKILL.md ファイルとオプションのスクリプトやアセットをパッケージ化することで、その機能を拡張できるようにします。スキルフォルダには少なくとも
name: と description: フィールドが必要で、追加メタデータは metadata の下に記述できます。 Codex が起動するときは、利用可能な各スキルの名前と説明だけを読み込みます——完全な指示はスキルが呼び出されたとき(明示的に /skills で、プロンプト内で言及されている場合、またはユーザーのリクエストに自動的にマッチした場合)にのみ読み込まれます。
Codex は以下の厳密な優先順位順でスキルを検索します:
(現在の作業ディレクトリ)$CWD/.codex/skills
(リポジトリルート)$REPO_ROOT/.codex/skills
(ユーザー固有設定)$CODEX_HOME/skills
(システム管理者位置)/etc/codex/skills- バンドルされたシステムスキル (
,skill‑creator
)plan
この階層により、チームは共有またはデフォルトのスキルをプロジェクト固有のもので上書きでき、バンドルスキルはより高い優先度の範囲によって置き換えられます。
ユーザーは組み込み
$skill-creator コマンド(必要に応じて $plan と組み合わせる)を使用するか、有効な SKILL.md を含むフォルダを手動で追加して新しいスキルを作成します。キュレーションされたスキルセットは $skill-installer linear でインストールでき、 $plan ツールは複雑なタスクの調査とアウトライン化に役立ちます。明示的呼び出しサポートは Codex の Web および iOS インターフェースに近日追加予定です。
機能をモジュラー化することで、エージェントスキルはチームが再利用可能な自動化モジュールを構築し、異なる優先度レベルでワークフローをカスタマイズし、プロジェクト間の繰り返しや専門的なタスクを効率化することを可能にします。
本文
エージェントスキル概要
エージェントスキルは、Codex にタスク固有の機能を追加できるようにします。
1 つのスキルには、指示・リソース・任意のスクリプトがパッケージ化されており、Codex が特定のワークフローを確実に実行できます。
主なポイント
- スキルはチームやコミュニティで共有可能です。
- オープンな Agent Skills 標準に基づいて構築されています。
- Codex CLI と IDE 拡張機能の両方で利用できます。
スキル構成
my-skill/ ├── SKILL.md # 必須:指示 + メタデータ ├── scripts/ # 任意:実行可能コード ├── references/ # 任意:ドキュメント └── assets/ # 任意:テンプレート、リソース
SKILL.md には次のように記述します。
--- name: skill-name description: Description that helps Codex select the skill metadata: short-description: Optional user‑facing description --- Skill instructions for the Codex agent to follow when using this skill.
呼び出し方法
| 方法 | 内容 |
|---|---|
| Explicit(明示的) | プロンプトに直接スキルを含めます。 または を使用します。(Web/iOS ではまだ明示呼び出しがサポートされていません。) |
| Implicit(暗黙的) | タスクの内容がスキルの説明と一致すると、Codex が自動でスキルを選択します。 |
どちらの場合も、Codex は呼び出されたスキルの完全な指示と追加でチェックインされたリファレンスを読み取ります。
スキルのスコープ & 優先順位(高→低)
-
REPO
$CWD/.codex/skills
現在の作業ディレクトリ – マイクロサービスやコードモジュールに関連するスキル。 -
REPO
$CWD/../.codex/skills
現在の作業ディレクトリより上のフォルダー – 親リポジトリで共有される領域。 -
REPO
$REPO_ROOT/.codex/skills
リポジトリ全体のトップレベル – そのリポジトリを使用するすべての人に適用されるスキル。 -
USER
($CODEX_HOME/skills
Mac/Linux)~/.codex/skills
個人フォルダー – 任意のリポジトリで使用できるユーザー固有のスキル。 -
ADMIN
/etc/codex/skills
システムまたはコンテナ内の場所 – SDK スクリプト、オートメーション、デフォルト管理者スキル。 -
SYSTEM(Codex にバンドル)
やskill-creator
など汎用的に有用なスキル。上位レイヤーで上書き可能です。plan
スキルの作成
- 組み込み
を使用 – 何をしたいかを説明すると Codex がスキルを自動生成します。最初に$skill-creator
と組み合わせて実装計画を作ると便利です。$plan - 手動で – 有効なスキル位置にフォルダーを作成し、上記テンプレートに従って
を追加します。SKILL.md
キュレーテッドスキルのインストール
$skill-installer linear # Linear スキルをインストール $skill-installer notion-spec-to-implementation # Notion コンテキストスキルをインストール
他のリポジトリからダウンロードするように installer に指示することも可能です。
組み込みヘルパースキル
| スキル | 用途 |
|---|---|
| 新機能や複雑な問題について調査し、計画を作成します。 |