SkillForge v5.1

От искусства к инженерии: манифест создания AI-навыков.

Проблема

Главная сложность в разработке AI — не нехватка идей, а непоследовательный процесс превращения их в надёжные, устойчивые навыки. Существующие подходы зачастую ситуативны, хрупки и плохо масштабируются — это скорее искусство, чем предсказуемая инженерная дисциплина.

Решение

Качество закладывается изначально, а не добавляется потом.

SkillForge — это методология, в которой строгость интегрирована на каждом этапе: от первоначальной концепции до финальной валидации. Это фундаментальный переход от реактивного тестирования к проактивной инженерии.

Что нового в v5.1

v5.1 развивает контекстно-эффективный редизайн v5.0 и добавляет расширенную поддержку frontmatter, руководство по хукам, покрытие валидации и безопасность упаковки.

Контекстно-эффективная основа (v5.0)

Основа из v5.0 сохраняется: контекстное окно — общественное благо. Каждая строка в SKILL.md конкурирует с реальной работой пользователя.

• SKILL.md сокращён с 872 до 313 строк (на 64%)
• Детальные материалы перенесены в references/ и загружаются только по необходимости
• Триггеры перенесены в поле description для маршрутизации до загрузки

Упрощённый frontmatter

Навыки теперь используют только name и description во frontmatter. Поле description — основной механизм триггеринга: оно определяет, когда навык активируется, поэтому вся информация «когда использовать» должна быть там.

---
name: my-skill
description: What this skill does and when to use it. Include trigger scenarios.
---

Степени свободы

Новая концепция проектирования для подбора точности инструкций под хрупкость задачи:

• Высокая свобода (текстовые рекомендации) — когда допустимо несколько подходов
• Средняя свобода (псевдокод/параметризованные скрипты) — когда есть предпочтительный паттерн
• Низкая свобода (точные скрипты) — когда операции хрупкие и чреваты ошибками

Скрипт-скаффолд

Новый init_skill.py создаёт насыщенные шаблоны навыков с TODO-заглушками, предложениями по организационным паттернам и примерами ресурсных файлов:

Итерация как формальный шаг

Итерация теперь встроена в Фазу 3. Навыки улучшаются через реальное использование, а не только через проверку на панели синтеза.

Расширенный frontmatter + хуки (v5.1)

v5.1 расширяет поддержку метаданных навыков и документацию:

• Расширенное покрытие frontmatter для model, context, agent, hooks и user-invocable
• Новое руководство по интеграции хуков PreToolUse, PostToolUse и Stop
• Обновления шаблонов под современные умолчания при создании навыков

Усиление валидации и упаковки (v5.1)

v5.1 добавляет более строгие ограничения для безопасного распространения:

• Общие константы валидации между скриптами проверки
• Улучшенный парсинг frontmatter и более строгие проверки структуры
• Восстановлено применение .skillignore при упаковке
• Проверщик безопасности документации для выявления небезопасных паттернов интерполяции команд
• Регрессионное покрытие тестами для исключений при упаковке

4-фазная архитектура

SkillForge реализует свою философию через строгую автономную 4-фазную архитектуру. Эта структура гарантирует, что каждый навык проходит всестороннее исследование, детальную спецификацию, чистую генерацию и объективное утверждение перед завершением.

Фаза 0: Триаж навыков

Прежде чем что-либо создавать, SkillForge анализирует ввод и определяет наилучшее действие:

• USE_EXISTING — существующий навык полностью подходит (совпадение ≥80%)
• IMPROVE_EXISTING — существующий навык близок, но требует доработки (совпадение 50–79%)
• CREATE_NEW — подходящего навыка нет, создаётся новый (совпадение <50%)
• COMPOSE — нужно несколько навыков, предлагается цепочка

# Всё это работает — SkillForge маршрутизирует автоматически:

SkillForge: create a skill for automated code review
→ Создаёт новый навык (Фазы 1–4)

help me debug this TypeError
→ Рекомендует навыки отладки

do I have a skill for Excel?
→ Ищет и рекомендует подходящие навыки

Фаза 1: Глубокий анализ

Максимальная глубина до генерации первой строки.

Каждая задача систематически декомпозируется через 11 отдельных линз мышления, для каждого проектного решения оцениваются степени свободы.

11 линз включают: первые принципы, инверсию, эффекты второго порядка, пре-мортем, системное мышление, адвоката дьявола, ограничения, принцип Парето, анализ корневых причин, сравнительный анализ и альтернативные издержки.

Фазы 2 и 3: Спецификация и генерация

Перевод глубокого анализа в безупречную сборку.

Инсайты из анализа кодифицируются в структурированную XML-спецификацию, которая затем используется для генерации навыка в свежем контексте. Фаза 3 теперь включает явный шаг итерации — сверку результата со спецификацией, выявление пробелов и доработку перед проверкой на панели.

Фаза 4: Мультиагентный синтез

Панель экспертов требует единогласного одобрения.

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

Панель включает:

• Агент проектирования/архитектуры — структура, паттерны, корректность
• Агент аудитории/удобства использования — ясность, обнаруживаемость, полнота
• Агент эволюции — вневременность, расширяемость, готовность к будущему (требуется оценка ≥7/10)
• Агент скриптов (условно) — проверяет качество кода при наличии скриптов

Мандат эволюции

Качества навыка в первый день недостаточно. Система должна оставаться поддерживаемой и расширяемой по мере роста экосистемы навыков.

Три ключевых принципа