技能管理
技能管理
概述
**技能（Skills）**是預封裝的專業能力模組，每個技能透過 SKILL.md 檔案宣告身分、觸發條件與執行邏輯。系統預置 21 項技能，使用者還可以建立自訂技能或使用企業統一部署的技能。
21 項預置技能
Office 文件類（4 項）
| 技能 | 說明 |
|---|---|
| docx | Word 文件生成與編輯 |
| xlsx | Excel 表格建立與處理 |
| pptx | PowerPoint 簡報製作 |
| PDF 文件處理 |
搜尋類（4 項）
| 技能 | 說明 |
|---|---|
| web-search | 網頁搜尋，取得即時資訊 |
| films-search | 影視作品搜尋 |
| music-search | 音樂搜尋 |
| technology-news-search | 科技資訊搜尋 |
設計類（3 項）
| 技能 | 說明 |
|---|---|
| canvas-design | 畫布設計，可視化創意生成 |
| frontend-design | 前端介面設計與程式碼生成 |
| remotion | 程式化影片生成（基於 Remotion 框架） |
AI 生成類（2 項）
| 技能 | 說明 |
|---|---|
| seedance | AI 影片／舞蹈生成 |
| seedream | AI 圖像生成 |
開發類（2 項）
| 技能 | 說明 |
|---|---|
| develop-web-game | Web 小遊戲開發 |
| playwright | 瀏覽器自動化測試與操作 |
工具類（4 項）
| 技能 | 說明 |
|---|---|
| create-plan | 建立結構化計畫 |
| scheduled-task | 定時任務建立與管理 |
| local-tools | 本地工具集（系統資訊、檔案操作等） |
| imap-smtp-email | 郵件收發（IMAP/SMTP 協定） |
其他（2 項）
| 技能 | 說明 |
|---|---|
| weather | 天氣資訊查詢 |
| skill-creator | 元技能 — 透過對話建立新技能 |
技能載入機制
目錄掃描
系統自動掃描 SKILLs/ 目錄，每個子目錄包含一個技能：
SKILLs/
├── web-search/
│ ├── SKILL.md ← 技能宣告檔案
│ └── ... ← 輔助檔案
├── docx/
│ ├── SKILL.md
│ └── ...
└── ...
SKILLs/
├── web-search/
│ ├── SKILL.md ← 技能宣告檔案
│ └── ... ← 輔助檔案
├── docx/
│ ├── SKILL.md
│ └── ...
└── ...
此代碼塊在浮窗中顯示
SKILL.md 規範
每個技能的 SKILL.md 檔案宣告：
- 技能名稱與描述
- 觸發條件：在什麼情況下自動啟用此技能
- 執行邏輯：技能的具體行為與能力
載入方式
技能在對話中以 execute_skill_{id} 的形式注入為工具，Agent 根據任務需要自動選擇呼叫。使用者也可在 PromptInput 中手動選擇啟用的技能。
技能狀態管理
| 狀態 | 說明 |
|---|---|
| 已啟用 | 對話中可被 Agent 呼叫 |
| 已停用 | 不出現在工具列表中 |
技能啟用狀態儲存在 skill_states.json 中，可在設定頁面切換。
自訂技能
透過 skill-creator 元技能，使用者可以在對話中建立新技能：
- 在對話中描述想要建立的技能功能
- skill-creator 自動生成
SKILL.md與輔助檔案 - 新技能出現在技能列表中
也支援從以下來源安裝：
- 本地目錄：直接放置到
SKILLs/目錄 - Git 儲存庫：複製到本地
- ZIP 檔案：解壓縮到技能目錄
企業技能
工作空間管理員可透過企業資源統一發布技能到組織：
| 特性 | 說明 |
|---|---|
| 組織隔離 | 企業技能按 orgId 隔離，不同組織不互通 |
| 自動同步 | APP 端定期（30 分鐘）從後端同步企業技能 |
| 安全級別 | 企業技能可設定安全級別限制 |
操作指南
如何啟用/停用技能
- 開啟 APP → 設定 → 技能
- 瀏覽技能列表，每個技能旁有啟用/停用開關
- 切換開關即可
影響：
- 啟用技能 → Agent 在對話中可以呼叫該技能。例如啟用
web-search後，Agent 可以搜尋網頁取得即時資訊。- 停用技能 → Agent 完全不知道該技能存在。例如停用
web-search後，Agent 只能依賴自身知識回答，無法取得最新資訊。
啟用/停用的實際效果範例
| 技能 | 啟用時 Agent 能做什麼 | 停用時的影響 |
|---|---|---|
| web-search | 搜尋網頁取得最新資訊 | Agent 無法取得即時資訊，可能給出過時的回答 |
| docx | 生成 Word 文件並提供下載 | Agent 只能輸出純文字，無法建立格式化文件 |
| playwright | 自動控制瀏覽器（截圖、表單填寫、爬取） | Agent 無法操作瀏覽器 |
| seedream | 生成 AI 圖像 | Agent 無法生成圖片 |
| imap-smtp-email | 收發郵件 | Agent 無法處理郵件相關任務 |
| scheduled-task | 建立定時自動執行的任務 | Agent 無法設定定時任務 |
如何建立自訂技能
使用內建的 skill-creator 元技能：
- 確保
skill-creator技能已啟用 - 在 Work 對話中描述你想要的技能，例如：「幫我建立一個技能，可以自動格式化 JSON 檔案」
- skill-creator 會生成
SKILL.md與輔助檔案 - 新技能自動出現在技能列表中，可以啟用使用
也可以手動建立：將包含 SKILL.md 檔案的目錄放入 SKILLs/ 資料夾。
常見問題
技能列表中看不到企業技能
企業技能每 30 分鐘從後端同步一次。可以嘗試重啟 APP 觸發立即同步。確認工作空間管理員已在企業資源中發布了技能。
啟用了技能但 Agent 沒有使用
Agent 根據任務需求自主決定是否呼叫技能。可以在對話中明確指示：「請使用 web-search 技能搜尋最新的 React 版本」。