advpl-specialist — плагин
Плагин Claude Code для разработки на ADVPL и TLPP в ERP TOTVS Protheus: 15 команд, 10 агентов, ревью, миграция и тесты
- 194 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Хук перекодирует файлы проекта на месте, а команды генерации создают и правят исходники.
- Для поиска документации плагин обращается в сеть и может открыть страницу в браузере через Playwright MCP.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add plugins/advpl-specialistОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Хук перекодирует файлы проекта на месте, а команды генерации создают и правят исходники.
- Для поиска документации плагин обращается в сеть и может открыть страницу в браузере через Playwright MCP.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
advpl-specialist — плагин для Claude Code, который учит агента писать код для ERP-системы TOTVS Protheus на языках ADVPL и TLPP. Плагин приносит 15 команд, 10 специализированных агентов и 19 справочников по платформе. Команды вызывают по имени, например `/advpl-specialist:generate function FATA050 --module FAT`. Для разработчиков есть генерация функций, классов TLPP, MVC, REST API, отчетов и заданий, перенос процедурного ADVPL в объектный TLPP и разбор ошибок компиляции, выполнения и блокировок. Команда `review` проверяет код на соответствие правилам хорошей практики, быстродействия и безопасности, а `test` создает модульные тесты ProBat. `docs` ищет описание функций и таблиц словаря, `refactor` советует улучшения структуры, `document` пишет заголовок Protheus.doc, а `changelog` собирает журнал изменений из `git diff`. Для функциональных консультантов команда `explain` объясняет код простым языком, а `sxgen` собирает скрипты словаря данных SX по описанию полей. Хук следит за кодировкой: каждый файл ADVPL, который плагин пишет или правит, приводится к Windows-1252, которую ждет Protheus.
Для кого. Программистам и консультантам, которые сопровождают и кастомизируют TOTVS Protheus, в том числе пишут точки входа, MVC-формы и REST-сервисы на ADVPL.
Подходит, если
- Для модуля продаж нужна новая функция по типовому шаблону, а писать каркас вручную долго.
- Старый процедурный файл `FATA001.prw` переводят в TLPP с классами и пространствами имен.
- Продакшн падает с ошибкой `Variable does not exist`, и надо понять, где в коде потерялась переменная.
- Консультанту передали чужую кастомизацию, и он хочет прочитать ее объяснение без чтения кода.
- Для новой таблицы нужны скрипты словаря SX3, SIX и SX1, а описание есть только на словах.
Не подходит, если
- Платформа другая: плагин знает только Protheus, ADVPL и TLPP, а для 1С или SAP он не подходит.
- Файлы нельзя перекодировать: хук приводит файлы ADVPL к Windows-1252, и для этого нужен `iconv`.
- Доступ к сети закрыт: справочники встроены, но поиск свежей документации TOTVS идет через WebSearch и Playwright MCP.
- Нужны материалы на русском: документация и описания команд плагина написаны по-португальски.
Пример запроса к агенту
Запусти `/advpl-specialist:diagnose "Variable does not exist: cCodCli"` по файлу `src/FATA050.prw` и предложи исправление.Ограничения
Плагин сделан для экосистемы TOTVS Protheus и работает в проектах с файлами `.prw`, `.tlpp`, `.prx`, `.ch`. Документация и описания команд на португальском. Для свежих сведений с портала TDN плагин ходит в сеть и при отказе использует Playwright MCP, который советуют подключить отдельно. Хук перекодирования требует `iconv` в `PATH`. Он есть в macOS, Linux, WSL и Git Bash. Символы, которых нет в Windows-1252, например эмодзи, вызывают предупреждение, а файл остается в UTF-8. Последний коммит сделан в сентябре 2026 года.
Как отключить. Отключите плагин через меню `/plugin` или удалите его командой `/plugin uninstall advpl-specialist@thalysjuvenal-advpl-specialist`. Скопированные в проект файлы `AGENTS.md`, `.github/copilot-instructions.md` и папки команд удалите вручную.
Частые вопросы
Как поставить advpl-specialist в Claude Code?
Выполните `/plugin marketplace add thalysjuvenal/advpl-specialist`, затем `/plugin install advpl-specialist@thalysjuvenal-advpl-specialist`. Для проверки откройте проект Protheus и вызовите `/advpl-specialist:docs FWExecView`.
Работает ли плагин в Cursor, Copilot и Gemini CLI?
Да. Скиллы ставит `npx skills add thalysjuvenal/advpl-specialist`. Команды лежат в папках `.cursor/commands/`, `.github/prompts/` и `.gemini/commands/`, их копируют в свой репозиторий.
Какие команды есть у плагина?
Пятнадцать: `generate`, `migrate`, `diagnose`, `docs`, `review`, `test`, `process`, `explain`, `refactor`, `document`, `changelog`, `sxgen`, `advpr`, `smartx` и `smartview`. Каждую вызывают в виде `/advpl-specialist:имя`.
Зачем нужен Playwright MCP?
Он запасной путь для поиска документации. Если WebSearch и WebFetch не сработали, плагин открывает страницу TDN в настоящем браузере. Подключить его советуют командой `claude mcp add playwright -- npx @anthropic-ai/mcp-playwright@latest`.
Почему плагин меняет кодировку файлов?
Protheus ожидает Windows-1252. Хук переводит в нее каждый файл `.prw`, `.tlpp`, `.prx`, `.ch`, `.prg`, `.apw`, `.aph` и `.tlh`, который плагин записал или изменил.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныДвадцать скиллов TOTVS для Protheus ERP: генерация MVC, миграция AdvPL в TLPP, ревью, SQL и тесты TIR, файлы CLAUDE.md и AGENTS.md
Плагин для Claude Code включает режим эксперта по Delphi: стиль кода, аудит, ревью, тесты DUnitX и сквозные проверки приложений
GTPlanner превращает описание задачи в PRD: планирование, подбор стека и документ дизайна прямо внутри Claude Code.
Плагин превращает Claude Code в команду из 16 агентов: план по документам, TDD и 9 проверок перед слиянием.
Плагин готовит проект к работе с Claude Code: инструкции, тесты, ревью, TDD, рефакторинг и повторяемый цикл исправлений
Плагин AI-SDLC для Claude Code ведет задачу от спецификации до PR: проверка готовности, исполнитель и несколько ревьюеров.
Коротко о README
README открывается быстрым стартом из трех команд, затем делит возможности для разработчиков и функциональных консультантов. Дальше идут установка, подключение к Copilot, Cursor и Gemini, таблицы команд и агентов и структура проекта.