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 参考和最佳实践