Harmonize — скилл
Линтер архитектуры Swift с правилами в виде unit-тестов и плагин Claude Code с навыками запуска правил и их написания.
- 364 ★ репозитория
- Последний коммит
- Apache-2.0
Минимальный доступ
Почему такой уровень
- Плагин запускает тесты проекта и пишет файлы навыка в указанную папку репозитория
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/harmonizeОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Плагин запускает тесты проекта и пишет файлы навыка в указанную папку репозитория
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Harmonize проверяет структуру Swift-кода тестами на Quick, XCTest или Swift Testing: например, все классы с суффиксом `ViewModel` обязаны наследовать `BaseViewModel`. Правило описывается типом `Rule` с причиной, способом исправления, плохим и хорошим примером, поэтому нарушение объясняет само себя. Для агентов в репозитории лежит плагин Claude Code с двумя навыками: `run-harmonize` запускает правила после задачи и объясняет вывод, `write-harmonize-rule` ведет агента при написании правил. Команда пакета Swift также собирает из правил отдельный навык с файлом `SKILL.md`. Интеграция с агентами в бете, версия `2.0.0-beta.2`.
Для кого. Командам iOS и macOS, где код пишет и ИИ-агент, и людям нужны проверяемые архитектурные правила вместо ручного ревью.
Подходит, если
- Агент в Claude Code закончил задачу, и правила надо прогнать автоматически.
- Нужно записать архитектурное соглашение как тест, например про наследование.
- Хочется выдать агенту собранный из правил навык, чтобы он знал соглашения до написания кода.
- Правила нужны в CI рядом с обычными тестами.
Не подходит, если
- Нужен только стиль кода, для него подходят линтеры вроде SwiftLint.
- Проект написан не на Swift.
- Интеграция с агентами в бете, а стабильность важнее.
Пример запроса к агенту
После правок запусти правила Harmonize навыком run-harmonize и исправь нарушения, ориентируясь на поле howToFix.Ограничения
Агентные функции доступны в версии `2.0.0-beta.2`, формат может измениться. Нужен проект на Swift и пакет в `Package.swift`. Для сборки навыка плагин пишет файлы в указанную папку, путь в `--allow-writing-to-directory` должен совпадать с настройкой `output`. Правила пишутся на Swift и требуют знакомства с тестовыми фреймворками, а выбор между Quick, XCTest и Swift Testing делается заранее. Перед применением проверьте актуальность репозитория и версию, на которую опираетесь.
Как отключить. Выполните `/plugin uninstall harmonize@harmonize` и удалите строку про `run-harmonize` из `AGENTS.md` или `CLAUDE.md`. Пакет Swift уберите из `Package.swift`.
Частые вопросы
Чем правило отличается от обычного теста?
Оно оформляется как тест, но несет объект `Rule` с причиной, способом исправления и примерами, которые читает агент.
Что делают два навыка плагина?
`run-harmonize` запускает правила и объясняет вывод, `write-harmonize-rule` помогает агенту писать новые правила.
Как получить навык из своих правил?
Командный плагин Swift-пакета читает объявления `Rule(...)` и создает `SKILL.md` с файлами-справками в папке из `.harmonize.yaml`.
Есть ли запуск в CI?
Да. Правила работают как unit-тесты, и README приводит пример GitHub Actions.
Какие тестовые фреймворки поддержаны?
Quick, XCTest и Swift Testing.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыSwift Testing Agent Skill
swift-testing-agent-skill
Скилл по Swift Testing от Антуана ван дер Ли: новые API, миграция с XCTest, параметризованные тесты и плоские тесты. Для Claude Code и других агентов
Скилл Пола Хадсона по Swift Testing: параметризованные тесты, подтверждения, тесты на завершение процесса и переход с XCTest
Проверяет пакеты Agent Skills: структуру, ссылки, объем в токенах и качество инструкций с оценкой моделью-судьей
Скилл evidence-code-review для Codex и Claude Code: ревью изменений по доказательствам, с уровнями MUST, SHOULD, BETTER и NITS
Шаблон проекта Playwright на TypeScript с правилами и 17 скиллами, чтобы Claude Code, Codex и Cursor писали тесты по стандарту
Два навыка для Codex и Claude Code: аудит репозитория без записи и цикл экспериментов с базовыми замерами.
Коротко о README
Правила архитектуры живут как тесты, а агент получает навыки для их запуска, написания и выгрузки в виде отдельного навыка проекта.