# arkts-syntax-assistant

Скилл помогает писать код на ArkTS для HarmonyOS и OpenHarmony, переносить проекты с TypeScript и исправлять ошибки сборки. Он подключается при работе с файлами .ets и пакетами @ohos.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 824 установки · ★ 88
- Автор: SummerKaze
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/SummerKaze/skill-arkts-syntax-assistant/tree/HEAD/SKILL.md
- Обновлён: 2026-01-31
- HTML: https://affpapa.org/nevibecode/skills/arkts-syntax-assistant

## Что делает

Скилл инструктирует ИИ-агента по правилам языка ArkTS в OpenHarmony. В отличие от стандартного TypeScript, здесь действует строго статическая типизация: типы определяются на этапе компиляции, структурная типизация отсутствует, а структура объектов фиксирована. Агент опирается на справочники синтаксиса, запрещающие использование динамических свойств объектов, анонимных функций через ключевое слово function и цикла for..in.

Для миграции с TypeScript скилл подставляет строгие аналоги: заменяет any на конкретные типы, индексные сигнатуры на Record, а литералы объектов на заранее объявленные классы или интерфейсы. Встроенные скрипты scripts/run.sh и scripts/run.ps1 вызывают ohpm install и сборщик hvigorw assembleApp. Проверка компиляцией через эти скрипты обязательна после любой кодогенерации, иначе агент рискует оставить скрытые ошибки типов.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add SummerKaze/skill-arkts-syntax-assistant --skill arkts-syntax-assistant -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/arkts-syntax-assistant/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/arkts-syntax-assistant/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add SummerKaze/skill-arkts-syntax-assistant --skill arkts-syntax-assistant -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/arkts-syntax-assistant/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add SummerKaze/skill-arkts-syntax-assistant --skill arkts-syntax-assistant -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/arkts-syntax-assistant/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install SummerKaze/skill-arkts-syntax-assistant arkts-syntax-assistant
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/arkts-syntax-assistant/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add SummerKaze/skill-arkts-syntax-assistant --skill arkts-syntax-assistant -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/SummerKaze/skill-arkts-syntax-assistant
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/arkts-syntax-assistant/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add SummerKaze/skill-arkts-syntax-assistant --skill arkts-syntax-assistant -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/SummerKaze/skill-arkts-syntax-assistant/tree/HEAD/SKILL.md

## Когда брать
- переписать код с TypeScript на ArkTS без any и динамических объектов
- настроить типизацию через интерфейсы и Record вместо индексных сигнатур
- устранить ошибки компиляции в файлах .ets для HarmonyOS
- проверить проект через сборщик hvigorw и пакетный менеджер ohpm

## Примеры запросов агенту
- Перепиши этот TypeScript-интерфейс с индексной сигнатурой под правила ArkTS в файле .ets.
- Почему в моём коде для HarmonyOS падает ошибка на JSON.parse и как её исправить по стандартам ArkTS?
- Оптимизируй этот цикл в .ets без использования for..in и генерации исключений.

## Похожие
- [mojo-syntax](https://affpapa.org/nevibecode/skills/mojo-syntax.md) — скилл · 2900 установок
- [harmony-next](https://affpapa.org/nevibecode/skills/harmony-next.md) — скилл · ★ 367
- [dart-use-primary-constructors](https://affpapa.org/nevibecode/skills/dart-use-primary-constructors.md) — скилл · 14200 установок
- [capacitor-plugin-upgrade-v5-to-v6](https://affpapa.org/nevibecode/skills/capacitor-plugin-upgrade-v5-to-v6.md) — скилл · 633 установки
- [harmonyos-device-automation](https://affpapa.org/nevibecode/skills/harmonyos-device-automation.md) — скилл · 2400 установок

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md