UXC スキル

タスクがリモートインターフェースを呼び出す必要があり、エンドポイントがマシン読み取り可能なスキーマメタデータを公開できる場合、このスキルを使用します。

使用時機

• 別のスキルから API/ツールを呼び出す必要があり、1 つの一貫した CLI ワークフローを望む。
• インターフェースが OpenAPI、GraphQL、gRPC リフレクション、MCP、または JSON-RPC/OpenRPC である可能性がある。
• 決定論的でマシン読み取り可能な出力（ok、kind、data、error）が必要。

リモートインターフェースを伴わない純粋なローカルファイル操作にはこのスキルを使用しないでください。

ドキュメント検索とサポート

• UXC ドキュメントは https://uxc.holon.run/api/search?q=<query> でフルテキスト検索に対応しています。
• 操作名、認証フラグ、またはプロトコル動作が不明確な場合は、まずドキュメント検索を優先してください。
• ドキュメントが不明確または動作が不正な場合は、holon-run/uxc でイシューを作成してください：
  • https://github.com/holon-run/uxc/issues/new/choose
  • より迅速なトリアージのため、コマンド、エンドポイント、および JSON エンベロープ（ok、error、meta）を含めてください。

前提条件

• uxc がインストールされており、PATH で利用可能。
• gRPC ランタイム呼び出しの場合、grpcurl がインストールされており、PATH で利用可能。

uxc をインストール

以下のいずれかの方法を選択してください：

Homebrew（macOS/Linux）：

brew tap holon-run/homebrew-tap
brew install uxc

インストールスクリプト（macOS/Linux、実行前に確認してください）：

curl -fsSL https://raw.githubusercontent.com/holon-run/uxc/main/scripts/install.sh -o install-uxc.sh
# スクリプトを実行する前に確認してください
less install-uxc.sh
bash install-uxc.sh

Cargo：

cargo install uxc

その他のオプションについては、UXC README のインストールセクションを参照してください。

コアワークフロー

1. 操作を検出：
   • uxc <host> -h
2. 特定の操作を検査：
   • uxc <host> <operation> -h
3. 構造化入力で実行：
   • uxc <host> <operation> key=value
   • uxc <host> <operation> '<payload-json>'
4. JSON エンベロープとして結果を解析：
   • 成功：.ok == true、.data を取得
   • 失敗：.ok == false、.error.code と .error.message を確認
5. 曖昧さを解決するため、まず操作レベルのヘルプを使用：
   • uxc <host> <operation> -h
6. 認証が必要なエンドポイントの場合、適切な認証トラックを使用：
   • シンプルなベアラー / シングルシークレット API キー：references/auth-configuration.md を参照
   • 複数フィールド認証またはリクエスト署名：references/auth-configuration.md を参照
   • OAuth フロー：references/oauth-and-binding.md を参照

ラッパースキル用リンクファースト ワークフロー

ラッパースキルは、毎回直接 uxc <host> ... を呼び出すのではなく、固定的なローカルリンクコマンドをデフォルトにすべきです。

1. スキル開発中に固定的なコマンド名を選択：
   • 命名規則：<provider>-mcp-cli
   • 例：notion-mcp-cli、context7-mcp-cli、deepwiki-mcp-cli
2. コマンドが既に存在するかを確認：
   • command -v <link_name>
3. コマンドが見つからない場合は作成：
   • uxc link <link_name> <host>
   • OpenAPI サービスのスキーマが個別の固定 URL でホストされている場合は、uxc link <link_name> <host> --schema-url <schema_url> でリンクを作成
   • 認証情報駆動の子環境認証が必要な stdio ホストの場合は、uxc link <link_name> <host> --credential <credential_id> --inject-env NAME={{secret}} でリンクを作成
   • リンクがラッパースキルの一部として作成される場合は、--skill <skill_name> --skill-doc <docs_url> --skill-path <local_skill_path> でソースメタデータを永続化して、後のヘルプ出力がスキルコンテキストを保持するようにする。
4. リンクコマンドを検証：
   • <link_name> -h
5. スキルフロー全体でリンクコマンドのみを使用。

既存 MCP 設定をまず インポート

MCP サーバーが既にサポートされているエディターまたはローカルエージェントで設定されている場合は、新しいリンクを手書きする前にインポートを優先してください：

• インポートをプレビュー：
  • uxc config import mcp --dry-run
• 一般的な MCP 設定ソースを自動検出・インポート：
  • uxc config import mcp --from auto
• 特定のソースプリセットからインポート：
  • uxc config import mcp --from cursor
  • uxc config import mcp --from codex

v1 でサポートされているプリセット：

• auto
• cursor
• claude-code
• claude-desktop
• vscode
• codex
• windsurf
• opencode

命名ガバナンス

• リンク命名はランタイムエージェント決定ではなく、スキル作成者の決定。
• スキル開発/レビュー中にエコシステムの競合を解決。
• ランタイムスキルフロー内で動的なリネームロジックを実装しない。
• ランタイムが安全に再利用できないコマンド競合を検出した場合は、停止してスキルメンテナーの介入を要求。

等価性ルール

• <link_name> <operation> ... は uxc <host> <operation> ... と等価。
• リンクが --schema-url <schema_url> で作成された場合は、uxc <host> --schema-url <schema_url> <operation> ... と等価。
• リンクが --credential <credential_id> --inject-env NAME={{secret}} で作成された場合は、uxc --auth <credential_id> --inject-env NAME={{secret}} <host> <operation> ... と等価。
• 呼び出し側は実行時に --schema-url <other_url> を明示的に渡すことで、永続化されたスキーマをオーバーライド可能。
• リンクセットアップが利用できない場合のみ、一時的なフォールバックとして uxc <host> ... を使用。

入力モード

• 推奨（シンプルなペイロード）：キー/バリュー
  • uxc <host> <operation> field=value
• ベア JSON ポジショナル：
  • uxc <host> <operation> '{"field":"value"}'

生の JSON を --args で渡さない；ポジショナル JSON を使用してください。

再利用のための出力コントラクト

他のスキルはこのスキルをインターフェース実行レイヤーとして扱い、安定したエンベロープのみを使用する必要があります：

• 成功フィールド：ok、kind、protocol、endpoint、operation、data、meta
• 失敗フィールド：ok、error.code、error.message、meta

デフォルト出力は JSON です。エージェント自動化パスで --text を使用しないでください。

他のスキルの再利用ルール

• スキルがリモート API/ツール実行を必要とする場合は、プロトコル固有の呼び出しロジックを埋め込む代わりにこのスキルを再利用してください。
• ラッパースキルは固定的なリンクコマンド（<provider>-mcp-cli）をデフォルト呼び出しパスとして採用すべき。
• アップストリームスキル入力は以下に限定：
  • ターゲットホスト
  • 操作 ID/名
  • JSON ペイロード
  • .data から抽出する必須フィールド

リファレンスファイル（オンデマンドで読み込み）

• ワークフロー詳細と段階的呼び出しパターン：
  • references/usage-patterns.md
• 生成されたランタイムクライアントフロー：
  • https://uxc.holon.run/ecosystem/typescript-client/
• プロトコル操作命名クイックリファレンス：
  • references/protocol-cheatsheet.md
• パブリックエンドポイント例と利用可能性に関するメモ：
  • references/public-endpoints.md
• 認証設定（シンプルな secret、名前付き fields、ヘッダー/クエリパラメータ、リクエスト署名者）：
  • references/auth-configuration.md
• OAuth と認証情報/バインディングライフサイクル：
  • references/oauth-and-binding.md
• 失敗処理と再試行戦略：
  • references/error-handling.md