Codex Skillsがインストールされていてトリガーされない場合は、まずスキャンディレクトリにあるか、SKILL.mdが完全なnameとdescriptionを持っているかを確認し、その後明示的に確認を呼びます。 ほとんどの問題は「スキル未発見」や「説明がタスクと一致しない」です。
ディレクトリは正しく設定され、ファイル名が変更されてはいけません
倉庫固有のスキルは以下の分野に位置しています:
$REPO_ROOT/.agents/skills/skill-name/SKILL.mdすべてのプロジェクトに必要な汎用的な個人スキルは以下の通りです:
~/.agents/skills/skill-name/SKILL.mdCodexは現在のディレクトリからリポジトリのルートディレクトリへ.agents/skillsをスキャンします。 倉庫外の隣接するディレクトリに配置されているスキルや、別々のスキルフォルダーが欠けている場合は検出不能かもしれません。
説明がいつ発動するかを決めます
最小限利用可能なファイルには、YAMLヘッダー情報を含めるべきです:
---
name: release-checker
description: Use when checking whether a web project is ready to release, including build, tests and rollback verification.
---
Follow the project release checklist and report every failed check.name 安定して名前の重複を避けること; description ユーザーの目標、トリガー条件、境界線を明確に述べてください。 「非常に有用な出版スキル」だけを書くには、対応するタスクシグナルがありません。重要なシナリオは説明の冒頭に配置すべきです。
明示的な呼び出しは2種類の問題を区別できます
CLIやIDE拡張機能で/skillsを入力してリストを表示するか、スキルを選択するには$と入力してください。 $release-checkerが選択・実行されていれば、インストールが正常に動作していることを意味します。最適化が必要なのはdescriptionです。 リストになければ、ディレクトリ、ファイル名、YAML形式を確認してください。
スキルの更新は通常自動的に発見されます。 リフレッシュがなければCodexを再起動してください。 スキルが多すぎると、初期リストはコンテキストバジェットによって制限され、説明が短縮され、一部のスキルが省略され、プロンプトが現れることもあります。 この時点で、関連のないスキルは無効化するか、必須スキルを明示的に発動させるべきです。
同じnameのスキルは自動的に統合されません。 まず/skillsでパスを確認し、正しいバージョンを保持してからテストします。
