1c-ninja-kit — воркфлоу
Набор для разработки на 1С с агентом: скиллы, правила, роли, MCP-сервер к расширению NinjaLive и установщик для OpenCode под Windows
- 1 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Установщик ставит зависимости и копирует агентов, команды и скрипты в глобальный конфиг OpenCode
- `live`-режим выполняет код и запросы в живой информационной базе и читает журнал регистрации под паролем пользователя базы
Установка
- Работает в
- Сервисы
Ручная установка
powershell -NoProfile -ExecutionPolicy Bypass -File .\install\kit.ps1 depsПосле клонирования репозитория. Дальше `kit.ps1 doctor` и `kit.ps1 apply`. Платформа 1С ставится отдельно.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Установщик ставит зависимости и копирует агентов, команды и скрипты в глобальный конфиг OpenCode
- `live`-режим выполняет код и запросы в живой информационной базе и читает журнал регистрации под паролем пользователя базы
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Репозиторий собирает рабочее окружение для агента, который пишет код на платформе 1С. Внутри двадцать два скилла в `profile/skills`: анализ кода через `bsl-analyzer`, настройка окружения, публикация и остановка веб-клиента, проверки адаптации под 1С:Fresh, составление запросов, версионирование и передача задач. Рядом лежат правила, семь именованных ролей агентов и глобальный каркас задачи с командами `/Задача`, `/Продолжить` и `/Статус`. Компонент `1c-ninja-mcp` работает на OneScript и построен на `autumn-mcp`. Он ведет в двух режимах: `static` ищет по выгрузке конфигурации, `live` обращается по HTTP к расширению `NinjaLive` внутри информационной базы по адресу `/hs/ninja-live`. Список расширений базы дает инструмент `live_extensions_list`, запуск Предприятия для этого не нужен. Установщик `install/kit.ps1` умеет `doctor`, `verify`, `apply`, `lock` и `deps`. Команда `deps` ставит OneScript, `vanessa-runner`, `bsl-analyzer`, `ripgrep`, Node и Playwright, Apache и `toolkit`. Платформу 1С нужно взять своим дистрибутивом. Скиллы и правила подключаются путями в глобальном `~/.config/opencode/opencode.jsonc`.
Для кого. Разработчикам 1С на Windows, которые работают через OpenCode и хотят получить готовый набор скиллов, правил и MCP вместо ручной сборки окружения.
Подходит, если
- Свежая машина без инструментов: платформу 1С вы ставите сами, остальное разворачивает `kit.ps1 deps`
- Агент должен проверить синтаксис и посмотреть журнал регистрации живой информационной базы через расширение
- Расширение конфигурации для 1С:Fresh надо проверить на соответствие требованиям до публикации
- Работа над задачей идет в несколько сессий, и состояние нужно хранить в папке `Задачи/` проекта
- Конфигурацию нужно публиковать на веб-сервер для тестов и снимать публикацию по команде
Не подходит, если
- Вы работаете в Claude Code или Cursor: набор рассчитан на единственный харнесс OpenCode
- Платформа 1С не установлена и ее негде взять: без нее `live`-режим и публикация не работают
- Нужен узкий инструмент, например один MCP для справки по синтакс-помощнику: набор тянет много зависимостей
- Рабочая машина на macOS или Linux: установщик написан на PowerShell под Windows
Пример запроса к агенту
Проверь синтаксис модуля в живой базе через расширение NinjaLive и покажи последние ошибки из журнала регистрации.Ограничения
Платформа 1С ставится отдельно своим дистрибутивом. Для платформы 8.3 используется Apache на порту 8083, для 8.5 на порту 8085. Секреты MCP для 1С нельзя класть в глобальный пользовательский конфиг, который попадает в git.
Установщик рассчитан на Windows и PowerShell. Харнесс один, OpenCode V2. Сторонние инструменты вроде OneScript, `vanessa-runner`, `bsl-analyzer`, Apache и платформы остаются под своими лицензиями и в репозитории не лежат бинарниками.
Статическая часть `1c-ninja-mcp` производна от lekot/mcp-1c под GPL-3.0, а каркас взят из `autumn-mcp`, тоже GPL-3.0. Собственной лицензии у набора на странице репозитория нет, сведения указаны в `NOTICE.md`.
Как отключить. Уберите пути скиллов и правил из `~/.config/opencode/opencode.jsonc` и удалите скопированные агенты, команды и `taskctl.ps1` из каталога `~/.config/opencode`. Публикации на Apache снимите скиллом остановки веб-клиента.
Частые вопросы
Что входит в 1c-ninja-kit?
Скиллы и правила в `profile/`, роли агентов, MCP-сервер `1c-ninja-mcp` с расширением конфигурации `NinjaLive`, установщик `kit.ps1` и документы про харнесс OpenCode. Версия набора указана в файле `VERSION`.
Как установить набор на чистый компьютер?
Клонируйте репозиторий и выполните три команды `kit.ps1`: `deps`, `doctor`, `apply`. Платформу 1С поставьте своим дистрибутивом заранее. Что `deps` ставит и что остается руками, описано в `docs/MACHINE-BOOTSTRAP.md`.
Какие режимы у 1c-ninja-mcp?
`static` ищет по выгрузке конфигурации, `live` работает по HTTP с расширением `NinjaLive` на адресе вида `http://localhost:8083/<app>/hs/ninja-live`. Для режима `live` в окружении задают `NINJA_URL`, `NINJA_USER` и `NINJA_PASSWORD`.
Подойдет ли набор для Claude Code?
В README харнесс один, OpenCode V2: скиллы и правила подключаются путями в его глобальном конфиге. Подключение к Claude Code в документации не описано, поэтому его придется настраивать самостоятельно.
Куда класть пароль информационной базы?
В `opencode.jsonc` проекта, а не в пользовательский конфиг. Правило прямо запрещает секреты MCP для 1С в глобальном конфиге, который может попасть в git.
Обсуждение
Вопросов и отзывов пока нет.
Общая инфраструктура скиллов и инструментов для доработки 1С, подключаемая как git submodule и раскладываемая по нескольким агентам разом
1C-ai-mcp: MCP-мост к 1С:Напарнику
1C-ai-mcp
MCP-сервер, который открывает облачного ассистента 1С:Напарник (1C.ai) и локальный BSL Language Server агентам в Cursor и других IDE
Универсальные Agent Skills для безопасной работы с расширениями 1С: изолированная сессия, выборочная выгрузка и проверка перед применением
Комплект скиллов, агентов и правил для разработки на 1С в Claude Code и Cursor: метаданные, формы, СКД, расширения, базы и веб-клиент
Скилл пакетных операций с платформой 1С: сборка и разборка обработок, загрузка и выгрузка конфигураций и расширений, запуск базы
1C AI Development Kit: набор скиллов для 1С
1C AI Development Kit
Комплект из 52 скиллов Claude Code и агентов, правил Cursor для полного цикла разработки 1С:Предприятие 8.3, собранный из нескольких проектов сообщества
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| 1c-ninja-kit (эта карточка) | нет | 1 | |
| 1c-agent-kit | нет | 0 | другой набор для 1С, без собственного расширения `NinjaLive` для живой базы |
| 1C AI Development Kit | нет | 170 | набор под иной харнесс и состав инструментов |
Коротко о README
В README описаны быстрый старт из трех команд, состав каталогов, глобальный каркас задачи и жесткие правила: порты Apache и список расширений. Версия набора 0.11.0. Ссылки на подробные документы ведут в `docs/opencode.md`, `docs/NAMING.md` и `docs/MACHINE-BOOTSTRAP.md`.