xlflow CLI
CLI для разработки VBA в Excel: выгрузка, правка, линт, тесты и запуск макросов из терминала со скиллом для агентов.
- 95 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- CLI запускает макросы VBA в Excel через COM и записывает код в книги, а скилл разрешает агенту делать это самостоятельно.
Установка
- Работает в
Ручная установка
winget install HarumiWeb.XlflowТакже `scoop bucket add harumiweb https://github.com/harumiWeb/scoop-bucket` и `scoop install xlflow`. Затем `xlflow skill install`.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- CLI запускает макросы VBA в Excel через COM и записывает код в книги, а скилл разрешает агенту делать это самостоятельно.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
xlflow превращает книги `.xlsm`, надстройки `.xlam` и двоичные `.xlsb` в проект под контролем версий, где VBA выгружается, правится, проверяется линтером, загружается обратно, тестируется и запускается из командной строки. Модули, классы, UserForm и модули документов попадают в обычные файлы, а формулы листов и именованные диапазоны выгружаются в JSONL по областям. Для агентов команды возвращают стабильный JSON, а встроенный скилл ставится командой `xlflow skill install` либо при создании проекта через `xlflow new Book.xlsm --with-skill`. Дальше задачу формулируют обычным языком, например `/xlflow` и просьба записать «Hello, world!» в A1. В комплекте форматтер, сравнение книг, сервер LSP и расширение VS Code.
Для кого. Разработчикам макросов Excel, которые хотят Git, тесты и правки агента вместо ручной работы в редакторе VBA.
Подходит, если
- Макросы живут в книге, и их историю изменений никто не ведет.
- Агент должен править VBA и сам прогонять тесты и линтер.
- Нужно сравнить две версии книги: значения, формулы, листы и код.
- Надо запустить макрос с типизированными аргументами из скрипта.
Не подходит, если
- Нужны операции с книгой без Excel: для них требуется Microsoft Excel и COM.
- Работа идет на Mac, где Excel COM недоступен.
- Доступ к объектной модели проекта VBA запрещен политикой компании.
Пример запроса к агенту
/xlflow Создай макрос VBA, который записывает «Hello, world!» в ячейку A1, и прогони тесты.Ограничения
Операции с книгами идут на Windows через Microsoft Excel и COM с мостом .NET, команды без Excel вроде `lint`, `fmt` и части `diff` работают где угодно. Для `pull`, `push` и `run` включите в Excel доверие к объектной модели проекта VBA, иначе команды падают даже при установленном Excel. Архив для Linux содержит только CLI для WSL, моста .NET в нем нет, а `go install` ставит один xlflow без `xlflow-excel-bridge.exe`. Мост может блокироваться AppLocker, WDAC, Defender или антивирусом, подписи Authenticode у файлов нет, проверяйте контрольные суммы.
Как отключить. Удалите скилл из каталога скиллов агента и сам CLI через менеджер пакетов (`winget uninstall HarumiWeb.Xlflow`). Выгруженные файлы проекта остаются на диске.
Частые вопросы
Как поставить скилл для агента?
Командой `xlflow skill install` или через `xlflow new Book.xlsm --with-skill`. Для менеджера скиллов подойдет `npx skills add harumiWeb/xlflow/internal/agentskill/templates --skill xlflow`.
Что нужно для работы с книгой?
Windows, установленный Microsoft Excel и включенное доверие к объектной модели проекта VBA. WSL подходит как фронтенд, а Excel выполняется в Windows.
Как подключиться к открытой книге?
Командой `xlflow attach --active --json`: она проверит активную книгу, прежде чем с ней работать.
Что ловит линтер?
Пропущенный `Option Explicit`, `Select` и `Activate`, широкую обработку ошибок, неявные Variant, неквалифицированные объекты Excel, публичные поля модулей и интерактивные операции.
Как выгрузить формулы?
Командой `xlflow formulas pull --src Book.xlsx --out formulas --json` либо `xlflow pull --formulas --json` внутри проекта.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыЛинтер с автофиксами, LSP, поиск по документации платформы и метаданные-скаффолдинг для 1С:Элемент, плюс MCP-сервер и расширение VS Code на одном движке
Плагин для Claude Code и Codex вводит режимы xdo, xdel и xflow: главный агент планирует, исполнитель кодит, оценщик проверяет.
Скилл для Codex и Claude Code превращает идеи и баги в работающий код: писатель, тестер и ревьюеры в изолированных ветках
agent-skills (misaka-mikoto-tech)
agent-skills
Три скилла одного автора для агента на Windows: безопасный PowerShell, чтение видео Bilibili и работа с открытым Unity Editor
CLI превращает спецификацию OpenAPI в Agent Skill из markdown-файлов, которые агент читает по частям и экономит контекст.
Официальные скиллы TMS Software: агент пишет код на Delphi и .NET с ORM Aurelius и Excel-библиотекой FlexCel без выдуманных API.
Коротко о README
Фреймворк называет себя обвязкой вокруг Excel VBA и делает проекты управляемыми из терминалов, скриптов и агентов. Примеры, созданные агентом по коротким просьбам, показывают генератор QR-кодов, тетрис и выбор даты в UserForm.