附录

本章节提供 OpenCode Agent Skills 的参考资料和开发规范，帮助你编写高质量的技能并快速查阅 API 接口。

本章内容

页面	说明
技能开发最佳实践	掌握编写高质量技能的技巧和规范，包括命名规范、描述编写、目录组织、脚本使用等
API 工具参考	查看所有可用工具的详细参数和返回值，包括 get_available_skills、read_skill_file、run_skill_script、use_skill

学习路径建议

推荐顺序

1. 先学最佳实践 → 了解技能开发的规范和技巧，避免常见错误
2. 再查 API 参考 → 在实际开发中遇到问题时，查阅具体的参数和返回值

这两篇内容的定位不同：

• 最佳实践：适合在开始编写技能前通读一遍，建立正确的开发习惯
• API 参考：适合作为工具书，在需要时查阅具体细节

前置条件

建议先完成

在阅读本章节前，建议你已经：

• 完成 创建你的第一个技能，了解基本的技能结构
• 了解 技能发现机制，理解插件如何找到技能

下一步

完成本章节后，你可以：

• 查看 常见问题排查，解决使用中遇到的问题
• 了解 安全性说明，确保技能的安全性
• 回顾 版本历史，了解插件的演进和新功能