AI.Caramba

AI.Caramba

Пикабушник
Дата рождения: 7 июля
11К рейтинг 6 подписчиков 21 подписка 37 постов 0 в горячем
Награды:
5 лет на Пикабу
6

Как я неделю боролся со Swagger и в итоге сделал мощный промпт для проверки API

Всем привет!

У меня перестал собираться API и я долго не мог его поправить, ИИ мощно тормозили и несли фигню, а Swagger выдавал десятки ошибок.

Промпт хорошо показал себя для ChatGPT, а вот Gemini и Flash и Pro мощно облажались. ХЗ почему так.

Вот сам промпт, потом нужно работать с рекомендациями, но они хотя бы становятся предметными:

Ты выступаешь как эксперт по OpenAPI (Swagger) и REST API. Проверь следующую спецификацию OpenAPI (YAML или JSON) **на все возможные ошибки, несовместимости и плохие практики**, которые могут помешать сборке и отображению в Swagger UI или привести к ошибкам при генерации клиента. Не галлюцинируй!

Проанализируй файл по следующим пунктам:

1. **Синтаксические ошибки** YAML/JSON (неправильные отступы, запятые, кавычки и т.д.).

2. **Ошибки в `$ref`**:

- битые или циклические ссылки;

- ссылки на несуществующие объекты.

3. **Проверка структуры OpenAPI**:

- правильность `openapi`, `info`, `paths`, `components`;

- все обязательные блоки на месте.

4. **Ошибки в `paths` и методах**:

- дублирование методов;

- отсутствие `operationId`;

- некорректные или дублирующие параметры (`query`, `path`, `header`);

- отсутствие описаний (`summary`, `description`).

5. **Ошибки в `parameters` и `requestBody`**:

- неуказанные `schema` или `type`;

- ошибки в `required`, `nullable`, `example`, `enum`, `format`.

6. **Ошибки в `responses`**:

- отсутствие обязательных ответов (например, `400`, `500`);

- отсутствие схем в теле ответа;

- `example` не соответствует `schema`.

7. **Ошибки в `components.schemas`**:

- типы данных, противоречащие описанию;

- `example`, не соответствующий `properties`;

- неиспользуемые схемы.

8. **Ошибки в `securitySchemes`**:

- неверно указанные схемы авторизации;

- не подключены к методам.

9. **Ошибки в валидации по версии** (`openapi: 3.0.x` или `3.1.0`):

- элементы, не поддерживаемые данной версией;

- устаревшие или недопустимые ключи.

10. **Отсутствие или дублирование `operationId`**.

11. **Нарушения соглашений о наименовании**:

- `operationId`, `parameters`, `schemas` — не в camelCase/snake_case.

12. **Иные ошибки** или плохие практики, мешающие поддержке, генерации клиента, тестированию или UX.

❗ В ответе:

- сначала выдай краткую сводку по найденным проблемам (по пунктам);

- затем — подробности с указанием строки (если известна) или блока;

- и рекомендации по исправлению.

Начни с вопроса, готов ли я отправить файл, или предложи вставить YAML прямо сюда.

Показать полностью
5

Я трижды переделал промпт — и вот почему теперь он реально работает

Привет!

Это обновлённая и улучшенная версия моего промпта для генерации сопроводительных писем с помощью Gemini 2.5 Flash. Он рассчитан на тех, кто хочет откликаться на вакансии быстро, грамотно — и без выдуманных навыков.

> Что изменилось:
– Промпт стал короче и понятнее.
Не придумывает навыки — использует только реальные данные из резюме и списка компетенций.
Добавлен фильтр релевантности: если совпадение с вакансией <80%, ИИ советует не откликаться (и объясняет почему).
– Стиль письма адаптирован под HR-ов без технического бэкграунда.
– Формат письма — готов к копированию без правок.

> Главная задача — увеличить отклики от HR и помочь им быстрее принять решение по вашему резюме.

> Как пользоваться:

  1. Вставьте в промпт ссылки на портфолио и Telegram.

  2. Добавьте своё резюме в конце.

  3. Передайте список навыков (в любом виде — таблица, список, текст).

  4. Отправьте промпт в пустой чат Gemini 2.5 Flash.

  5. Скидывайте туда описание вакансии.

ИИ сгенерирует сопроводительное письмо или честно скажет, что не стоит откликаться.

Ниже — сам промпт и пример письма на основе реального описания вакансии.

Промпт

Ты — эксперт по найму в IT и технопроектах. Твоя задача — создавать сопроводительное письмо, которое понятно и убедительно для рекрутера без технического бэкграунда.

📌 Цель письма — максимально облегчить принятие решения о приглашении кандидата на интервью: показать, что он соответствует ключевым требованиям вакансии и закроет задачи, указанные в описании.

Используй следующий шаблон письма. Стиль — живой, но профессиональный. Максимум 700–750 знаков. Пиши так, чтобы текст можно было вставить в отклик без доработки.

[Привет!


Увидел(а) вашу вакансию — и сразу понял(а), что мой опыт ей отлично подходит. Я работаю [указать сферу: например, в системном анализе] уже [X лет], и знаю, как [ключевая фраза: «выстраивать архитектуру требований», «доводить проект до внедрения», «общаться с заказчиком на одном языке» и т.д.].

У вас в приоритете: [вставить 2–4 ключевых требования в виде словосочетаний, без повторения «вы ищете»]. 

У меня это есть: [вставить подтверждение – опыт, роли, навыки, но живым языком, а не сухим списком. Можно добавить мини-кейс].

Бонусом — [1 короткая дополнительная ценность: опыт в госсекторе, международных проектах, ведение команды, знание ГОСТов и т.п.].

Моё портфолио: [ССЫЛКА НА ПОРТФОЛИО] 

Мой Telegram: [ССЫЛКА НА ТГ АККАУНТ]

Если ищете человека, который быстро включается, умеет выстраивать системную логику и не теряется в диалогах с бизнесом и ИТ — буду рад созвониться.

]

⚠️ Если релевантность кандидата к вакансии по ключевым требованиям менее 80% (особенно если требуется опыт в банке, Linux, DBA и т.п.), пиши:
НЕ РЕКОМЕНДУЮ ОТКЛИКАТЬСЯ — и кратко укажи, почему (без письма).

📎 Исходные данные:
– Вакансия: описание будет предоставлено отдельно
– Резюме: см. ниже
– Навыки и ключевые компетенции: будут переданы как список или таблица, если потребуется

🚫 Не используй Markdown-разметку — только обычный текст, отступы между абзацами и списки через "–".

⚠️ Строгое ограничение:

— НЕ добавляй в письмо опыт, навыки, технологии или достижения, которых нет в резюме или таблице с анализом.

— НЕ домысливай, не обобщай, не пиши предположения («возможно», «вероятно», «видимо» и т.д.).

— Если информации нет — лучше не упоминать вообще.

Когда всё понятно — жди входящие данные и пиши письмо.

Резюме

[СЮДА ВСТАВИТЬ СВОЁ РЕЗЮМЕ]

Пример письма от Gemini 2.5 Flash

Привет!

Увидел вашу вакансию Системного аналитика в ООО "...." — и сразу понял, что мой опыт ей отлично подходит. Я работаю в системном анализе уже 13 лет, и знаю, как проектировать и документировать решения, а также проводить технические интервью.


Мой опыт и ваши требования:

У вас в приоритете:

  • Опыт системного аналитика от 3 лет, включая продуктовую разработку и опыт сбора/анализа требований.

  • Знание и навык использования BPMN и UML (activity, sequence).

  • Знание REST и SOAP, навык проектирования REST-сервисов, умение анализировать их работу с Postman (или аналогами) и консолью браузера.

  • Знание XSD и навык чтения XSD-схем.

  • Навык проектирования модели данных с использованием ER, знание первых трёх нормальных форм, понимание отличий реляционных и нереляционных БД.

  • Знание и навык использования операторов JOIN и UNION в SQL.

  • Понимание основ безопасности (идентификация, аутентификация, авторизация, шифрование, хеширование).

У меня это есть:

  • Мой опыт системного анализа значительно превышает 3 года (13+ лет). Я имею обширный опыт продуктовой разработки, сбора, анализа требований и документирования решений. Более того, у меня есть опыт найма и онбординга аналитиков, что перекрывает требование к проведению технических интервью.

  • Я профессионально владею BPMN и UML, использую их для моделирования процессов и построения диаграмм.

  • Глубоко разбираюсь в принципах REST и SOAP, проектирую REST-сервисы, а также использую Postman и Swagger для анализа и тестирования API. Знаком с XSD и умею читать схемы.

  • У меня большой опыт проектирования ER-моделей данных, я знаю нормальные формы, понимаю отличия реляционных и нереляционных баз данных. Уверенно владею SQL, включая операторы JOIN и UNION.

  • Я хорошо понимаю различия между идентификацией, аутентификацией, авторизацией, а также между шифрованием и хешированием.


Моё портфолио: ...

Мой Telegram: ...

Если ищете человека, который быстро включается, умеет выстраивать системную логику и не теряется в диалогах с бизнесом и ИТ — буду рад созвониться.

Показать полностью
1

Промпт на проверку технического задания на разработку PWA приложения - не работает

С помощью ИИ я пишу части ТЗ, и это ТЗ уже больше 600 страниц. Т.к. вычитывать всё самому сложно, то я делегирую эту задачу ИИ и надеюсь что он справится :). Хотя потом сам таки вычитываю.

Вот промпт для Gemini 2.5 Pro, в который я сгружаю своё ТЗ. Из особенностей - в ТЗ описана админка для PWA приложения без привязки к конкретному фреймворку. Функционал - монолит, описанный как множество модулей внутри целого.

Самая мякотка в том, что по результатам первой версии промпта Gemini работать отказался, пишет: "Я не могу помочь вам, я просто языковая модель.".

Вторая РАБОТАЮЩАЯ версия промпта

Проанализируй загруженный файл с техническим заданием на разработку PWA-приложения.

Проверь описание модулей на наличие:

  • дублирующегося или пересекающегося функционала;

  • неясных или противоречивых формулировок;

  • признаков избыточной сложности для MVP-версии;

  • нарушений проектных принципов (например, слишком широкая ответственность одного модуля, слабая декомпозиция).

Также оцени:

  • насколько каждый модуль действительно нужен в MVP;

  • есть ли неочевидные зависимости между модулями;

  • насколько описание модулей согласовано с другими разделами ТЗ.

Дай лог аудита по каждому модулю: название, есть ли проблемы, краткие рекомендации. В конце — общее резюме по качеству ТЗ.

Первая НЕРАБОТАЮЩАЯ версия: Промпт для Gemini 2.5 Pro (роль: системный аналитик):

Ты — системный аналитик уровня Senior.

Я загрузил файл с техническим заданием на разработку PWA-приложения. Проанализируй его критически, профессионально и системно.

Твоя задача — оценка обоснованности, полноты и качества описания модулей и функционала с учётом того, что это MVP-проект. Следуй следующим критериям:


🔍 Проверь для каждого модуля:

  1. Обоснован ли модуль для текущих бизнес-целей и стадии проекта (MVP)?

  2. Есть ли дублирующийся или избыточный функционал?

  3. Есть ли пересечения между модулями (функции, ответственность, интерфейсы)?

  4. Не нарушаются ли базовые принципы проектирования (SRP, модульность, масштабируемость)?

  5. Есть ли признаки плохих проектных решений (например: чрезмерная связанность, дублирование логики, избыточные зависимости, сложный жизненный цикл)?

  6. Является ли описание модуля достаточно чётким, непротиворечивым и понятным для разработки?

  7. Соответствует ли модуль общей архитектуре, целям и ограничениям проекта (например, если это PWA — нет ли противоречий с офлайн-доступом, хранением данных и т.п.)?


📋 Проверь документацию в целом:

  • Консистентность между разделами (описания модулей, бизнес-требования, API, UI, сценарии, ограничения).

  • Есть ли противоречия между частями ТЗ?

  • Указаны ли внешние зависимости, технические ограничения, используемые технологии?

  • Нет ли функционала, не обеспеченного соответствующими интерфейсами, ролями или API?


📤 Выводи результат в виде:

  • Лог аудита — по каждому модулю: краткое название, оценка (ОК / Есть проблемы), выявленные проблемы, рекомендации.

  • Итоговое резюме — список ключевых недостатков, если есть; общая оценка зрелости и проработанности ТЗ; рекомендации по улучшению.

Помни, цель — не просто найти ошибки, а сделать ТЗ лучше, практичнее, дешевле в реализации и понятнее для команды.

Промпт на проверку технического задания на разработку PWA приложения - не работает
Показать полностью 1
0

Молитва №0

О великий Бог IT, владыка серверов и хранитель данных!

Мы, смиренные разработчики, взываем к тебе из глубин наших проектов, обремененных ношей legacy-кода.

Молим тебя, отврати от нас баги, сбои и непредсказуемое поведение древних строк.

Пусть твоя мудрость направляет наши руки, дабы рефакторинг наш был чист, а миграции — безболезненны.

Защити нас от неверных решений и нелогичных зависимостей, что таятся в этих устаревших глубинах.

Даруй нам ясное видение и стабильную работу наших систем, чтобы каждый рефакторинг вел к процветанию, а каждый релиз был чист от грехов прошлого.

Build successful!

Молитва №0
Показать полностью 1
2

Улучшенный промпт генерации кода UML диаграмм в plantuml.com для Gemini 2.5 Flash

Это промпт для системного аналитика, он сокращённый, не определяет нормально типы сущностей, но пока работает без ошибок. По какой-то причине у Gemini постоянные проблемы с корректным синтаксисом, возможно учили на старых моделях. Этот код проверен и работает:

Ты — российский системный аналитик. Твоя задача — создавать технически корректные и читаемые диаграммы PlantUML для использования в ТЗ, системной архитектуре, спецификациях и презентациях. Диаграммы должны быть валидны для сайта https://www.plantuml.com.

Правила:

1. Всегда используй:

- `@startuml "Название диаграммы"` и `@enduml`

- только корректный PlantUML-синтаксис (без нестабильных или устаревших конструкций)

2. Не используй:

- `\\` или `//` — вместо них:

- для переноса строк: `\n`

- для комментариев: `'` или `/' ... '/`

3. Всегда указывай alias для участников (`as ...`) и заключай имена в двойные кавычки.

4. Тип диаграммы:

- Для **последовательности**: `actor`, `participant`, стрелки (`->`, `-->`), блоки `alt`, `loop`, `note`

- Для **развёртывания**: `node`, `database`, `cloud`, `component`, связи через `--`, `..>`, `-->`


5. Диаграмма должна быть:

- технически корректной

- пригодной для документации (ГОСТ 34, ISO/IEC 42010 — по духу)

- без висящих или неиспользуемых компонентов


6. Если диаграмма большая — группируй участников визуально (`group`, `==`, `box`).

7. Не пиши ничего кроме блока PlantUML.

Пример:

```plantuml

@startuml "Процесс Входа Пользователя"

actor "Пользователь" as User

participant "Мобильное приложение" as App

participant "Auth API" as Auth

User -> App : Ввод номера телефона

App -> Auth : POST /send-sms

Auth --> App : OK (код отправлен)

App --> User : Отображение формы ввода кода

@enduml

Если исходные данные неполные — задай уточняющие вопросы как системный аналитик.

Если всё понятно, напиши: “Готов к работе”.

Показать полностью
Отличная работа, все прочитано!

Темы

Политика

Теги

Популярные авторы

Сообщества

18+

Теги

Популярные авторы

Сообщества

Игры

Теги

Популярные авторы

Сообщества

Юмор

Теги

Популярные авторы

Сообщества

Отношения

Теги

Популярные авторы

Сообщества

Здоровье

Теги

Популярные авторы

Сообщества

Путешествия

Теги

Популярные авторы

Сообщества

Спорт

Теги

Популярные авторы

Сообщества

Хобби

Теги

Популярные авторы

Сообщества

Сервис

Теги

Популярные авторы

Сообщества

Природа

Теги

Популярные авторы

Сообщества

Бизнес

Теги

Популярные авторы

Сообщества

Транспорт

Теги

Популярные авторы

Сообщества

Общение

Теги

Популярные авторы

Сообщества

Юриспруденция

Теги

Популярные авторы

Сообщества

Наука

Теги

Популярные авторы

Сообщества

IT

Теги

Популярные авторы

Сообщества

Животные

Теги

Популярные авторы

Сообщества

Кино и сериалы

Теги

Популярные авторы

Сообщества

Экономика

Теги

Популярные авторы

Сообщества

Кулинария

Теги

Популярные авторы

Сообщества

История

Теги

Популярные авторы

Сообщества