TOTVS ADVPL TLPP Skills
Двадцать скиллов TOTVS для Protheus ERP: генерация MVC, миграция AdvPL в TLPP, ревью, SQL и тесты TIR, файлы CLAUDE.md и AGENTS.md
- 171 ★ репозитория
- Последний коммит
- MIT
Минимальный доступ
Почему такой уровень
- Скиллы дают агенту инструкции для генерации и правки кода Protheus, а выполнение и компиляцию проверяют вы
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/totvs-advpl-tlpp-skillsОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Скиллы дают агенту инструкции для генерации и правки кода Protheus, а выполнение и компиляцию проверяют вы
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Инженерия Protheus компании TOTVS выпустила наборы скиллов по открытому стандарту Agent Skills. Коллекция `advpl-tlpp` содержит двадцать скиллов для разработки на языках AdvPL и TLPP в ERP Protheus, коллекция `superpowers` добавляет четырнадцать общих скиллов для агентов. Среди прикладных: `mvc-generator`, `fwrest-client-generator`, `fwmsexcelxlsx-generator`, `entry-point-designer`, `query-builder`, `tir-test-generator`, `advpl-to-tlpp-migration`, `refactor`, `code-review`, `sql-optimization`, `sql-code-review`, `data-dictionary-lookup`, `advpl-tlpp-compile` и `documentation-writer`. Скиллы работают по принципу постепенного раскрытия: заголовок всегда в контексте агента, тело `SKILL.md` грузится по необходимости, а справочники из `references/` открываются, когда нужны. Это экономит токены. Скилл `advpl-tlpp-sdd` ведет разработку от спецификации по шагам: обсуждение, спецификация, дизайн, задачи, реализация, проверка. Отдельно лежат `CLAUDE.md` и `AGENTS.md` с одинаковым содержанием: язык и экосистема, структура проекта, соглашения по именам и венгерской нотации, обязательные приемы вроде мягкого удаления и фильтра по филиалу, шаблон MVC, современный TLPP, сборка через RDMake и тесты на TIR. Копируют один из двух файлов в корень проекта.
Для кого. Разработчикам кастомизаций для ERP TOTVS Protheus на AdvPL и TLPP, которые работают с Claude Code, Cursor или Copilot.
Подходит, если
- Модель данных Protheus заставляет писать формы MVC с `MenuDef`, `ModelDef` и `ViewDef`, и скилл `mvc-generator` готовит заготовку
- Старый код на AdvPL переводят в TLPP с пространствами имен и аннотациями через `advpl-to-tlpp-migration`
- Запросы к базе Protheus проверяют скиллами `sql-code-review` и `sql-optimization`
- Тесты для новых функций пишет `tir-test-generator` на фреймворке TIR
- Корень проекта получает `CLAUDE.md` или `AGENTS.md`, чтобы агент знал соглашения Protheus с первого сообщения
Не подходит, если
- Проект не на Protheus: скиллы привязаны к AdvPL, TLPP и фреймворкам TOTVS
- Нужно сгенерировать готовый к выпуску код без человеческого ревью: сама TOTVS предупреждает, что ИИ может ошибаться
- Требуется общая методика разработки без привязки к ERP: подойдет коллекция `superpowers` отдельно от прикладных скиллов
Пример запроса к агенту
Создай по скиллу mvc-generator форму справочника клиентов с ModelDef и ViewDef и покажи проверку по скиллу code-reviewОграничения
README и тексты скиллов написаны на португальском языке. Скиллы кладут в каталог агента вручную: `~/.claude/skills`, `~/.agents/skills`, `~/.copilot/skills` для личных, `.claude/skills`, `.github/skills`, `.agents/skills` для проектных. Пакеты версий выходят на странице релизов. Файлы `CLAUDE.md` и `AGENTS.md` равноценны, использовать нужно только один из них. Компиляция через `advpl-tlpp-compile` опирается на расширение TDS для VS Code, а сгенерированный код требует проверки человеком и тестовой среды Protheus.
Как отключить. Удалите папки скиллов из каталога агента и `CLAUDE.md` или `AGENTS.md` из корня проекта.
Частые вопросы
Как поставить скиллы TOTVS для AdvPL в Claude Code?
Скачайте пакет со страницы релизов и положите папки скиллов в `.claude/skills` проекта или в `~/.claude/skills`. Файл `instructions/CLAUDE.md` скопируйте в корень проекта.
Какие агенты поддерживаются?
Claude Code, Cursor, GitHub Copilot, Windsurf и Cline, а также Aider, Gemini CLI, OpenAI Codex, Roo Code, OpenCode, Amazon Q и другие, которые читают скиллы по открытому стандарту.
Чем отличаются CLAUDE.md и AGENTS.md?
Только именем: содержание одинаковое. `CLAUDE.md` читает Claude Code, `AGENTS.md` читают Copilot, Cursor, Windsurf, Cline и другие. Копируйте один файл.
Что делает скилл advpl-tlpp-sdd?
Ведет разработку от спецификации: обсуждение, спецификация, дизайн, задачи, реализация и проверка. Для каждого шага есть справочник в `references/`, а состояние и передачу между сессиями описывают `state-management` и `session-handoff`.
Можно ли взять только часть скиллов?
Да. Каждая папка самостоятельна, поэтому копируйте только нужные, например `query-builder` и `sql-code-review`. Справочники лежат внутри папок скиллов.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыПлагин Claude Code для разработки на ADVPL и TLPP в ERP TOTVS Protheus: 15 команд, 10 агентов, ревью, миграция и тесты
Два скилла для Codex и Claude Code: prd ведет живой документ с чеклистом внедрения, review смотрит на решения глазами пользователя
Библиотека скиллов для Claude Code, Cursor и Codex: ревью командой агентов, TDD, стековые PR, оценка готовности репозитория
PRP (Product Requirement Prompts)
PRPs-agentic-eng
Набор скиллов собирает Product Requirement Prompt: цель, пути к файлам, образцы кода и команды проверки для агента.
Девять личных скиллов инженера: цепочка от идеи до PR, поиск стандартов, песочница с циклом ревью и страницы-разборы изменений
15 скиллов для Claude Code и Codex: Laravel, Docker, UI, отладка, тесты и документация в четырех готовых плагин-пакетах
Коротко о README
README объясняет, что такое Agent Skills и как работает постепенное раскрытие, перечисляет поддерживаемых агентов и две коллекции, потом показывает пути каталогов для личных и проектных скиллов. Отдельный раздел посвящен `CLAUDE.md` и `AGENTS.md` с таблицей их разделов. Дальше идут агенты по заказу, вклад и безопасность.