[{"data":1,"prerenderedAt":138},["ShallowReactive",2],{"$fBBQ5ulyG5jVWbIBJe3r8F-kTKQKf1scMJiu0B6qzX5k":3,"$f6KHF6RQpcjZbkyGNMusVg3jXzLavs19zIo8IFt2ILk8":5,"$f7AVZHmPutZ23_8XKkLbDtEszKCuiY3yPjIDp9eRXGag":112,"$fAlIqmhlsr-Cl-RgbVNfV6DwvkjF6MCEutNPPlF-ZSfo":114},{"data":4},[],{"data":6,"meta":108},[7],{"id":8,"documentId":9,"title":10,"seo_title":11,"summary":12,"seo_description":13,"slug":14,"published_date":15,"body":16,"content":17,"createdAt":39,"updatedAt":40,"publishedAt":41,"blogauthor":42,"cover":51,"categories":97},311,"exysdpdnu51pfnxetglro85k","Skill of the Week: Spring Data JPA. Никто не знает JPA, даже AI","Spring Data JPA skill для AI-агента: Claude Code и Codex","Даже Opus 4.8 ошибается в JPA, например добавляет CascadeType.ALL. Разбираем Spring Data JPA skill, который учит агента работать со Spring Data правильно.","Skill of the Week: Spring Data JPA skill учит AI-агента правильно работать с сущностями, связями и репозиториями. Установка, ручной вызов и применение в плане.","skill-of-the-week-spring-data-jpa-nikto-ne-znaet-jpa-dazhe-ai","2026-06-17","Знание и умение разрабатывать на Spring Data JPA — это обязательный навык для разработчика, если он хочет заниматься разработкой приложений на Spring. Этого мы ожидаем и от AI-агента.\n\nУдовлетворяют ли наши AI-агента этому условию? Во многом зависит от того, насколько продвинутую модель вы используете. Значит ли это, что Opus 4.8 не совершает ошибок? Совсем нет. Более того, иногда удивляешься, почему еще вчера он настроил связь правильно, а уже сегодня сделал ту же работу, но добавил `CascadeType.ALL`.\n\nВ сегодняшнем эпизоде еженедельной рубрики Skill of the Week разберёмся, как, используя [Spring Data JPA Skill](https:\u002F\u002Fgithub.com\u002FAmplicode\u002Fspring-skills\u002Fblob\u002Fmain\u002Fskills\u002Fspring-data-jpa\u002FSKILL.md), научить своего агента важным навыкам при работе со Spring Data JPA.\n\n> Этот Skill входит в состав набора скиллов для Spring-разработчика. Исходный код всех скиллов [доступен на GitHub](https:\u002F\u002Fgithub.com\u002FAmplicode\u002Fspring-skills). Рекомендую поставить звёздочку, чтобы не потерять.\n\n\u003Ch3 id=\"kachestvo-modeli-v-ai-agente\">Качество модели в AI-агенте\u003C\u002Fh3>\n\nОткрывая очередной пост с описанием того, как улучшить поведение агента, можно обнаружить, как автор, используя Claude Code 20x Max-подписку, не обращая внимания на лимиты и ограничения, настраивает Harness. Однако реальность немного отличается.\n\nРеальное рабочее окружение накладывает свои ограничения. Начиная со стоимости самих подписок, например, работодатель выдает Claude Code на 20$ или же базовую подписку на Cursor, и заканчивая разрешением использовать только те модели, что доступны в контуре организации. Такие ограничения приводят разработчика к необходимости использовать в качестве основных модели среднего класса: Sonnet, Haiku, OpenAI OSS 120b, MiniMax... Я буду использовать Haiku\u002FSonnet далее в примерах.\n\nИспользование Skill, которые улучшают понимание фреймворков для AI-агентов с моделями среднего класса, имеет критически важное значение для получения качественного результата. Такой Skill может легко [поднять качество](https:\u002F\u002Fwww.skillsbench.ai\u002F) генерации в отдельных задачах с Haiku до Opus.\n\n![Обратите внимание, что Haiku со скиллами приближается к Opus без них]({{strapiUrl}}\u002Fuploads\u002F495e2716b3aa65a0ae57ee654f70595a_41b7464766.webp)\n\n\u003Ch3 id=\"spring-data-jpa\">Spring Data JPA\u003C\u002Fh3>\n\n[Spring Data JPA](https:\u002F\u002Fgithub.com\u002FAmplicode\u002Fspring-skills\u002Fblob\u002Fmain\u002Fskills\u002Fspring-data-jpa\u002FSKILL.md) — Skill, задача которого — предоставить AI-агенту знания о том, как именно ведется разработка на Spring Data JPA. Дать представление о том, что такое сущность, поле сущности, типы полей, правила связывания сущностей. Каким правилам необходимо следовать при использовании Lombok совместно с JPA, а также что учитывать при генерации equals\u002Fhashcode\u002FtoString (с\u002Fбез учета наличия Lombok).\n\nУникальностью данного Skill является тот факт, что он учитывает особенности\u002Fсоглашения при работе с JPA именно в вашем\u002Fтекущем проекте (естественно, если это в явном виде не порождает ошибки). Делает он это, выполняя анализ в несколько шагов. Данный анализ может быть сохранен в память проекта; как результат, повторный вызов Skill пропустит этот шаг.\n\n\u003Ch3 id=\"kak-ustanovit\">Как установить\u003C\u002Fh3>\n\nУстановить Spring Skills глобально во все обнаруженные агенты:\n\n```powershell\nnpx skills add Amplicode\u002Fspring-skills -g\n```\n\nУстановить только для конкретных агентов (пример — Claude Code + Codex + Gemini CLI):\n\n```powershell\nnpx skills add Amplicode\u002Fspring-skills -g -a claude-code -a codex -a gemini-cli\n```\n\nС более подробной инструкцией можно ознакомиться [тут](https:\u002F\u002Famplicode.ru\u002Fdocumentation\u002Fspring-agent\u002F).\n\n\u003Ch3 id=\"yavnaya-ruchnaya-aktivacziya\">Явная\u002Fручная активация\u003C\u002Fh3>\n\nДля начала разберемся, как воспользоваться Skill в ручном режиме. Необходимо это в ситуации, когда вы, например, занимаетесь моделированием доменной области, создавая JPA-сущности.\n\nВ идеальном мире агент должен из контекста задачи понять, что необходимо выполнить активацию Skill, и выполнить ее. К сожалению, это не всегда так, особенно на моделях среднего класса, поэтому приходится указывать активацию непосредственно в чате или, например, в плане, если вы используете режим планирования.\n\nВ качестве примера сгенерируем чистый Spring Boot-проект, используя [start.spring.io](https:\u002F\u002Fstart.spring.io\u002F) и добавив в него только два модуля: Spring Data JPA и Bean Validation. Далее попросим Claude Code с Haiku создать сущности ветеринара, домашнего животного и визита, но усложним задачу, указав, что домашнее животное является частью агрегата владелец, а визит является независимым рутом.\n\n\u003Cvideo src=\"https:\u002F\u002Fstorage.yandexcloud.net\u002Famplicode-site\u002Farticles\u002Fsow-spring-data-jpa\u002Fbasic.mp4\" controls muted loop playsinline width=\"100%\" poster=\"{{strapiUrl}}\u002Fuploads\u002Fcover_skill_of_the_week_spring_data_jpa_nikto_ne_znaet_jpa_dazhe_ai_fa579ee8fe.webp\" preload=\"none\">\u003C\u002Fvideo>\n\nКак видно, в результате было создано три сущности, в качестве id используется sequence per table, что является best practice в общем случае. Для связи Owner -> Pet в качестве коллекции используется Set, что для корректной работы требует корректного определения equals & hashcode на стороне many, то есть для Pet. Обратите внимание, что equals & hashcode определены с учетом возможного HibernateProxy. Также для связи Owner -> Pet определены дополнительные параметры `cascade = CascadeType.ALL, orphanRemoval = true`, что согласуется с исходным требованием о том, что домашнее животное является частью агрегата владелец. Для Pet -> Visit связь не определена, что тоже согласуется с постановкой.\n\n> В результате, несмотря на то, что мы использовали модель Haiku, сгенерированный код соответствует тому, который мы бы получили от Opus 4.8. На самом деле даже лучше, поскольку Opus до сих пор не умеет корректно генерировать equals & hashcode без использования [Spring Data JPA Skill](https:\u002F\u002Fgithub.com\u002FAmplicode\u002Fspring-skills\u002Fblob\u002Fmain\u002Fskills\u002Fspring-data-jpa\u002FSKILL.md).\n\n\u003Ch3 id=\"ispolzovanie-v-plane\">Использование в плане\u003C\u002Fh3>\n\nЕсли вы разрабатываете, предварительно запуская режим планирования, то вы замечали, что агент не особо активирует Skill-ы в процессе выполнения плана. Мотивировать агента использовать Skill можно, указав его в плане явным образом. Для этого достаточно в начале шага плана указать на использование конкретного Skill.\n\n```powershell\n> **JPA skill required (amplicode-spring-skills:spring-data-jpa).** Before writing any entity code: activate the skill and verify the implementation follows its rules. For any deviation — ask the developer before continuing.\n```\n\nВот как это выглядит в конечном плане:\n\n![]({{strapiUrl}}\u002Fuploads\u002Fc5e705c7e8894ed2adbe6f343c9ac797_b4da23d40c.webp)\n\nЕсли теперь попросить агента приступить к реализации плана, то он активирует его с высокой вероятностью.\n\n\u003Ch3 id=\"ispolzovanie-v-drugih-skill\">Использование в других Skill\u003C\u002Fh3>\n\nПостепенно, развивая собственный harness и добавляя новые скиллы, мы видим, как в наших коллекциях появляются скиллы, которые уже не просто отдельные действия, а являются полноценными сценариями, включающими создание сущностей, генерацию кода сервисов, описание новых endpoint и т.д. В такого рода Skill полезно использовать другие Skill, которые как раз помогают качественно выполнять отдельные специализированные шаги.\n\nВ качестве примера напишем Skill, который при добавлении сущности сразу создаст Rest Endpoint и Service для получения элементов сущности по Id.\n\n```markdown\n---\nname: entity-service-rest\ndescription: >\n  Scaffolds a full vertical slice for one domain entity in three steps: the JPA entity, a Spring\n  service for it, and a REST controller with a find-by-id endpoint. The controller calls the\n  repository ONLY through the service (controller → service → repository), never directly. Use\n  this skill when the user asks to create an entity together with its service and controller, to\n  build a feature\u002Fvertical slice around an entity, or to add an entity plus a service plus a REST\n  endpoint that looks up by id — even when the skill is not named explicitly.\n---\n\n## Step 1 — Entity\n\nDetermine the entity name (and any fields) from the user's prompt; ask only if it is missing.\n\n**Activate the `spring-data-jpa` skill** and use it to create the JPA entity. Let it own the\nproject's entity conventions. If the entity already exists, this step just confirms it.\n\nAlso make sure a Spring Data repository exists for the entity (e.g. `{Entity}Repository extends\nJpaRepository\u003C{Entity}, {IdType}>`). If none exists, create one following the same skill's\nrepository guidance.\n\n## Step 2 — Service\n\nThe service returns a DTO, so first make sure a DTO and an entity↔DTO mapper exist:\n\n**Activate the `dto-creator` skill**, telling it the DTO is **for a service \u002F REST controller**.\nThat skill creates the DTO and automatically delegates to `mapper-creator` for the mapper. Reuse\nan existing DTO\u002Fmapper if the project already has one.\n\nThe mapper **must be a MapStruct mapper** — pass this to `dto-creator` \u002F `mapper-creator` so the\nmapper type is MapStruct (not a custom converter). If `mapper-creator` needs MapStruct\ndependencies added to the build file, let it add them.\n\nThen create a `@Service` that injects the **repository** and the **mapper**, with a `findById(id)`\nmethod that calls `repository.findById(id)` and returns the entity mapped to the DTO.\n\n## Step 3 — REST controller\n\nCreate the controller:\n\n- annotate it `@RestController` with a request mapping like `\u002Frest\u002F{entities}`\n- inject **the service only** — never the repository\n- add `GET \u002F{id}` that calls `service.findById(id)`, returns the DTO with 200, or 404 when absent\n\n---\n\n## Done\n\nBefore finishing, double-check the core invariant: the controller goes through the service, and\nonly the service touches the repository.\n```\n\nПроверим его работу на практике. Решим ранее озвученную задачу с ветеринарами, домашними животными и визитами. Вызовем агента с той же формулировкой, но теперь будем использовать вновь созданный нами Skill. В этот раз будем использовать модель Sonnet 4.6.\n\n\u003Cvideo src=\"https:\u002F\u002Fstorage.yandexcloud.net\u002Famplicode-site\u002Farticles\u002Fsow-spring-data-jpa\u002Fcustom_skill.mp4\" controls muted loop playsinline width=\"100%\" poster=\"{{strapiUrl}}\u002Fuploads\u002Fcover_skill_of_the_week_spring_data_jpa_nikto_ne_znaet_jpa_dazhe_ai_fa579ee8fe.webp\" preload=\"none\">\u003C\u002Fvideo>\n\nКак видно на видео, в результате работы Agent с нашим новым Skill мы получили все ожидаемые компоненты: Entity, Service, RestController, Repository и связывающий их воедино код. Обратите внимание, что Agent не создал rest endpoint для pet — видимо, таким образом он трактовал понятие агрегата. Поправить это оставим читателю в качестве домашнего задания.\n\nЕсли тебе интересно, как настроить свой Agent для разработки на Spring, а также ты не хочешь пропустить новые выпуски Skill of the Week и другие полезные материалы по разработке на Spring с AI Agent — подписывайся на наш канал в [ТГК](https:\u002F\u002Ft.me\u002Famplicode).\n\nА больше полезных Skill для разработки на Spring\u002FSpring Boot можно найти в нашем [репозитории](https:\u002F\u002Fgithub.com\u002FAmplicode\u002Fspring-skills) (звездочки приветствуются).\n\n> Предыдущий выпуск [Skill of the Week: Spring Explore — первичный сбор контекста](\u002Fblog\u002Fskill-of-the-week-spring-explore-pervichnyj-sbor-konteksta\u002F)\n\n![]({{strapiUrl}}\u002Fuploads\u002F62335bea5b72de7c5c1311bc36bbfb8a_1533881fa7.webp)\n\n---\n\n_Впервые опубликовано на [Хабре](https:\u002F\u002Fhabr.com\u002Fru\u002Fcompanies\u002Fhaulmont\u002Farticles\u002F1045590\u002F)._\n",[18],{"title":19,"links":20},"Содержание",[21,24,27,30,33,36],{"label":22,"href":23},"Качество модели в AI-агенте","#kachestvo-modeli-v-ai-agente",{"label":25,"href":26},"Spring Data JPA","#spring-data-jpa",{"label":28,"href":29},"Как установить","#kak-ustanovit",{"label":31,"href":32},"Явная\u002Fручная активация","#yavnaya-ruchnaya-aktivacziya",{"label":34,"href":35},"Использование в плане","#ispolzovanie-v-plane",{"label":37,"href":38},"Использование в других Skill","#ispolzovanie-v-drugih-skill","2026-11-12T11:23:03.266Z","2026-11-13T11:49:12.721Z","2026-11-13T11:49:12.786Z",{"id":43,"documentId":44,"firstname":45,"lastname":46,"createdAt":47,"updatedAt":47,"publishedAt":48,"slug":49,"photo":50},32,"o6vt7fwz9hd363ulcgbilr84","Илья","Кучмин","2026-11-12T11:20:31.602Z","2026-11-12T11:20:50.815Z","ilya-kuchmin",null,{"id":52,"documentId":53,"name":54,"alternativeText":50,"caption":50,"width":55,"height":56,"formats":57,"hash":92,"ext":61,"mime":62,"size":93,"url":94,"previewUrl":50,"provider":95,"provider_metadata":50,"createdAt":96,"updatedAt":96,"publishedAt":96,"focalPoint":50},1250,"qo9a15nez6fp3ohbj0ntpwzr","cover-skill-of-the-week-spring-data-jpa-nikto-ne-znaet-jpa-dazhe-ai.webp",1280,720,{"thumbnail":58,"small":68,"medium":76,"large":84},{"name":59,"hash":60,"ext":61,"mime":62,"path":50,"width":63,"height":64,"size":65,"sizeInBytes":66,"url":67},"thumbnail_cover-skill-of-the-week-spring-data-jpa-nikto-ne-znaet-jpa-dazhe-ai.webp","thumbnail_cover_skill_of_the_week_spring_data_jpa_nikto_ne_znaet_jpa_dazhe_ai_fa579ee8fe",".webp","image\u002Fwebp",245,138,12.46,12460,"\u002Fuploads\u002Fthumbnail_cover_skill_of_the_week_spring_data_jpa_nikto_ne_znaet_jpa_dazhe_ai_fa579ee8fe.webp",{"name":69,"hash":70,"ext":61,"mime":62,"path":50,"width":71,"height":72,"size":73,"sizeInBytes":74,"url":75},"small_cover-skill-of-the-week-spring-data-jpa-nikto-ne-znaet-jpa-dazhe-ai.webp","small_cover_skill_of_the_week_spring_data_jpa_nikto_ne_znaet_jpa_dazhe_ai_fa579ee8fe",500,281,42.04,42038,"\u002Fuploads\u002Fsmall_cover_skill_of_the_week_spring_data_jpa_nikto_ne_znaet_jpa_dazhe_ai_fa579ee8fe.webp",{"name":77,"hash":78,"ext":61,"mime":62,"path":50,"width":79,"height":80,"size":81,"sizeInBytes":82,"url":83},"medium_cover-skill-of-the-week-spring-data-jpa-nikto-ne-znaet-jpa-dazhe-ai.webp","medium_cover_skill_of_the_week_spring_data_jpa_nikto_ne_znaet_jpa_dazhe_ai_fa579ee8fe",750,422,82.68,82676,"\u002Fuploads\u002Fmedium_cover_skill_of_the_week_spring_data_jpa_nikto_ne_znaet_jpa_dazhe_ai_fa579ee8fe.webp",{"name":85,"hash":86,"ext":61,"mime":62,"path":50,"width":87,"height":88,"size":89,"sizeInBytes":90,"url":91},"large_cover-skill-of-the-week-spring-data-jpa-nikto-ne-znaet-jpa-dazhe-ai.webp","large_cover_skill_of_the_week_spring_data_jpa_nikto_ne_znaet_jpa_dazhe_ai_fa579ee8fe",1000,562,131.39,131394,"\u002Fuploads\u002Flarge_cover_skill_of_the_week_spring_data_jpa_nikto_ne_znaet_jpa_dazhe_ai_fa579ee8fe.webp","cover_skill_of_the_week_spring_data_jpa_nikto_ne_znaet_jpa_dazhe_ai_fa579ee8fe",222.82,"\u002Fuploads\u002Fcover_skill_of_the_week_spring_data_jpa_nikto_ne_znaet_jpa_dazhe_ai_fa579ee8fe.webp","local","2026-11-13T11:44:46.149Z",[98],{"id":99,"documentId":100,"title":101,"published":102,"weight":103,"slug":104,"createdAt":105,"updatedAt":106,"publishedAt":107,"color":50},4,"ap54riuwcv7sj63auhmb4i6d","Гайды",true,3,"guides","2026-11-12T11:20:31.298Z","2026-11-12T11:22:44.141Z","2026-11-12T11:22:44.122Z",{"pagination":109},{"page":110,"pageSize":111,"pageCount":110,"total":110},1,25,{"data":113},[],{"data":115,"meta":134},[116,122,128],{"published_date":117,"id":118,"documentId":119,"title":120,"slug":121},"2026-09-28",327,"lruxexelyn19uak89r6dney5","Что такое OpenSpec? Полный гайд по Spec-Driven Development","chto-takoe-openspec-polnyj-gajd-po-spec-driven-development",{"published_date":123,"id":124,"documentId":125,"title":126,"slug":127},"2026-09-10",326,"ymtfa6pslevvkrwnohdfbi1u","Как не потерять интеграцию с Docker в IDE после блокировки JetBrains","kak-ne-poteryat-integracziyu-s-docker-v-ide-posle-blokirovki-jetbrains",{"published_date":129,"id":130,"documentId":131,"title":132,"slug":133},"2026-09-01",400,"dskd9jsck2vjm1d0ztoz91uo","JavaScript и TypeScript в OpenIDE: Node.js, React, Angular, Git и работа с API","javascript-i-typescript-v-openide",{"pagination":135},{"page":110,"pageSize":103,"pageCount":136,"total":137},6,16,1794584599651]