koda-learn
Позволяет найти и установить дополнительные навыки (скиллы), расширяющие функционал Koda для решения конкретных задач. Подбери подходящие навыки для текущего проекта, чтобы помочь себе и пользователю. Навыки нужны для фокуса на способах решения конкретных задач и обогащения контекста дополнительными знаниями. Активируется инструментом `read_skill` (vscode/jetbrains) или `Activate Skill` (cli) с передачей аргумента `koda-learn`.
koda · 已有静态检查记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add XCode-NLP/KodaSkills --skill koda-learn技能说明
name: koda-learn
description: "Позволяет найти и установить дополнительные навыки (скиллы), расширяющие функционал Koda для решения конкретных задач. Подбери подходящие навыки для текущего проекта, чтобы помочь себе и пользователю. Навыки нужны для фокуса на способах решения конкретных задач и обогащения контекста дополнительными знаниями. Активируется инструментом read_skill (vscode/jetbrains) или Activate Skill (cli) с передачей аргумента koda-learn."
license: MIT
metadata:
author: koda
version: 1.0.0
Поиск и установка навыков (скиллов)
Когда применять
- Пользователь может попросить:
- установить дополнительные навыки;
- подобрать дополнительные навыки для текущего конкретного проекта;
- Нельзя устанавливать новые навыки, если пользователь так или иначе не разрешил этого.
Типичные фразы-триггеры:
-
научись <делать что-либо>
-
установи навык
-
добавь скилл
-
найди скилл
-
добавь нужный навык, если потребуется
-
подбери скиллы
-
какие скиллы подойдут для
-
подбери навыки для
- другие похожие по смыслу, не ограничиваясь русским языком
Как применять
- Из задачи пользователя определи требования к искомым навыкам.
- Если задача непонятна, уточни у пользователя хочет ли он установить конкретный навык или ему подойдёт любой из лучших.
- Если пользователь просит найти подходящие для проекта навыки, сначала изучи проект, файлы KODA.md и AGENTS.md (при наличии).
- Директория установки навыков:
.koda/skills/<имя_навыка>/в корне проекта.
Поиск и обработка результатов
- Запрещено использовать поиск в интернете пока не будут испытаны все источники, указанные ниже.
- Если при поиске найдено больше 1 навыка, предложи ознакомиться с каждым из них, пронумеровав строго по порядку, и ожидай явного подтверждения.
- Всегда давай пользователю активную ссылку на web-страницу каждого навыка в формате:
[ссылка](ссылка).
Принятие решений
- Пользователь может согласиться установить все найденные навыки, некоторые из них или ни одного.
- Если результаты поиска не подходят, остановись и предложи пользователю найти навык самостоятельно и установить в директорию установки.
- Если найден один подходящий навык, сразу переходи к установке.
- Избегай конфликтов имён с установленными навыками.
- Установка навыка допустима только если выполняются обязательные требования.
- Приоритет у того навыка, который суммарно удовлетворяет большему количеству требований по всем критериям оценки.
Установка
Источник 1 - официальный репозиторий Koda
URL: https://raw.githubusercontent.com/XCode-NLP/KodaSkills/refs/heads/main/metadata.json
ВАЖНО: При любой технической ошибке переходи к источнику 2.
- Получи данные об имеющихся в репозитории навыках.
- В массиве объектов
skillsважны следующие поля:name: имя;description: описание;url.web: ссылка на просмотр текста в браузере;url.raw: ссылка на сырой текст для установки;
- Оцени соответствие запроса пользователя с этими полями по критериям ниже.
Критерии оценки:
- Имя и описание должны максимально соответствовать запросу пользователя.
- Ссылки должны вести на репозиторий
XCode-NLP/KodaSkills.
Установка:
- Получи текст навыка по адресу
url.raw - Сохрани текст в корень текущего проекта (workspace):
.koda/skills/<name>/SKILL.md.
Источник 2 - каталог agentskill
URL: https://agentskill.sh/api/skills?limit=30&q=<поисковый_запрос>
ВАЖНО: При любой технической ошибке переходи к источнику 3.
- Получи данные об имеющихся в каталоге навыках.
- Важны следующие поля ответа:
- Базовая обязательная информация:
name: имя навыка;owner: имя автора;claimed: автор подтверждён;
- Критерии релевантности:
seoSummary: описание навыка;category,skillTypes,tools: ключевые слова, характеризующие область применения и технологический стек;jobRoles,jobCategories: ключевые слова, характеризующие релевантные роли или профессии;tags: дополнительные ключевые слова, характеризующие навык;
- Числовые показатели качества:
securityScore: показатель безопасности (0-100);downvotes: количество негативных оценок;upvotes,contentQualityScore,creatorTrustScore,hotScore,recentInstalls24h,recentInstalls3d,recentInstalls7d,recentRatings3d,recentRatings7d,topScore,trendingScore,score,ratingCount,installCount,githubStars: показатели качества и популярности навыка;
- Базовая обязательная информация:
- Оцени соответствие запроса пользователя с этими полями по критериям ниже.
Критерии оценки:
- ОБЯЗАТЕЛЬНО: все критерии релевантности должны максимально соответствовать запросу пользователя
- ОБЯЗАТЕЛЬНО:
securityScoreдолжен быть в диапазоне 75-100 - ОПЦИОНАЛЬНО:
downvotes= 0 или значительно ниже всех остальных показателей качества - ОБЯЗАТЕЛЬНО: все остальные числовые показатели качества суммарно должны быть > 0 (чем выше, тем лучше)
- ОПЦИОНАЛЬНО:
claimed= true
Установка:
- Получи данные по адресу:
https://agentskill.sh/api/agent/skills/<name>/install?owner=<owner> - Сохрани значение
skillMdполя в корень текущего проекта (workspace):.koda/skills/<name>/SKILL.md. - Удали из этого файла строки:
# --- agentskill.sh ---(первая строка);# ---(перед frontmatter, обычно 13-я сверху);- всё содержимое между ними.
Источник 3 - каталог neuraldeep
URL: https://neuraldeep.ru/api/skills?q=<поисковый_запрос>
ВАЖНО: При любой технической ошибке переходи к другим источникам.
- Получи данные об имеющихся в каталоге навыках.
- Важны следующие поля ответа:
- Базовая обязательная информация:
id: uuid навыка;name: имя навыка;owner: имя автора;
- Критерии релевантности:
description: описание навыка;category,tags: дополнительные ключевые слова, характеризующие навык, область его применения и технологически
- Базовая обязательная информация: