Приложение
Этот раздел предоставляет справочные материалы и стандарты разработки для OpenCode Agent Skills, помогая вам писать качественные навыки и быстро находить справочные данные по API интерфейсам.
Содержание главы
| Страница | Описание |
|---|---|
| Лучшие практики разработки навыков | Освойте техники и стандарты написания качественных навыков, включая соглашения по именованию, написание описаний, организацию каталогов, использование скриптов и т.д. |
| Справочник по API инструментам | Просмотрите подробные параметры и возвращаемые значения всех доступных инструментов, включая get_available_skills, read_skill_file, run_skill_script, use_skill |
Рекомендации по учебному пути
Рекомендуемый порядок
- Сначала изучите лучшие практики → Узнайте стандарты и техники разработки навыков, чтобы избежать распространённых ошибок
- Затем ознакомьтесь с API справочником → При возникновении проблем в процессе разработки, просмотрите конкретные параметры и возвращаемые значения
Эти два раздела имеют разное назначение:
- Лучшие практики: Подходит для предварительного ознакомления перед началом написания навыков, чтобы сформировать правильные привычки разработки
- Справочник API: Подходит как справочник для быстрого поиска конкретных деталей при необходимости
Предварительные условия
Рекомендуется предварительно завершить
Перед изучением этого раздела рекомендуется, чтобы вы:
- Завершили Создание вашего первого навыка, понимая базовую структуру навыков
- Поняли Механизм обнаружения навыков, понимая, как плагин находит навыки
Следующие шаги
После завершения этого раздела вы можете:
- Просмотреть Устранение неполадок, чтобы решить проблемы, возникающие при использовании
- Узнать Соображения безопасности, чтобы обеспечить безопасность навыков
- Просмотреть Историю версий, чтобы понять эволюцию плагина и новые функции