AIKraft/Skills/tinystruct-patterns

tinystruct-patterns

Экспертная помощь по фреймворку tinystruct для Java: создание Application-классов, маршрутов @Action, тестов, работы с HTTP/CLI, SSE, БД через AbstractData и генерации POJO. Полезно при разработке проектов на tinystruct.

affaan-m official Разработка ★ 273k

Что делает навык

Навык предоставляет экспертную помощь по разработке модулей на легковесном Java-фреймворке tinystruct, обеспечивая создание приложений, маршрутизацию и работу с данными. Он реализует принцип, при котором CLI и HTTP являются равноправными клиентами, позволяя методам с аннотацией @Action работать в обоих режимах без изменений. Навык охватывает сериализацию JSON, работу с БД через POJO, SSE, загрузку файлов и интеграцию с MCP.

Когда применять

  • Создание новых Application-модулей путем наследования от AbstractApplication и определения маршрутов через аннотацию @Action.
  • Реализация двунаправленных действий, которые выполняются как из терминала, так и через веб-браузер без модификации кода.
  • Работа с базой данных с использованием POJO, наследующих AbstractData, и XML-маппинга для CRUD-операций без внешних ORM.
  • Генерация POJO-классов из таблиц базы данных с помощью команды generate.
  • Настройка и запуск MCP-серверов и инструментов для взаимодействия с ИИ-моделями.

Как работает

  1. Наследовать класс от AbstractApplication, переопределить метод init() для настройки (например, отключения шаблонов через setTemplateRequired(false)) и указать версию.
  2. Определить публичные методы с аннотацией @Action, которые автоматически регистрируются в ActionRegistry и становятся доступны как HTTP-эндпоинты и CLI-команды.
  3. Для обработки данных использовать нативные компоненты Builder и Builders вместо сторонних библиотек вроде Jackson или Gson.
  4. При работе с БД создавать POJO, наследующие AbstractData, и использовать XML-маппинг для выполнения запросов.
  5. Для MCP-интеграции расширить MCPTool или MCPServer, аннотировать методы @Action и @Argument, строго валидируя входные данные для защиты от инъекций.
  6. Запускать приложение через диспетчер bin/dispatcher, импортируя классы через флаг --import.

Примеры запросов агенту

Создай Java-класс MyService, расширяющий AbstractApplication, с методом greet, который принимает имя и возвращает приветствие, доступный и по HTTP, и из CLI.
Напиши пример использования SSE для отправки уведомления конкретному пользователю и широковещательной рассылки всем подключенным клиентам.
Реализуй MCP-инструмент для приветствия пользователя с валидацией имени на длину и допустимые символы, чтобы предотвратить prompt injection.

Что понадобится

  • Java-окружение с зависимостью org.tinystruct:tinystruct (версия 1.7.26 или новее для поддержки MCP).

Описание составлено по SKILL.md навыка, сверено 06.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «tinystruct-patterns» из репозитория: # https://github.com/affaan-m/ecc
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r tinystruct-patterns/ ~/.claude/skills/tinystruct-patterns/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.