biz-skill-creator
GarrusHuang/biz-skill-creatorИнструмент для создания, изменения и тестирования бизнес-скиллов на базе Claude. Поддерживает глубокий анализ требований по трём измерениям, накопление доменных знаний, сбор интерфейсов, Mock-тестирование и итеративное улучшение.
Установка
git clone https://github.com/GarrusHuang/biz-skill-creator.gitREADME
biz-skill-creator
Инструмент полного жизненного цикла бизнес-скиллов — от глубокого анализа требований до тестирования и валидации, создание качественных бизнес-скиллов в одном месте.
Основан на расширении Anthropic skill-creator, глубоко адаптированном под бизнес-сценарии.
Область применения
Предназначен для команд, которым нужно упаковать бизнес-процессы в AI-скиллы: специалисты по внедрению, продакт-менеджеры, инженеры-разработчики.
Типичные сценарии:
- Упаковка операционных процессов ERP/CRM/HIS-систем в скиллы
- Автоматизация повторяющихся запросов данных, генерации отчётов, обработки документов
- Быстрая адаптация под требования разных клиентов (режим настройки параметров)
Четыре режима
| Режим | Триггер | Описание |
|---|---|---|
| Создание | «Сделай новый скилл» | Полный цикл: анализ требований → сбор интерфейсов → генерация скилла → тестирование |
| Изменение | «Измени этот скилл» | Импорт существующего скилла, сравнение изменений и редактирование |
| Настройка параметров | «Развернуть у нового клиента» | Изменение только бизнес-параметров без затрагивания основной логики |
| Импорт знаний | «Сначала загрузи доменные знания» | Извлечение доменных знаний из проектной документации для последующего переиспользования |
Ключевые возможности
Глубокий анализ требований (Phase 1)
Для каждого бизнес-шага рекурсивно задаются вопросы по трём измерениям — до полного устранения неоднозначностей:
| Измерение | Вопросы |
|---|---|
| Источник данных | Откуда берутся данные? (ввод пользователя / интерфейс / фиксированная конфигурация) |
| Логика принятия решений | Как выбирается путь? (фиксированные правила / выбор пользователя / AI-вывод) |
| Обработка исключений | Что делать при отсутствии данных или неоднозначности? (значение по умолчанию / ошибка / деградация) |
Накопление доменных знаний (Phase 0)
При первом контакте с новой бизнес-областью автоматически извлекает бизнес-объекты, термины и связи между модулями из проектной документации и сохраняет их в references/domains/. При последующем создании скиллов в той же области знания переиспользуются напрямую.
Инкапсуляция интерфейсов (Phase 3-4)
Все внешние интерфейсы инкапсулируются в Python-скрипты в директории scripts/ с единообразной обработкой аутентификации, ошибок и JSON-вывода. Поддерживается режим --mock для тестирования.
Тестирование и валидация
Поддерживаются два окружения:
- С subagent (Claude Code / Cowork): параллельная оценка + автоматическое выставление оценок + Benchmark + Eval Viewer
- Без subagent (однессионное окружение): последовательное выполнение + inline-оценка + упрощённый Benchmark
Итеративное улучшение
Структурированная методология улучшений:
- Обобщение из обратной связи без переобучения
- Сохранение скилла компактным, удаление неработающих инструкций
- Объяснение «почему», а не накопление MUST
- Обнаружение переиспользуемых скриптов из транскриптов
Оптимизация триггера Description
Автоматизированный цикл оптимизации (scripts/run_loop.py) или ручная настройка для повышения точности срабатывания скилла.
Структура файлов
biz-skill-creator/ # Корень репозитория GitHub
├── README.md
├── LICENSE.txt # Apache 2.0
└── skills/
└── biz-skill-creator/ # ← Скопировать эту директорию при установке
├── SKILL.md # Основные инструкции
├── _meta.json # Метаданные
├── agents/ # Инструкции для subagent
│ ├── grader.md # Оценка
│ ├── comparator.md # Слепое A/B-сравнение
│ └── analyzer.md # Абдуктивный анализ
├── assets/
│ └── eval_review.html # Шаблон проверки триггерной оценки
├── eval-viewer/ # Визуализация результатов тестирования
│ ├── generate_review.py
│ └── viewer.html
├── references/ # Справочная документация
│ ├── schemas.md # Спецификации JSON-формата
│ ├── testing-basics.md # Основы тестирования
│ ├── testing-tools.md # Тестирование с адаптацией окружения
│ ├── testing-iteration.md # Методология итеративного улучшения
│ ├── templates.md # Шаблоны форматов
│ ├── workflows.md # Паттерны рабочих процессов
│ ├── output-patterns.md # Паттерны вывода
│ └── progressive-disclosure-patterns.md
└── scripts/ # Утилиты
├── run_loop.py # Автоматический цикл Eval + Improve
├── run_eval.py # Оценка триггеров
├── improve_description.py # Оптимизация Description
├── aggregate_benchmark.py # Агрегация Benchmark
├── generate_report.py # Генерация отчётов
├── quick_validate.py # Валидация скилла
├── package_skill.py # Упаковка в файл .skill
└── utils.py # Общие утилиты
Установка
После клонирования репозитория скопируйте директорию skills/biz-skill-creator/ в место хранения ваших скиллов:
git clone https://github.com/GarrusHuang/biz-skill-creator.git /tmp/biz-skill-creator
# Claude Code
cp -r /tmp/biz-skill-creator/skills/biz-skill-creator ~/.claude/skills/biz-skill-creator
# Другие платформы (поместить в соответствующую директорию Skills)
cp -r /tmp/biz-skill-creator/skills/biz-skill-creator /path/to/your/skills/biz-skill-creatorБыстрый старт
После установки скажите AI-ассистенту:
- «Сделай скилл для проверки статуса заказа» → переход в режим создания
- «Измени этот скилл генерации отчётов» → переход в режим изменения
- «Развернуть этот скилл в окружении нового клиента» → переход в режим настройки параметров
Благодарности
Разработан как расширение skill-creator на базе проекта Anthropic skills. Распространяется под лицензией Apache 2.0.