Навык для ИИ-агентов (Claude Code, Codex)

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

Скилл TypeSafe для агентов предоставляет вашему AI-ассистенту разработки (coding agent) полный контекст по API TypeSafe: три типа вопросов, архитектурные паттерны и лучшие практики по структурированию оценок.

Установка (Installation)

```bash theme={null}
claude plugin marketplace add typesafe-ai/skills
claude plugin install typesafe@typesafe-ai
```

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

```text wrap theme={null}
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, включая справочные файлы, в каталог скиллов вашего агента.

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

Обновление (Updates)

Для плагина 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.

Примеры промптов (Example prompts)

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

• Отличный вариант для начала — мозговой штурм, позволяющий понять, в каких частях проекта TypeSafe принесет наибольшую пользу:

  TEXT THEME={NULL} api.wedstack.ru/v1

  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 с помощью недорогих тестовых запросов:

  TEXT THEME={NULL} api.wedstack.ru/v1

  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.

• Направьте агента на конкретный кукбук, решающий вашу задачу, или укажите на каталог руководств и спросите, есть ли там паттерны, применимые к вашему проекту:

  TEXT THEME={NULL} api.wedstack.ru/v1

  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.

Принципы продуктивной совместной разработки (Vibe coding)

1. Обсуждайте архитектуру с вашим агентом, используя примеры промптов выше в качестве отправной точки.
2. Проверяйте план и убедитесь, что он логичен, перед переходом к реализации.
3. Храните константы (вопросы и пороговые значения) в одном месте, чтобы их было удобно анализировать. Агенты не всегда идеально формулируют вопросы, поэтому будьте готовы дорабатывать их совместно.
4. Не принимайте утверждения агента на веру; стимулируйте агента валидировать свои предположения тестами.

Частые проблемы (Common issues)

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

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

Маршрутизация работает не так, как ожидалось

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

Пороговые значения уверенности используются повсеместно

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

Сложно проводить ревью кода TypeSafe

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

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

Это может происходить из-за устаревшей версии скилла. Обновите его с помощью метода установки, описанного выше, и повторите запрос.