AIKraft/Skills/code-quality

code-quality

Обеспечивает корректность кода, соблюдение паттернов Rust, качество комментариев и избегание излишней сложности. Применяется при написании кода в репозитории tursodatabase/turso.

TDTurso Database official Разработка ★ 24.6k

Что делает навык

Набор правил и паттернов для обеспечения корректности кода на Rust в проекте tursodatabase/turso, где приоритетом является целостность данных и надежность. Skill запрещает скрытые ошибки, излишнюю абстракцию и требует явной обработки всех состояний и ошибок.

Когда применять

  • Написание новых функций или модулей в репозитории tursodatabase/turso
  • Рефакторинг существующего кода для устранения потенциальных состояний гонки или неопределенного поведения
  • Проверка качества кода на соответствие паттернам Rust (например, использование enum вместо строк)
  • Оптимизация производительности за счет минимизации аллокаций в куче и учета модели асинхронного ввода-вывода

Как работает

  1. Проверять инварианты с помощью assert! и обрабатывать все ошибки, избегая их скрытия
  2. Крашиться (panic) при недопустимых состояниях, угрожающих целостности данных, вместо продолжения работы в неопределенном состоянии
  3. Использовать исчерпывающий pattern matching и предпочитать enums строкам или сентинелам для представления состояний
  4. Применять if-статements только когда оба ветвления ожидаемы; для невозможных состояний использовать unreachable! или возврат ошибки
  5. Минимизировать аллокации в куче и писать код, дружественный к процессору (CPU-friendly)
  6. Удалять неиспользуемый код и избегать обратной совместимости (renamed vars, re-exports), не создавать абстракций для одноразовых операций

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

Напиши функцию на Rust для tursodatabase/turso, которая безопасно обрабатывает ошибку и использует assert для проверки инвариантов
Рефактори этот код: замени строковые флаги на enum и убери лишние аллокации в куче
Проверь этот блок кода на соответствие правилам code-quality: нет ли скрытых ошибок в ветках if и правильно ли обработаны состояния индексов

Описание составлено по SKILL.md навыка, сверено 09.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «tursodatabase-code-quality» из репозитория: # https://github.com/tursodatabase/turso
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r tursodatabase-code-quality/ ~/.claude/skills/tursodatabase-code-quality/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.