Как справиться с AI-слопом в документации, PR и issue

Как только начал писать с AI-агентами, уперся в одно: документацию они делают плохо. Языки в тексте то и дело смешиваются, стиль какой-то «пластиковый», а в описаниях PR — та же шаблонная вежливость вместо ответа на «что и зачем поменялось». До агентов была своя боль — заставить людей писать дельное описание PR. Агенты её не решили, они добавили свою.

Попался скилл sepia. Зацепило, что это не «набор промпт-трюков по ощущениям», а собран на исследованиях, где сравнивали людей против пяти фронтир-моделей на более 60 тысяч текстов. В итоге для каждого типа текста содержатся свои правила.

Внутри 30+ проверок и четыре режима: написать с нуля, только продиагностировать, минимально отрефакторить или переписать целиком. Для уже существующего корпуса это удобно — сначала можно попросить просто выписать проблемы и править только то, что реально сломано.

Ставится в любой агент, который понимает Agent Skills: npx skills add Nanako0129/sepia -g На практике скилл показал себя достаточно интересно. Описания PR получаются достаточно хорошие, но всё ещё требуют шлифовки напильником. Попробовать стоит, если вы тоже вечно дописываете AI-доки руками или же лень писать самому.

Кто-то пробовал этот или какие-нибудь другие скилы для подобной задачи?