tinystruct-patterns
Экспертная помощь по фреймворку tinystruct для Java: создание Application-классов, маршрутов @Action, тестов, работы с HTTP/CLI, SSE, БД через AbstractData и генерации POJO. Полезно при разработке проектов на tinystruct.
Что делает навык
Навык предоставляет экспертную помощь по разработке модулей на легковесном Java-фреймворке tinystruct, обеспечивая создание приложений, маршрутизацию и работу с данными. Он реализует принцип, при котором CLI и HTTP являются равноправными клиентами, позволяя методам с аннотацией @Action работать в обоих режимах без изменений. Навык охватывает сериализацию JSON, работу с БД через POJO, SSE, загрузку файлов и интеграцию с MCP.
Когда применять
- Создание новых Application-модулей путем наследования от AbstractApplication и определения маршрутов через аннотацию @Action.
- Реализация двунаправленных действий, которые выполняются как из терминала, так и через веб-браузер без модификации кода.
- Работа с базой данных с использованием POJO, наследующих AbstractData, и XML-маппинга для CRUD-операций без внешних ORM.
- Генерация POJO-классов из таблиц базы данных с помощью команды generate.
- Настройка и запуск MCP-серверов и инструментов для взаимодействия с ИИ-моделями.
Как работает
- Наследовать класс от AbstractApplication, переопределить метод init() для настройки (например, отключения шаблонов через setTemplateRequired(false)) и указать версию.
- Определить публичные методы с аннотацией @Action, которые автоматически регистрируются в ActionRegistry и становятся доступны как HTTP-эндпоинты и CLI-команды.
- Для обработки данных использовать нативные компоненты Builder и Builders вместо сторонних библиотек вроде Jackson или Gson.
- При работе с БД создавать POJO, наследующие AbstractData, и использовать XML-маппинг для выполнения запросов.
- Для MCP-интеграции расширить MCPTool или MCPServer, аннотировать методы @Action и @Argument, строго валидируя входные данные для защиты от инъекций.
- Запускать приложение через диспетчер bin/dispatcher, импортируя классы через флаг --import.
Примеры запросов агенту
Что понадобится
- Java-окружение с зависимостью org.tinystruct:tinystruct (версия 1.7.26 или новее для поддержки MCP).
Описание составлено по SKILL.md навыка, сверено 06.10.2026.
Как подключить
SKILL.md к навыкам ассистентаНавык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.