Счет за Навыки: Структура Управления Навыками Кодирования ИИ на Основе Markdown

Что такое Skill Bill

Skill Bill — это фреймворк управления навыками ИИ для программирования, полностью построенный на Markdown. Он решает распространённые проблемы, с которыми сталкиваются разработчики при управлении множеством промптов ИИ для разных агентов: дрейф наименований, дублирование логики, проникновение платформенно-специфичного кода в общие навыки и отсутствие единого источника истины.

Как всё начиналось

Разработчик начал с отдельных навыков для конкретных задач: промпта для ревью кода для работы с Android/KMP, навыка gradle check с соглашениями по исправлению проблем вместо их подавления, навыка feature flag и навыка для реализации функций из дизайн-документов. После накопления примерно дюжины навыков, разбросанных по разным агентам, он столкнулся с «привычным разложением» — несогласованностью наименований и появлением Kotlin-специфичной логики в предположительно общих навыках.

Прорыв с оркестратором

Ключевым нововведением стало создание feature-implement — навыка, который вызывает другие навыки последовательно. Этот оркестратор принимает дизайн-документ, создаёт план, спрашивает о стратегии feature flag, реализует код, запускает ревью и проверяет завершённость. Один запуск feature-implement объединяет в цепочку 10-12 вызовов навыков: оркестратор, маршрутизатор для ревью кода с определением стека, 3-5 специализированных ревьюеров, работающих параллельно, проверку качества, описание PR и опциональную настройку feature flag.

Вопросы стоимости

Разработчик использует Claude Code с подпиской Max и изначально не учитывал расходы на использование. Однако друг с подпиской Codex Pro сообщил, что один вызов навыка code-review (не всей цепочки) расходует 40-50% от 5-часового лимита Pro. Copilot использует другую модель биллинга (за ход разговора, а не за объём токенов), что делает этот подход более экономичным.

Техническая архитектура

Фреймворк развился для поддержки нескольких языков программирования через структурированный Markdown, который функционирует как код:

• Наследование: Базовые навыки с переопределениями для платформ
• Логика маршрутизации: Определение стека и делегирование соответствующим специалистам
• Контракты интерфейсов: Определённые отношения между навыками
• Валидация: Обеспечивает соблюдение правил именования и структуры для предотвращения «разложения» репозитория

Как только базовый слой стал достаточно общим, добавление поддержки PHP было простым, затем Go. Фреймворк теперь включает 44 навыка для Kotlin, Android/KMP, Kotlin backend, PHP и Go.

Ключевые особенности

• Базовые навыки, которые автоматически направляют к нужному платформенному специалисту
• Валидатор, обеспечивающий соблюдение правил именования и структуры
• Единый репозиторий, синхронизируемый с Claude Code, Copilot, GLM и Codex
• Навыки-оркестраторы, такие как feature-implement, которые связывают всё вместе от начала до конца
• В настоящее время наиболее силён для семейства Kotlin и бэкендов на Go/PHP, но спроектирован для расширения на новые платформы

Практические последствия

Разработчик обнаружил, что репозитории промптов имеют те же инженерные проблемы, что и обычное программное обеспечение. Относясь к навыкам как к коду — с контрактами, валидацией и композируемостью — вся система стала значительно более поддерживаемой. Фреймворк доступен на GitHub под лицензией MIT по адресу https://github.com/Sermilion/skill-bill.