自訂技能

官方技能（Skill）已涵蓋常見範疇——影片、圖像、語音、付款、地圖、搜尋、登入、生產力。自訂技能則用於它們未涵蓋的部分：你公司的審查清單、文案的統一風格、內部 API、只有你團隊在跑的工作流程。建立之後，自訂技能的調用方式與官方技能完全相同，無論是在建立應用程式時還是在通用任務中。

#兩種建立方式

點擊側欄的 Skill（技能），再點擊 Skill Center 頂部的 Create skill（建立技能）。你會回到主頁，而提示欄已切換到 Skill Creation（技能建立） 模式：

#用文字描述

把「Create a skill with the following details:」這句話補完並送出。說明這個技能的用途、MeDo 應在什麼情況下使用它、它應該逐步做什麼，以及它絕對不能做什麼。輸入框下方的範例卡片（Security Review、Copy Refinement、Product Review）展示了有效的詳細程度。MeDo 會草擬技能、向你展示結果，並讓你在同一對話中細化，然後才儲存到 My Skills（我的技能）。

#匯入套件

點擊 Import Skill（匯入技能），然後選擇一個 .zip 技能套件或單一 SKILL.md 檔案。MeDo 會讀取套件、填入名稱、描述和圖示，偵測所需的環境變數，並生成技能定義。檢查結果、填入任何 API 金鑰的值，然後儲存。

#包裝外部 API

MeDo 目前還不能自行把 API 文件連結轉換成技能。你有三個選擇：

若採用第二種做法，請提供開發者所需的全部資訊。一份好的 API 描述包含：

Skill name: Weather Query
Skill description: Real-time weather by city name — temperature, humidity, conditions.

Method: GET
URL: https://api.example.com/v1/weather?city=Beijing&unit=C
Header: Authorization: Bearer YOUR_API_KEY

Parameters:
  city  — required, city name
  unit  — optional, C or F, default C

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

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

Error codes: invalid_city (404), missing_city (400), invalid_unit (400),
             unauthorized (401), rate_limited (429), server_error (500)

切勿把真實金鑰貼進描述。請使用佔位符；技能建立後，你會以環境變數的形式輸入真實的值。

#技能套件格式

無論是手動撰寫套件還是讓 MeDo 生成，都必須遵循以下結構：

financial-analysis.zip
└── financial-analysis/          # root folder name must equal the `name` field
    ├── SKILL.md                 # required
    ├── scripts/                 # optional: Python or shell scripts
    ├── references/              # optional: documentation, rules, knowledge
    └── assets/                  # optional: templates, icons, images

SKILL.md 以 frontmatter 開頭，然後描述技能：

---
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 會被拒絕並顯示原因；修正檔案後再匯入一次即可。

#MeDo 會填入的內容

成功匯入（或透過對話建立技能）之後，技能頁面會顯示：

• 基本資料——名稱、描述和圖示，取自套件。這些會顯示在 My Skills、@ 清單以及應用程式的 Skill 檢視中。
• 環境變數——技能所需的每個金鑰各佔一項。變數名稱由系統生成且固定；在此輸入值，讓每次調用都能使用。如果留空，你首次在專案中使用該技能時會被要求提供值。
• 技能定義——MeDo 用來把技能接入應用程式的機器可讀描述，由套件生成，不能手動編輯。請至少讀一遍：對於 API 技能，每個端點、其參數和一個範例都應在其中。如果缺少任何內容，請修正來源檔案並重新匯入。

#測試技能

1. 在任何專案中輸入 @，從清單頂部選擇你的技能，然後描述一項會用到它的小任務。
2. 開啟編輯器左側欄的 Skill 檢視。如果你的技能出現在清單中，代表 MeDo 已使用它。
3. 試用它產生的功能。對於 API 技能，請確認真實調用能返回真實資料。

如果技能沒有出現在清單中，代表 MeDo 認為它不相關：請把 description 和端點描述改得更貼近你提出請求的措辭，然後重新匯入。如果它在清單中但功能失敗，請先檢查 API 金鑰的值，然後在對話中描述失敗情況——MeDo 通常能修正調用。如果問題持續，說明 API 描述缺少了某些內容（某個參數、範例回應或錯誤碼）。

#管理你的技能

Skill → My Skills 列出你的自訂技能。開啟其中一個即可更改其環境變數或刪除它。

刪除技能後，它將不再用於新的應用程式和任務。已在使用它的應用程式會繼續正常運作；如果你想徹底移除，請透過各應用程式的 Skill 檢視逐一移除。