mcpField
V
volcengine-find-skills

volcengine-find-skills

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

volcengine-find-skills について

Volcengine のスキルを検索・インストールするためのスキルです。カタログ全体を確認してタスクに合う最小限のスキルを選び、`skills` CLI で導入した後、インストール状態を検証します。

主な機能

  1. 01スキルカタログ全体の表示
  2. 02役割とキーワードによる絞り込み
  3. 03要件を満たす最小セットの選定
  4. 04`skills` CLI によるインストール
  5. 05インストール状態の確認

活用シーン

  1. 01Volcengine のタスクに合うスキルの検索
  2. 02進行中のタスクで不足する機能の補完
  3. 03スキル導入コマンドの事前確認
  4. 04現在のホストでの導入状態の確認

インストール

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

$npx skills add https://github.com/volcengine/volcengine-agent-toolkit --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回までにします。フィードバック自体は任意であり、インストールが必要な機能不足ではありません。volcengine-feedback がすでに利用可能で、ユーザーから求められた場合はそれを使います。それ以外の場合は、この会話内でフォームまたは機密情報を伏せた草案を提示します。フィードバックのためにインストール、ログイン、追加の診断情報の収集、メインの会話の再開を行ってはいけません。

機能不足からの復旧

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

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

現在のホストに、指定したスキルを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 対応