Перейти к содержанию

Продвинутые техники

1. Навыки со скриптами

Добавьте скрипты для автоматизации:

my-skill/
├── SKILL.md
└── scripts/
    ├── setup.sh
    ├── deploy.py
    └── test.sh

В файле SKILL.md нужно сослаться на них:

...
## Scripts

Для выполнения используй абсолютные пути:

    ```bash
    /home/user/project/.koda/skills/my-skill/scripts/setup.sh
    python3 /home/user/project/.koda/skills/my-skill/scripts/deploy.py
    ```

Не используй относительные пути!
...

2. Навыки с шаблонами

Создайте библиотеку шаблонов:

react-component/
├── SKILL.md
└── assets/
    ├── functional.tsx
    ├── with-hooks.tsx
    └── with-context.tsx

В файле SKILL.md нужно сослаться на них:

...
## Templates

Используй шаблоны из директории assets/:

- `functional.tsx` — базовый функциональный компонент
- `with-hooks.tsx` — компонент с хуками
- `with-context.tsx` — компонент с Context API
...

3. Комбинация навыков

Комбинируйте несколько навыков:

Вы: Создай CRUD API для пользователей
Модель: [использует python-api + db-migration]

Для этого опишите в навыке ссылки на другие:

## Related Skills

- `db-migration` — для создания миграций БД
- `git-commit` — для коммита изменений

Преимущество: связывая навыки между собой, можно подсказывать модели, что в данном случае конкретный навык подойдёт лучше остальных. Через это модель быстрее узнает какой навык следует загрузить в ближайшее время.

4. Декомпозиция навыков

В основном файле SKILL.md описывайте основные инструкции, а технические детали и подробности описывайте в отдельных файлах:

.koda/skills/
└── python-service/
    ├── references/
    │   ├── code-review.md
    │   └── deployment.md
    └── SKILL.md

Ссылки на файлы с уточнящими инструкциями нужно вставить в основной файл скилла:

...
## References

Процедура code-review описана в файле [references/code-review.md](references/code-review.md).

Процедура развёртывания описана в файле [references/deployment.md](references/deployment.md).
...

Преимущество: экономия на контексте, поскольку модель сможет считывать только необходимые части навыка (срез знаний).

5. Навыки для команды и общего проекта

Создайте общие навыки для команды:

.koda/skills/
├── team-best-practices/
│   └── SKILL.md
├── code-review/
│   └── SKILL.md
└── deployment/
    └── SKILL.md

Преимущества:

  • Единые стандарты в команде
  • Онбординг новых разработчиков
  • Сохранение знаний