Навыки TypeScript Expert
📦

TypeScript Expert

Низкий риск ⚡ Содержит скрипты⚙️ Внешние команды

Мастер разработки на TypeScript с профессиональными рекомендациями

Испытываете сложности со сложными типами TypeScript, производительностью сборки или миграцией? Получите экспертные рекомендации по программированию на уровне типов, современным инструментам и лучшим практикам от специализированного TypeScript-ассистента.

Поддерживает: Claude Codex Code(CC)
🥉 72 Бронза
1

Скачать ZIP навыка

2

Загрузить в Claude

Перейдите в Settings → Capabilities → Skills → Upload skill

3

Включите и начните использовать

Протестировать

Использование «TypeScript Expert». Я постоянно получаю ошибки 'implicit any' в параметрах моих функций

Ожидаемый результат:

Включите noImplicitAny в вашем tsconfig.json. Затем добавьте явные аннотации типов: function greet(name: string): string { return `Hello, ${name}`; }. Для сложных случаев используйте unknown и сужайте: function process(input: unknown) { if (typeof input === 'string') { /* input теперь string */ } }

Использование «TypeScript Expert». Как мне предотвратить смешивание строк UserId и OrderId?

Ожидаемый результат:

Используйте именованные типы: type Brand<K, T> = K & { readonly __brand: T }; type UserId = Brand<string, 'UserId'>; type OrderId = Brand<string, 'OrderId'>; Создайте конструкторы: const createUserId = (id: string): UserId => id as UserId; Это предотвращает передачу UserId там, где ожидается OrderId, на этапе компиляции.

Аудит безопасности

Низкий риск
v1 • 2/25/2026

Static analysis flagged 64 patterns but manual review confirms most are false positives. The backtick patterns are TypeScript template literal types and markdown code fences, not shell execution. URLs are JSON schema references. One legitimate finding: subprocess.run with shell=True in local diagnostic script uses only hardcoded commands with no user input injection risk. No network activity, credential access, or data exfiltration detected.

4
Просканировано файлов
1,016
Проанализировано строк
6
находки
1
Всего аудитов
Проблемы среднего риска (1)
scripts/ts_diagnostic.py:16
Subprocess with shell=True
Python diagnostic script uses subprocess.run with shell=True which could enable command injection if user input reaches the command parameter. Review confirms all commands are hardcoded strings with no external input, making this safe for local diagnostic use.
Проблемы низкого риска (3)
references/utility-types.ts:209references/utility-types.ts:222references/utility-types.ts:230references/utility-types.ts:327
False positive: Template literal types flagged as shell execution
Static analyzer incorrectly flagged TypeScript template literal types (e.g., `${infer T}`) in utility-types.ts as shell backtick execution. These are type-level string manipulation, not command execution.
references/typescript-cheatsheet.md:5-383
False positive: Markdown code fences flagged as shell execution
Static analyzer incorrectly flagged markdown code fence delimiters (```typescript) in documentation as shell backtick execution. These are documentation formatting, not executable code.
references/tsconfig-strict.json:2
False positive: JSON schema URL flagged as hardcoded network endpoint
The $schema reference to json.schemastore.org is a standard TypeScript configuration pattern for IDE autocomplete, not an active network request.

Факторы риска

⚡ Содержит скрипты
Конкретные расположения не записаны
⚙️ Внешние команды (1)
scripts/ts_diagnostic.py:16
Проверено: claude

Оценка качества

68
Архитектура
100
Сопровождаемость
87
Контент
27
Сообщество
79
Безопасность
74
Соответствие спецификации

Что вы можете построить

Корпоративная миграция на TypeScript

Направляйте крупномасштабную миграцию JavaScript на TypeScript с инкрементальными стратегиями, конфигурацией tsconfig и паттернами аннотаций типов.

Продвинутый дизайн системы типов

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

Оптимизация производительности сборки

Диагностируйте медленную проверку типов, настраивайте инкрементальные сборки и оптимизируйте ссылки на проекты TypeScript в монорепозиториях.

Попробуйте эти промпты

Базовый вопрос по типам 
У меня есть ошибка TypeScript: [вставьте ошибку]. Мой код: [вставьте код]. Что означает эта ошибка и как её исправить?
Ревизия конфигурации типов 
Проверьте мой tsconfig.json на соответствие лучшим практикам: [вставьте конфигурацию]. Есть ли настройки, которые следует изменить для проекта [библиотека/приложение]?
Продвинутый паттерн типов 
Мне нужно создать тип, который [опишите требование]. Например, он должен [приведите примеры]. Можете ли вы спроектировать это с использованием системы типов TypeScript?
Стратегия миграции 
Я мигрирую JavaScript-кодовую базу размером [размер] на TypeScript. Мы используем [инструменты/фреймворк]. Какой лучший инкрементальный подход и с какими настройками tsconfig мне начать?

Лучшие практики

  • Включите strict mode и noUncheckedIndexedAccess в tsconfig.json для максимальной безопасности типов
  • Предпочитайте interface перед type для форм объектов — это даёт лучшие сообщения об ошибках и поддержку слияния объявлений
  • Используйте unknown вместо any для безопасности типов, затем сужайте типы с помощью type guards перед использованием значения

Избегать

  • Использование типа any для обхода ошибок вместо правильной типизации значения
  • Чрезмерные утверждения типов (as Type), которые обходят проверку типов без оправдания
  • Излишнее усложнение типов сложными обобщениями, когда работает более простое решение

Часто задаваемые вопросы

Стоит ли использовать interface или type для определения форм объектов?
Предпочитайте interface для форм объектов. Interfaces обеспечивают лучшие сообщения об ошибках, поддерживают слияние объявлений и могут быть расширены. Используйте type для объединений, примитивов или когда нужны функции типов, которые не поддерживают interfaces.
Как исправить ошибки 'Cannot find module', когда файл существует?
Проверьте, что moduleResolution соответствует вашему сборщику (bundler для Vite/esbuild, node16 для Node.js). Проверьте baseUrl и paths в tsconfig.json. Для монорепозиториев убедитесь, что workspace protocol настроен. Очистите кэш: rm -rf node_modules/.cache .tsbuildinfo
В чём разница между unknown и any?
any полностью отключает проверку типов. unknown требует сужения типа перед использованием, сохраняя безопасность типов. Всегда предпочитайте unknown, когда не знаете тип, затем используйте typeof, instanceof или кастомные type guards для сужения.
Как выполнить постепенную миграцию с JavaScript на TypeScript?
Включите allowJs и checkJs в tsconfig.json сначала. Постепенно переименовывайте файлы в .ts, начиная с изолированных модулей. Добавляйте типы файл за файлом. Включайте функции strict mode по одной за раз. Используйте ts-migrate или AI-помощь для массовых аннотаций типов.
Почему компиляция TypeScript такая медленная?
Включите skipLibCheck и incremental в tsconfig.json. Используйте точные паттерны include/exclude. Для монорепозиториев настройте project references с composite. Выполните npx tsc --extendedDiagnostics для выявления узких мест. Рассмотрите переход на esbuild или swc для более быстрых сборок.
Работают ли сопоставления путей TypeScript во время выполнения?
Нет, TypeScript paths работают только на этапе компиляции. Для времени выполнения используйте ts-node с tsconfig-paths, настройте разрешение модулей Node.js или используйте сборщик, который разрешает пути. В продакшене сначала компилируйте, чтобы пути были разрешены в выходных файлах.

Сведения для разработчиков

Автор

sickn33

Лицензия

MIT

Репозиторий

https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/typescript-expert

Ссылка

main

Структура файлов

📁 references/

📄 tsconfig-strict.json

📄 typescript-cheatsheet.md

📄 utility-types.ts

📁 scripts/

📄 ts_diagnostic.py

📄 SKILL.md