カスタム Skills#

#概要

MeDo の公式 Skills は、AI ツール、決済サービス、動画技術、音声・画像処理、テキスト処理、地図サービス、情報検索、ログイン認証など、幅広いシナリオをすでにカバーしています。これにより、タスクを効率よく完了し、機能豊富なアプリを構築できます。

ただし、公式 Skills だけでは、より専門的な業務要件や高度にカスタマイズされた要件を完全には満たせない場合があります。そこで MeDo は カスタム Skills を提供しています。.zip skill package をアップロードするだけでカスタム Skill をすばやく作成でき、タスク実行やアプリ生成の中で柔軟に呼び出せます。

カスタム Skills を使うと、MeDo により豊富で専門的な機能や領域知識を持たせることができ、専門タスクをより効果的に完了したり、ビジネスニーズにより合ったアプリを構築したりできます。

#外部 API 連携

現在、MeDo は API ドキュメントリンクや API 説明から直接カスタムプラグインを作成する方法を一時的に削除しています。外部 API を連携したい場合は、現時点では以下の方法を利用できます。

今後、MeDo は会話を通じて API をカスタムプラグインへ直接変換できるようになる予定です。作成後は、タスク実行やアプリ生成で素早く利用できます。今後のアップデートをお待ちください。

#会話内で直接連携する

会話内で API の説明または API ドキュメントリンクを直接提供すると、MeDo が API 連携を支援します。

例：

以下の API を使用して天気検索アプリを生成してください。

https://openweathermap.org/api/current?collection=current_forecast

#会話または「Skill Creation & Editing」Skill で skill package を生成する

会話内で "@Skill Creation & Editing" Skill を指定し、API 説明または API ドキュメントリンクを貼り付けます。MeDo が API を skill package に変換し、ダウンロードして Custom Skills にインポートできるようにします。

提供する API 説明はできるだけ完全にしてください。推奨構成と必要情報については、以下の例を参考にしてください。

例：

@Skill Creation & Editing を使用して、以下の API ドキュメントから .zip 形式の天気検索 skill package を作成してください。

Plugin Name：Weather Query

Plugin Description：都市名に基づいて、気温、湿度、天気状況を含むリアルタイム天気情報を取得します。

Request Method：GET

Full Request URL：
https://api.example.com/v1/weather?city=Beijing&unit=C

Request Header：Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.FAKE_PAYLOAD.SIGNATURE_FAKE

Request Parameters：
city：必須。都市名。例：Beijing
unit：任意。温度単位。C または F。デフォルトは C

Request Example (curl):
curl -X GET "https://api.example.com/v1/weather?city=Beijing&unit=C" -H "Authorization: Bearer YOUR_API_KEY"

#成功レスポンス例

{
  "city": "Beijing",
  "temperature": 18,
  "unit": "C",
  "condition": "Cloudy",
  "humidity": 62
}

#エラーレスポンス例

{
  "error": "invalid_city",
  "message": "City not found"
}

#エラーコード

• invalid_city：都市が存在しません（HTTP 404）
• missing_city：都市パラメータがありません（HTTP 400）
• invalid_unit：温度単位が無効です（HTTP 400）
• unauthorized：認証に失敗しました（HTTP 401）
• rate_limited：リクエストが多すぎます（HTTP 429）
• server_error：サーバーエラー（HTTP 500）

#直接インポートして作成する

API を含む skill package をすでに用意している場合は、Custom Skills に直接インポートできます。詳しい手順は以下のセクションを参照してください。

#カスタム Skills を作成する

次の場所へ移動してください：【My Skills > Create Skill】

#Skills をアップロードする

#Skill アップロード形式の要件

Skill Creation & Editing ページに入ったら、アップロードエリアをクリックするか、ファイルをドラッグして、.zip Skill Package または SKILL.md ファイルをアップロードできます。Skill Package と SKILL.md ファイルはいずれも、以下の標準 SKILL 形式に従う必要があります。

.zip Skill Package の推奨構成：

• SKILL.md（必須。skill 定義ファイル）
• Additional Resources（任意）
• scripts/（Scripts）：Python や Shell の自動化スクリプトなどの実行可能コード
• references/（Reference Materials）：製品ドキュメント、業務ルール、ナレッジベース内容など
• assets/（Assets）：テンプレート、アイコン、フォント、画像、その他リソースファイル

financial-analysis.zip
└── financial-analysis/
    ├── SKILL.md           # 必須。skill 定義ファイル
    ├── scripts/           # 任意。スクリプト
    │   └── analyze.py
    ├── references/        # 任意。参考資料
    │   └── knowledge.md
    └── assets/            # 任意。アセット
        └── icon.png

SKILL.md 構造例：

---
name: skill-name
description: |
  Briefly describe the capability and applicable scenarios of this Skill.
  Use when: (1) Scenario One, (2) Scenario Two
---

## Purpose

Describe the core objective of this Skill.

## Instructions

Define the execution workflow and behavior rules of this Skill.

## Examples

Input: xxx

Output: xxx

## Guardrails

Define usage boundaries and limitations.

SKILL.md 完全な例：

---
name: financial-analysis
description: |
  Analyze enterprise financial data and generate insights.
  Use when: (1) Financial report analysis, (2) Company comparison, (3) Risk identification
---

## Purpose

Help users analyze financial data, identify business trends, and detect potential risks.

## Instructions

1. Understand the user's input data or questions
2. Analyze key financial indicators
3. Generate structured conclusions

## Examples

Input: Financial reports from the past three years of a company

Output: Revenue trends, profit changes, and risk alerts

## Guardrails

- Do not fabricate data
- Ask follow-up questions when data is insufficient

#注意事項

.zip Skill Packages と SKILL.md ファイルを MeDo にアップロードする際は、以下の形式要件が適用されます。

Frontmatter の例：

---
name: financial-analysis
description: |
  Analyze enterprise financial data and generate business insights.
  Use when: (1) Financial report analysis, (2) Company comparison
---

## Instructions

1. Analyze user input
2. Extract key indicators

......

アップロードが完了すると、MeDo は提供された内容に基づいて skill を解析し、設定します。この処理には通常 1 分ほどかかります。解析中はページを離れないでください。

解析に成功すると、画面に skill 設定が表示されます。詳しくはセクション 2 を参照してください。解析に失敗した場合、MeDo は解析を停止し、理由を説明します。

#設定を編集する

解析に成功すると、画面に skill 設定が表示されます。

#基本情報

MeDo は、アップロードされた skill package に基づいて、skill アイコン、skill 名、skill 説明を自動設定します。

図：

#環境変数

skill に環境変数が含まれている場合、Environment Variables モジュールが表示されます。環境変数は、API Keys など、skill の実行に必要な設定値です。設定後、skill は実行中にこれらの値を安全に読み取り、外部に公開しません。

項目	説明	図
Name	skill 呼び出し時に使用される環境変数名です。この値は MeDo が自動生成し、変更できません。
Value	Name に対応する値です。入力すると、skill は呼び出し時にこの設定を自動使用します。空欄のままにした場合、プロジェクトで skill を使用する際に手動設定が必要です。

#Skill Definition

Skill Definition は、MeDo がこの skill をアプリに組み込むための中核的な根拠です。アップロードされた skill package に基づいて自動生成され、手動では変更できません。

生成後は、必要なファイルがすべて含まれているか、ファイル内容が正確かなど、内容が期待どおりかを確認できます。API ベースの skills の場合は、必要なすべての endpoint、endpoint 説明、例が完全かどうかも確認してください。

生成結果が期待どおりでない場合は、対応する skill ファイルを修正し、再アップロードして解析してください。

#作成を完了する

すべての情報を設定したら、Create をクリックしてカスタム skill の作成を完了します。

#カスタム Skills を使う

#Skills をテストする

作成が完了したら、アプリ内で skill を呼び出してテストできます。「@」を使って自分のカスタム skills を見つけ、直接呼び出せます。

#カスタム Skill が正しく呼び出せるかテストする

skill を呼び出してアプリや機能を生成した後、左サイドバーの Used Skills 一覧で、その skill が使用されたかを確認できます。

状況	説明	図
使用済み	Used Skills 一覧に skill が表示されている場合は、機能テストへ進めます。
未使用	skill が使用されていない場合は、もう一度呼び出して機能またはアプリを再生成してみてください。それでも呼び出せない場合は、skill 設定ページに戻り、Skill Definition 内の endpoint 名と説明が想定する利用シナリオに正しく合っているか確認します。合っていない場合は、上部入力欄の説明を改善し、Skill Definition を再生成してください。

#カスタム Skills の利用可否をテストする

カスタム skill を正常に呼び出せたら、次に生成された機能が正しく動作するかをテストします。

たとえば、カスタム燃料価格検索 skill を作成した場合、実際に燃料価格を正しく取得できるかをテストしてください。

状況	説明	図
機能が正常に動作する	使用可能なカスタム skill を正常に作成できたことを意味し、アプリ全体で利用できます。	/
機能が正常に動作しない	認証情報の誤り、または生成品質の問題が原因である可能性があります。まず、提供した認証情報が正しいか確認してください。問題が続く場合は、会話を通じて修正してみてください。会話で修正できる場合、カスタム skill 自体は利用可能である可能性が高いです。 複数回の会話でも問題が解決しない場合は、カスタム skill definition 自体に問題がある可能性があります。skill 設定ページに戻り、API ドキュメントが完全かどうかを確認してください。endpoint 定義、endpoint のパスとメソッド、リクエストパラメータ、リクエスト例、レスポンス例、エラーコード、説明が含まれている必要があります。不足情報がある場合は説明を更新し、skill definition を再生成してください。

#正式利用

skill がテストに合格したら、アプリ全体で正式に利用できます。

ただし、実際の利用時には、要件説明が不明確であるなどの要因により、生成された機能が 1 回で高い実用性に達しないことがあります。そのため、テストに成功した後でも、skill 関連の機能が期待どおりに動作しない場合があります。そのような場合は、会話を通じて問題を修正できます。

#カスタム Skills を管理する

作成した skills は、次の場所から管理できます。

【Skills > My Skills > 対象 Skill】

ここでカスタム skills の設定または削除ができます。

Skill > My Skills から skill を削除すると、その skill は新しいアプリや機能の生成には使用できなくなります。ただし、すでにその skill を使用しているアプリには影響しません。

既存アプリでもその skill の使用を停止したい場合は、対象アプリから skill を削除してください。削除後、そのアプリはその skill を使用しなくなります。