Skip to content

平台功能

本章節深入講解 OpenCode Agent Skills 的核心功能模組,包括技能發現、查詢、載入、自動推薦、腳本執行和檔案讀取。掌握這些功能後,你就能充分利用外掛的技能管理能力,讓 AI 更高效地服務於你的開發工作。

前置條件

開始前請確認

在學習本章節之前,請確保你已完成:

本章內容

課程說明核心工具
技能發現機制詳解理解外掛從哪些位置自動發現技能,掌握優先級規則-
查詢和列出可用技能使用 get_available_skills 工具查找和過濾技能get_available_skills
載入技能到會話上下文使用 use_skill 工具載入技能,理解 XML 注入機制use_skill
自動技能推薦理解語義匹配原理,讓 AI 自動發現相關技能-
執行技能腳本使用 run_skill_script 工具執行自動化腳本run_skill_script
讀取技能檔案使用 read_skill_file 工具存取技能的支援檔案read_skill_file

學習路徑

┌─────────────────────────────────────────────────────────────────────────┐
│                           推薦學習順序                                   │
├─────────────────────────────────────────────────────────────────────────┤
│                                                                         │
│   1. 技能發現機制  ──→  2. 列出可用技能  ──→  3. 載入技能               │
│         │                     │                    │                    │
│         │                     │                    │                    │
│         ▼                     ▼                    ▼                    │
│   理解技能從哪來        學會查找技能          掌握載入方法               │
│                                                                         │
│                              │                                          │
│                              ▼                                          │
│                                                                         │
│   4. 自動技能推薦  ←──  5. 執行腳本  ←──  6. 讀取檔案                   │
│         │                    │                  │                       │
│         ▼                    ▼                  ▼                       │
│   了解智能匹配          運行自動化          存取支援檔案                 │
│                                                                         │
└─────────────────────────────────────────────────────────────────────────┘

建議按順序學習

  1. 先學發現機制 - 理解技能從哪裡來,優先級如何決定
  2. 再學查詢技能 - 掌握 get_available_skills 工具的使用
  3. 然後學載入技能 - 理解 use_skill 和 XML 注入機制
  4. 接著學自動推薦 - 了解語義匹配如何工作(可選,偏原理)
  5. 最後學腳本和檔案 - 這兩個是進階功能,按需學習

快速上手路徑

如果你只想快速用起來,可以只學前三課(發現 → 查詢 → 載入),其他按需補充。

下一步

完成本章節後,你可以繼續學習:

  • 進階功能 - 深入了解 Claude Code 相容、Superpowers 整合、命名空間優先級等進階主題
  • 常見問題 - 遇到問題時查閱故障排查和安全說明
  • 附錄 - 查看 API 參考和最佳實踐