Навык агента

Готовый навык для Claude Code, Codex и других агентных сред.

Навык агента TypeSafe даёт вашему ИИ-агенту для программирования полный контекст об API TypeSafe: три типа вопросов, архитектурные паттерны и лучшие практики структурирования оценок.

Установка

Выполните эти две команды в терминале:

claude plugin marketplace add typesafe-ai/skills
claude plugin install typesafe@typesafe-ai

npx skills add typesafe-ai/skills --skill typesafe-ai

Выберите своего агента, когда появится запрос. По умолчанию установка выполняется локально для проекта; добавьте -g, чтобы установить глобально.

Вставьте этот промпт в ваш агент для программирования:

Install the TypeSafe skill. If you're in Claude Code, run `claude plugin marketplace add typesafe-ai/skills`, then `claude plugin install typesafe@typesafe-ai`. If you're in another agent, run `npx skills add typesafe-ai/skills --skill typesafe-ai` and select your agent. Use one installation method. You can read the skill directly at https://github.com/typesafe-ai/skills/blob/main/skills/typesafe-ai/SKILL.md (raw: https://raw.githubusercontent.com/typesafe-ai/skills/main/skills/typesafe-ai/SKILL.md). Then use the TypeSafe skill when working on this project.

Прочитайте SKILL.md на GitHub или загрузите исходный Markdown напрямую. Для ручной установки скопируйте целиком каталог skills/typesafe-ai, включая его справочные файлы, в каталог навыков вашего агента.

Выберите один способ установки, чтобы избежать дублирующихся копий.

Обновления

Для плагина Claude Code выполните:

claude plugin marketplace update typesafe-ai
claude plugin update typesafe@typesafe-ai

Перезапустите Claude Code или выполните /reload-plugins, чтобы загрузить обновление. Чтобы включить автоматические обновления, откройте /plugin и выберите Marketplaces → typesafe-ai → Enable auto-update.

Для установок через skills.sh выполните npx skills update. Для ручных копий замените весь каталог навыка последней версией с GitHub.

Примеры промптов

Упоминание навыка в промпте — «используй навык TypeSafe» — работает в любом агенте, поэтому каждый из приведённых ниже промптов так и делает. С плагином Claude Code можно также вызывать /typesafe:typesafe-ai напрямую.

Хороший стартовый промпт — это промпт для мозгового штурма, который поможет понять, где в проекте TypeSafe пригодится больше всего.
```
Using the TypeSafe skill, explore the project and find opportunities for using
intelligent judgement to stand in for complex parsing or other fragile code.
```
Вы также можете создать ключ API и разрешить агенту самому найти лучший способ применения TypeSafe, выполняя недорогие тестовые запросы.
```
Using the TypeSafe skill, run some experiments using the TypeSafe API key that I've
exported to `TYPESAFE_API_KEY`. Propose changes based on the most promising results.
```
Направьте агента на конкретный cookbook, который решает вашу проблему в кодовой базе, или на указатель cookbook и спросите, есть ли там паттерны, похожие на те, что в вашем проекте.
```
Using the TypeSafe skill, analyze my code and see if there are any applicable
cookbooks (https://console.typesafe.ai/docs/cookbooks) that show how I could
refactor my code to be less fragile or complex.
```

Принципы хорошего вайб-кодинга

Обсудите задачу с агентом, взяв за отправную точку примеры промптов выше.
Проверьте план и убедитесь, что он разумен, прежде чем его реализовывать.
Соберите константы (вопросы и пороги) в одном месте, чтобы их было легко проверять. Агенты неважно пишут вопросы, так что готовьтесь редактировать их вместе с агентом.
Не принимайте утверждения на веру; побуждайте агента проверять свои допущения.

Частые проблемы

Агент не использует навык

С плагином Claude Code вызовите /typesafe:typesafe-ai. В других агентах попросите «использовать навык TypeSafe». Если он всё равно не загружается, убедитесь, что установщик нацелен на того агента, которым вы пользуетесь, и перезапустите агента.

Маршрутизация работает не так, как вы ожидаете

Проверьте вопросы и пороги. Возможно, ваши пороги заданы слишком высоко (что даёт ложноотрицательные результаты) или слишком низко (что даёт ложноположительные). Также может понадобиться сделать вопросы более конкретными.

Вы повсюду используете пороги уверенности

Если вам важно только выбрать лучший вариант, достаточно выбрать вариант с наибольшей уверенностью (а не задавать порог уверенности). Если у вас на уме конкретный статистический алгоритм, вероятно, стоит использовать вероятности вместо уверенности.

Код TypeSafe трудно проверять

Самое важное, что людям нужно проверять, — это вопросы и любые константы порогов, используемые в вашем коде TypeSafe. Их следует определять в одном файле кода, чтобы их было легко найти без долгих блужданий по коду.

Агент придумывает поля запроса или ответа

Причиной может быть устаревший навык. Обновите его способом, указанным выше, и повторите попытку.