Skill 管理
Skill は Super Agent のプラグイン可能な能力ユニットです。管理者はプラットフォーム上で組織レベルの Skills を一元管理し、Super Agent に再利用可能な能力モジュールを提供できます。
ユーザーのリクエストが特定の形式、固定ワークフロー、またはドメイン規範に関わる場合、Super Agent は一時的にルールを組み立てるのではなく、対応する Skill に優先的にルーティングします。
Skill の種類
Skill は 2 種類に分かれます。
- プロンプト型 Skill：
SKILL.mdのみを含み、実行スクリプトは含みません。本質的には構造化されたシステムプロンプトです。 - 実行型 Skill：
SKILL.mdに加えて、scripts/、manifest.json、skill.runtime.jsonなどの実行メタデータを含みます。
管理入口と一覧表示
- スキル管理ページに入ります：組織ワークスペース -> Skills 管理 に移動します。
- システムは、アップロード済みのすべてのスキルの名称と説明をカード形式で表示します。
一般的なスキルパッケージの例：
pdf：PDF ファイルの読み取り、解析、または処理を行います。xlsx：スプレッドシートの読み書きを行い、構造化データを処理します。slides-json-generator：PPT/スライドに必要な JSON データを生成します。Chart Generator：入力データに基づいてグラフ（棒グラフ、折れ線グラフ、円グラフなど）を生成します。
スキルパッケージの追加
スキル管理では、ローカルからスキルパッケージをアップロードして、組織の能力を拡張できます。
- スキル管理ページで 作成 をクリックします。
- ローカルファイルを選択するか、直接ドラッグ＆ドロップでアップロードします。
- アップロード完了後、スキル一覧に戻ってインポート成功を確認します。
ヒント：スキルをアップロードした後、Super Agent の管理設定で関連付けを行う必要があります。そうして初めて、実行時に自動認識および呼び出しが行われます。
アップロード制限
- 1 回のアップロードで可能なスキルパッケージ数：1 個
- スキルパッケージ対応形式：
.zip/.skill/.md - スキルパッケージのサイズ制限：50 MB
スキル設定
スキルをインポートした後、業務要件に応じて設定を調整できます。
- スキル一覧で対象スキルを選択します。
- ✏️ をクリックして設定ページに入り、スキルパッケージを再アップロードできます。
プラットフォーム実行時の能力と境界
プラットフォームが自動処理する内容
- 環境変数の注入（
SKILL_DIR、SKILL_OUTPUT_DIRなど） - ベアファイル名の解析（優先
workspace/、次に履歴runs/） - 既知のパス引数の書き換え（
skill.runtime.jsonに由来） - 作業ディレクトリの切り替え（
skill/workspace/output） output_patternsとmanifestに基づく artifact の自動検出
プラットフォームが安全に推論できない内容
- どの位置引数がファイルパスか（Skill が
path_argsを宣言していない場合） - サードパーティ CLI が誤解を招く終了コードを返すかどうか
- スクリプトが
workspace、前回実行ディレクトリ、または Skill パッケージ内リソースのどこから読み取るべきか - どの生成ファイルが最終成果物か（
output_patternsまたはmanifest outputsが宣言されていない場合）
セキュリティ境界
- 必ずプラットフォームのサンドボックス内で実行する必要があり、スクリプトが業務ホスト上で実行されることを前提にしてはいけません。
- Skill による依存関係のセルフインストールはサポートされず、
requirements.txt/package.jsonに依存しません。 - 追加の依存関係が必要な場合は、プラットフォームに事前インストールを依頼してください。
スクリプトの実行方法は以下のとおりです：
| 言語 | 実行方法 | 要件 |
|---|---|---|
.py | プラットフォームが runpy.run_path() を通じて読み込み実行 | 特別な要件なし |
.sh / .bash / .js などその他の言語 | 実行可能ファイルとして直接実行（subprocess.run([script])） | shebang（例：#!/usr/bin/env bash）が必須で、かつ実行権限を持つこと |
注意：プラットフォームは拡張子に基づいてインタープリタを自動選択しません。Python 以外のスクリプトで shebang または実行権限が不足している場合、直接実行に失敗します。入口として Python スクリプトを使用し、そこから他言語を呼び出す方法を推奨します。
プラットフォームの他機能との関係
- 現在の Skill の位置付けとセキュリティモデルに基づき、Skill を通じてプラットフォームのデータベースやプラットフォーム API に直接アクセスすることはサポートされていません。
- 外部サービスインターフェースにアクセスする場合は、MCP 接続の利用を優先的に推奨します。
- Skill は「呼び出すかどうか」「いつ呼び出すか」というオーケストレーションに重点を置いており、MCP の認証管理やアクセス制約を代替するものではありません。
- Skill を通じて Super Agent に
curlリクエストを送信させる必要がある場合は、サンドボックス内でアクセスホワイトリストを設定する必要があります。
サンドボックスのプリインストール依存関係
Universal Sandbox イメージには一部の依存関係があらかじめインストールされており、Skill スクリプトは追加インストールなしで直接 import / require して使用できます。
イメージソースファイル：
serviceme-sandbox/docker/images/universal-sandbox/