Bundles Forge
OdradekAI/bundles-forgeИнструментарий для разработки bundle-плагинов — AI-плагинов с взаимосвязанными рабочими процессами. Поддерживает Claude Code, Cursor, Codex и другие платформы. Включает 8 навыков: проектирование, генерация структуры, аудит, тестирование и публикация.
Установка
git clone https://github.com/OdradekAI/bundles-forge.gitREADME
Bundles Forge
Инструментарий для создания bundle-плагинов — AI-плагинов для программирования, организованных вокруг совместных рабочих процессов на основе навыков — для Claude Code, Cursor, Codex, OpenCode, Gemini CLI и OpenClaw.
Что такое bundle-плагин?
Одиночный навык (SKILL.md) выполняет одну задачу — AI-агент обнаруживает его по полю description и загружает по требованию. Bundle-плагин идёт дальше: несколько навыков ссылаются друг на друга и образуют рабочий процесс, где результат одного навыка передаётся следующему.
graph LR
A["Skill A"] -->|output feeds| B["Skill B"]
B -->|output feeds| C["Skill C"]
C -->|validates| ASam bundles-forge является bundle-плагином — blueprinting создаёт дизайн, scaffolding генерирует проект на его основе, auditing проверяет результат, а optimizing итерирует по найденным проблемам.
Если ваш плагин содержит 3+ навыка, образующих рабочий процесс, — вы создаёте bundle-плагин. Этот инструментарий предоставляет генерацию структуры, контроль качества и мультиплатформенную публикацию для такого паттерна.
Быстрый старт
Установка (Claude Code)
-
Добавьте маркетплейс:
/plugin marketplace add OdradekAI/bundles-forge -
Установите плагин:
/plugin install bundles-forge@bundles-forge-dev
Или клонируйте локально для разработки:
git clone https://github.com/OdradekAI/bundles-forge.git
cd bundles-forge
# Добавьте локальный маркетплейс
/plugin marketplace add ./
# Установите плагин
/plugin install bundles-forge@bundles-forge-devДругие платформы: см. раздел Поддержка платформ ниже.
Путь A: Создание нового bundle-плагина
bundles-forge:blueprinting
Запускает структурированное интервью для проектирования вашего проекта — область применения, целевые платформы, декомпозиция навыков. Когда дизайн готов, агент автоматически переходит к scaffolding (генерация проекта), а затем к authoring (написание SKILL.md).
Путь B: Аудит существующего проекта
cd your-bundle-plugin-project
bundles-forge:auditing
Выполняет оценку качества по 10 категориям с проверками безопасности на основе паттернов по 7 категориям файлов.
Концепции
| Концепция | Описание |
|---|---|
| Skill | Атомарная единица возможностей (SKILL.md) — обнаруживается по описанию, загружается по требованию |
| Plugin | Единица упаковки и распространения — объединяет навыки, агентов, хуки и другое |
| Subagent | Изолированный AI-ассистент для делегированных задач с собственным контекстным окном |
| Hook | Shell/HTTP/LLM/Agent-действие, автоматически срабатывающее при событиях жизненного цикла |
| MCP | Открытый стандарт, подключающий Claude к внешним инструментам и источникам данных |
Подробные объяснения, архитектурные решения и диаграммы → Руководство по концепциям
Навыки
8 навыков охватывают полный жизненный цикл bundle-плагина и организованы в два уровня:
- Оркестраторы (
blueprinting,optimizing,releasing) — диагностируют, принимают решения и делегируют. Объединяют несколько навыков для достижения многошаговых целей. - Исполнители (
scaffolding,authoring,auditing,testing) — работники с единственной ответственностью. Могут вызываться напрямую пользователями или диспетчеризоваться оркестраторами.
flowchart LR
Design["blueprinting"] --> Scaffold["scaffolding"]
Design -->|"content authoring"| Write["authoring"]
Design -->|"initial audit"| Audit["auditing"]
Audit -->|issues| Optimize["optimizing"]
Optimize -->|"delegate changes"| Write
Optimize --> Audit
Audit -->|pass| Test["testing"]
Test -->|pass| Release["releasing"]| Фаза | Навык | Что делает |
|---|---|---|
| Проектирование | blueprinting | Трёхфазное интервью (исследование потребностей → архитектурный дизайн → ревью дизайна) → документ дизайна → оркестрирует конвейер создания: scaffolding, authoring, проектирование рабочего процесса и первичный аудит. |
| Генерация структуры | scaffolding | Генерирует структуру проекта из дизайна, добавляет или удаляет поддержку платформ — манифесты, хуки, скрипты, bootstrap-навык и файлы для каждой платформы. |
| Написание | authoring | Руководит написанием SKILL.md и agents/*.md — frontmatter, описания, инструкции, интеграция контента и прогрессивное раскрытие через references/. |
| Аудит | auditing | Оценка качества по 10 категориям, включая проверки безопасности на основе паттернов по 7 категориям файлов. |
| Тестирование | testing | Динамическая верификация — локальная установка dev-маркетплейса, smoke-тесты хуков, обнаружение компонентов и проверки готовности для разных платформ. |
| Оптимизация | optimizing | Инженерные улучшения — настройка триггеров описаний, эффективность токенов, реструктуризация рабочего процесса, добавление навыков для заполнения пробелов и итерация по обратной связи. |
| Публикация | releasing | Оркестрирует предрелизный конвейер: проверка расхождения версий, аудит, тестирование, согласованность документации, ревью связности изменений, обновление версии, обновление CHANGELOG и руководство по публикации. |
Bootstrap мета-навык using-bundles-forge предоставляет лёгкий промпт сессии через хуки и полный контекст маршрутизации по требованию через инструмент Skill.
Самостоятельное использование: authoring, auditing и optimizing могут вызываться независимо для любого существующего проекта без прохождения полного жизненного цикла.
Руководства
Каждый навык имеет сопроводительное руководство в docs/ с подробным описанием использования, примерами и обоснованием дизайна:
| Руководство | Содержание |
|---|---|
| Руководство по концепциям | Основная терминология, архитектурные диаграммы и проектные решения |
| Руководство по blueprinting | Трёхфазное интервью, стратегия диалога, формат документа дизайна, паттерны декомпозиции |
| Руководство по scaffolding | Анатомия проекта, адаптеры платформ, система шаблонов |
| Руководство по authoring | Паттерны написания SKILL.md, прогрессивное раскрытие, написание агентов |
| Руководство по auditing | Чеклисты, шаблоны отчётов, интеграция с CI |
| Руководство по optimizing | Настройка описаний, сокращение токенов, реструктуризация рабочего процесса |
| Руководство по releasing | Предрелизный конвейер, управление версиями, руководство по публикации |