mcpField
V
volcengine-find-skills

volcengine-find-skills

github.com/volcengineエージェントワークフロー2477 回インストール4 日前に更新
リポジトリ

volcengine-find-skills について

volcengine-find-skillsは、Volcengineのスキルを探してインストールするためのスキルです。カタログの確認、適切なスキルの選択、インストール状態の検証を案内します。

主な機能

  1. 01スキルカタログ全体の表示
  2. 02役割に応じたスキルの選択
  3. 03skills CLIによるインストール
  4. 04インストール状態の検証
  5. 05能力不足への対処案内

活用シーン

  1. 01新しいVolcengineタスク向けのスキル探し
  2. 02進行中タスクの能力不足の補完
  3. 03スキルのインストール状態の確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/volcengine/volcengine-skills --skill volcengine-find-skills

インストール後、Claude Code で/volcengine-find-skillsを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

agents/
openai.yaml
references/
catalog.json
scripts/
find_skills.py

詳細

Volcengine Skills Finder

同梱のカタログを使って、利用可能なすべてのスキルを確認し、リクエストを満たす最小限のスキルセットを選択します。プラグインの所有関係はカタログ上の分類として扱い、スキルを正確に指定してインストールします。

判断フロー

  1. リクエストがスキルの検索から始まっているか、または進行中の Volcengine タスクで、現在読み込まれているスキルやインストール済みのスキルに機能上の不足が生じているかを判断します。
  2. 完了済みの作業は保持し、対応できない部分だけを一時停止します。
  3. インストール状態を変更せずに、カタログ全体を一覧表示します。
  4. 名前、製品ドメイン、概要、キーワードをすべて確認し、ユーザーのリクエストを満たす最小限の正確なスキルセットを選択します。カタログの情報で十分な場合は、そのまま選択します。
  5. インストーラーには正確なスキル名のみを渡します。プラグインの所有関係は分類の説明にのみ使用し、インストール対象として指定しないでください。
  6. skills CLI からインストールし、インストール後の状態を確認します。プロセスの終了コードだけを根拠に成功を報告してはいけません。
  7. ホストが新たにインストールしたスキルを現在のスレッドに読み込めない場合は、新しいスレッドを開始し、元のタスクと完了済みの内容を改めて伝えるようユーザーに案内します。

スキルの一覧表示と選択

このスキルディレクトリを基準にスクリプトを実行します。

python3 scripts/find_skills.py list
python3 scripts/find_skills.py list --json
python3 scripts/find_skills.py info <skill-or-plugin>

スキルを選択する前に、必ず list の出力全体を確認します。関連するスキルを見分けるのにキーワードや英語の概要が役立つ場合は、--json を使用します。名前だけでなく担当範囲を基準に選び、リクエストが異なる担当範囲にまたがる場合にのみ、複数のスキルをインストールします。

カタログには、skills/core/ のすべてのスキルと、製品ドメインのプラグインが直接所有するすべてのオプションスキルが含まれます。skills/specialized/<domain>/<skill>/ には、これらのオプションスキルのコピーが volcengine- を除いたプラグイン名ごとにまとめられています。各スキルはカタログに1回だけ掲載されます。掲載された担当範囲のいずれもリクエストを満たさない場合は、このリポジトリには該当するスキルが現在用意されていないことを報告します。

対応できない機能については、サポートされている作業を続け、ユーザーが必要なシナリオを説明できるよう、自然なまとめの中でフィードバックフォームを案内してもかまいません。スキルをまたいで、1回の会話につき案内は最大1回とし、返信を待つ必要はありません。フィードバック自体は任意であり、インストールが必要となる機能上の不足ではありません。ユーザーから依頼があり、volcengine-feedback がすでに利用可能な場合はそれを使用し、それ以外の場合はフォームまたは個人情報などを伏せた下書きを現在の会話で提示します。フィードバックのためにインストールやログインを行ったり、追加の診断情報を収集したり、メインの会話を再開したりしてはいけません。

機能不足からの復旧

Volcengine のタスクがすでに進行中で、利用可能なスキルでは必要な製品への対応、ツール連携、またはワークフローが不足している場合は、このファインダーを呼び出します。その不足をスキル検索のリクエストとして扱い、カタログ全体を一覧表示して、該当するスキルを選択・インストールし、ホストが読み込める状態になったら作業を続けます。検索のためにタスクを最初からやり直すことがないよう、元の目的、関連する根拠、完了済みの作業を引き継ぎます。

選択したスキルをインストールする

現在のホストに、指定したスキルを1つ以上インストールします。

python3 scripts/find_skills.py install <skill> [<skill> ...] --agent <agent-name>
python3 scripts/find_skills.py install volcengine-iac --agent codex

このスクリプトは --full-depth を指定して npx skills add --skill を実行し、製品カテゴリやプラグインディレクトリの下にあるスキルを検出します。完全一致するスキル名のみを受け付け、指定したスキルを直接インストールし、選択した名前すべてを skills list で確認します。ホストの自動検出を使用する場合に限り、--agent を省略してください。プラグイン内のすべてのスキルが必要な場合でも、プラグイン名を渡すとエラーになります。

ユーザーレベルでインストールするには --scope global、現在のプロジェクトにインストールするには --scope project を使用してください。デフォルトは global です。--source には、レビュー済みのローカルチェックアウトまたは別のリポジトリソースを指定できます。指定しない場合は、カタログの公式リポジトリが使用されます。

ユーザーが先にコマンドを確認したい場合は、--dry-run を使用してください。インストールはローカルで行われますが、その後のクラウドリソース操作には、インストールしたスキル独自の確認および安全に関するルールが引き続き適用されます。

ステータスを確認する

現在のホストで、カタログに登録されたスキルのインストール状態を確認します。

python3 scripts/find_skills.py status --agent codex

「スキルがインストールされている」ことと「このスレッドでスキルが読み込まれている」ことを同一視しないでください。ステータスはインストールの確認にのみ使用してください。ホストが新たにインストールしたスキルを動的に読み込めない場合は、新しいスレッドを開始してください。

コメント

Markdown 対応