このページは英語版ドキュメントの翻訳です。コマンド、識別子、例はそのままです。ランタイム 7.24.4 · SDK 2.6.7。 英語版

スキルとプラグインのカタログ

状態: 有効 範囲: 公開、現行状態 最終確認: 2026-08-12 担当: AX Code ランタイム

組み込みスキルの発見可能なレジストリと、プロジェクトスキルの追加方法です。

既定の / メニューは制御プレーンです（/plan、/review、/debug、/status、/model）。より古い組み込みスキルはエージェント専用のままです（スキルツール）。バックエンド信頼性パックもスラッシュコマンドとして一覧されます。

組み込みスキル（packages/ax-code/skills/ 配下で出荷）

スキルは SKILL.md を、YAML フロントマター（name、description、任意の paths、allowed-tools）とともに使います。

プロジェクトスキル

次のいずれかの下にスキルを置きます。

• .ax-code/skill/<name>/SKILL.md または .ax-code/skills/<name>/SKILL.md
• .agents/skills/<name>/SKILL.md（Agents / Codex 互換）
• .claude/skills/<name>/SKILL.md（Claude Code 互換）
• .opencode/skills/<name>/SKILL.md

一覧と検証:

ax-code            # TUI skill dialog
# or use the skill tool from a session

呼び出し制御

AX Code はスキルを発見するとき、これらの任意の制御を読みます。

YAML の真偽値 true と false を使います。制御がない場合は既定を保ちます。複数の源が食い違う場合、制限的な宣言が勝ちます。無効な制御型、または不正なサイドカーポリシーは、両方の呼び出しモードを無効にし、スキル一覧とランタイムログに呼び出し診断を出します。スキルを使う前にメタデータを直してください。任意のサイドカーは 64 KiB より小さくなければなりません。そこでは YAML 文書区切りとエイリアスは対応しません。

これらの制御は、既存のエージェント権限とは独立に、スキル呼び出しを支配します。手動専用スキルへの自然言語の言及は、モデルがそれを読み込むことを認可しません。そのスラッシュコマンドを呼び出してください。宣言された allowed-tools はワークフロー指示のままで、権限を与えません。

上限付きの発見

モデルは最初、完全な指示ではなくスキル要約を受け取ります。システムプロンプトとツール説明の各スキルメタデータブロックには、8,000 文字の予算があります。項目を省く前に説明は短くされます。一覧がまだその予算を超えるとき、ファイルが一致した推奨が優先されます。省略の通知は、より多くの要約を取り出す方法を説明します。これは文字数の上限であり、トークン数や性能保証ではありません。

skill ツールには、互いに排他的なモードがあります。

• {"name":"api-contract"} は、既存の権限確認を通してスキルを読み込みます。
• {"query":"database"} は、スキル本体を読み込まずに、対象となる名前と説明を検索します。
• {"query":"","offset":20} は、直前の結果の正確な nextOffset を使って一覧を続けます。

検索はリテラルで、大文字小文字を区別しません。空のクエリは対象スキルを一覧します。nextOffset がなくなるまで従ってください。手動専用と権限拒否のスキルは、モデルの発見から除外されます。大きすぎる個別のメタデータ項目は、通知とともにスキップされます。名前とソースの優先順位は変わりません。

プラグイン

プラグインは ax-code.json で設定します。

{
  "plugin": ["file:///absolute/path/to/plugin.js"]
}

プラグインは @ax-code/plugin フック（tool.execute.before、tool.execute.after、shell.env、認証など）を実装します。

コールバックの寿命

プラグインファクトリは、入力で任意の lifecycle を受け取ります。インスタンスが破棄されるか、プラグインが退役すると、lifecycle.signal は中止します。タイマー、ウォッチャー、購読は lifecycle.onDispose(cleanup) で登録します。返された関数はその片付けを登録解除します。登録は最大 1 回実行されます。破棄後の登録は、すぐに片付けを始めます。片付けコールバックは登録の逆順で始まり、それぞれ 1 秒の予算を持ち、並行して終わることがあります。

変換フックは任意の第 3 引数 { signal } を受け取ります。設定フックとイベントフックは、それを第 2 引数として受け取ります。この信号は、コールバックが保留中の間に作業を取り消します。1 つのコールバックを超えてプラグインが所有する作業には lifecycle.signal を使います。中止可能な操作へ信号を渡してください。初期化、設定、イベント、変換のコールバックには 15 秒の期限があります。タイムアウトはそのインスタンスについてプラグインを退役させ、その寿命を中止します。既存のファクトリと 2 引数の変換フックは引き続き動きます。カスタムツール実行と対話的認証は、既存の実行契約を保ちます。

変換入力は、プレーンデータの読み取り専用の観察です。出力の下書きを変更し、戻る前にすべての変更を待ってください。成功した出力の変更は登録順に見えるようになります。失敗または遅れた変更は破棄されます。イベントペイロードの変更は決して公開されません。権限の拒否は拒否のままです。失敗または退役した権限フックは、拒否がすでに存在しない限り、確認を要求します。

配列とプレーンオブジェクトはランタイム状態から切り離されます。スキーマ、関数、クラスインスタンスは同一性を保ち、読み取り専用として扱わなければなりません。プラグインはランタイムプロセスで動く信頼された JavaScript のままです。取り消しは協調的であり、同期の無限ループを止めたり、外部効果を取り消したりはできません。

フックパック

フック で、5 つの公式ライフサイクルパック（format-after-edit、block-force-push、require-tests-on-stop、protect-env-files、log-bash-commands）を確認してください。

評価ハーネス

エージェント的ランタイムゲートスイートと、複数モードのアンサンブルポリシースイートを実行します。

cd packages/ax-code
pnpm exec vitest run test/harness/agentic-runtime-eval.test.ts
pnpm exec vitest run test/harness/multi-mode-ensemble-eval.test.ts

ローカル、クラウド、ハイブリッド、council、arena については、実行モード も参照してください。