--- name: prompt-enhancer description: "Улучшает и структурирует короткие неструктурированные промпты и постановки задач, превращая их в подробные императивные ТЗ с пронумерованными шагами анализа, явными граничными случаями и описанием формата ожидаемого вывода. Сохраняет все термины и условия исходника, не добавляет новых требований. Используй когда пользователь просит: улучшить промпт, проработать постановку, расширить описание задачи, структурировать ТЗ, оформить заметку в подробную инструкцию, сделать промпт точнее или подробнее, подготовить ТЗ из черновика, причесать задание, преобразовать короткую заметку в понятное ТЗ. Принимает текст в аргументе команды или путь к .md файлу." --- # /prompt-enhancer - улучшение промптов и постановок задач Превращает короткую заметку или неструктурированное задание в подробное императивное ТЗ. Подходит для разработчиков 1С, которым нужно оформить быстро сформулированную мысль в понятную постановку задачи. ## Когда использовать Вызывай скил по фразам пользователя: - "улучши промпт", "сделай промпт лучше / точнее / подробнее" - "проработай постановку", "оформи задачу", "причеши задание" - "структурируй ТЗ", "подготовь ТЗ из заметки" - "расширь описание задачи", "преобразуй это в подробную инструкцию" Скил работает с любой предметной областью, но специально учитывает особенности задач 1С (термины, имена реквизитов, объектов, форм). ## Режимы работы | Режим | Триггер | Что делает | |-------|---------|------------| | Inline | аргумент - произвольный текст | Улучшенный промпт выводится в чат | | File | аргумент - путь к существующему файлу | Результат сохраняется рядом с суффиксом `-enhanced.md` | | Interactive | аргумент пустой | Спросить у пользователя текст или путь | ## Алгоритм определения режима Режим выбирается детерминированно, без эвристики по тексту аргумента: 1. Если аргумент пустой - режим Interactive. Попросить у пользователя текст промпта или путь к файлу обычным сообщением. 2. Иначе попытаться прочитать аргумент через инструмент Read. - Если Read вернул содержимое файла - режим File. - Если Read вернул ошибку вида "файл не существует / не найден" - это штатный путь, не сбой. Переключиться в Inline: аргумент целиком использовать как текст промпта. 3. Не определять режим по наличию ".md" в тексте. Формулировка "оформи ТЗ про .md генерацию" не должна интерпретироваться как путь. Проверку существования файла делает Read, не парсинг строки. ## Принципы преобразования Ядро скила. При каждой генерации возвращайся к этому списку: 1. **Сохранение исходника как источника истины.** Все термины, имена реквизитов, вкладок, объектов, форм, подсистем, числа, перечни переносить буквально. Не заменять "Айс_КодИсточника77" на "служебный реквизит". 2. **Императив вместо описания.** "нужно вывести" превращать в "Выведи", "надо бы проанализировать" в "Проанализируй". Результат это план действий, не рассказ. 3. **Явное выделение граничных случаев.** Условия-исключения выносить отдельным предложением в форме "если ..., то ...", не прятать в скобках. Граничный случай должен бросаться в глаза. 4. **Фиксация ожидаемого вывода.** Добавить раздел "Для каждого элемента укажи" с нумерованным списком полей. Формат результата (таблица, структурированный список, JSON) называть явно. 5. **Без новых требований.** Не добавлять требований, которых не было в исходнике: тесты, документация, роли, откаты, логирование. Улучшение это форма, не содержание. 6. **Нумерация шагов анализа.** Разбить пользовательские пожелания на дискретные проверяемые операции 1..N. Каждый шаг одна операция. 7. **Сохранение намерения, а не дословного текста.** Если в исходнике "подготовь список", а далее перечислены аналитические задачи, сначала идет анализ, потом составление списка. Восстановить правильный порядок. 8. **Нейтральный деловой регистр.** Убрать разговорные и эмоциональные элементы ("надо бы", "как-то так", "хотелось бы"), оставить нейтральную формулировку. 9. **Короткая суть в первой строке.** Перед пошаговым планом одно предложение, передающее цель задачи. 10. **Форматирование по правилам репо.** Без длинных и коротких тире (только обычный дефис), без буквы е с точками, без оценок времени и ROI. ## Шаблон улучшенного промпта Обязательные блоки результата: 1. **Цель** - одно предложение, что нужно сделать. 2. **Шаги анализа** - нумерованный список императивов (Проанализируй, Изучи, Определи, Выведи). 3. **Граничные случаи** - явные условия "если ..., то ..." с конкретными именами и значениями из исходника. 4. **Формат вывода** - название формата (таблица / структурированный список / JSON) и перечень полей, которые должны быть в результате. 5. **Дополнительные уточнения** (опционально) - детали, если в исходнике были указаны сроки, ответственные, зависимости. ## Пример "до/после" **Исходный промпт (короткий, неструктурированный):** > Задача - все нетиповые реквизиты в типовых объектах вывести на вкладку "Доп. реквизиты Айс". Вкладку разместить самой последней. Если добавлен только один реквизит, Айс_КодИсточника77, то ничего не делаем. Подготовь список объектов, проанализируй формы элементов, определи, куда и как добавить вкладку. **Улучшенный промпт (структурированный, подробный):** > Проанализируй все типовые объекты конфигурации и подготовь список тех, в которых присутствуют нетиповые реквизиты. Изучи формы элементов этих объектов. Добавь в каждую форму новую вкладку "Доп. реквизиты Айс" последней по порядку. Перенеси на вкладку все нетиповые реквизиты, кроме случая, когда единственный нетиповой реквизит это Айс_КодИсточника77 (тогда изменения не вносятся). Для каждого объекта укажи: > > 1. Наименование объекта. > 2. Список нетиповых реквизитов. > 3. Название используемой формы элемента и текущую структуру вкладок. > 4. Рекомендуемые изменения по размещению вкладки и переносу реквизитов с учетом логики интерфейса. > > Сформируй вывод в виде удобной таблицы или структурированного списка для дальнейшего внедрения. Дополнительные кейсы смотри в `examples/`. ## DO / DON'T **DO:** - Сохранять имена объектов, реквизитов, вкладок, констант, перечисления буквально. - Превращать просьбы в императивы, добавлять структуру и нумерацию. - Выносить исключения и граничные случаи отдельным предложением. - Указывать формат ожидаемого результата явно. - Добавлять короткую суть первой строкой перед пошаговым планом. **DON'T:** - Придумывать новые требования, которых не было в исходнике (роли, тесты, откат, печать, логирование). - Заменять конкретные термины обобщениями. - Добавлять технические решения ("используй БСП", "сделай через HTTP сервис"), если они не упомянуты в исходнике. - Использовать длинное тире, короткое тире, двойной дефис, букву е с точками. - Оценивать трудозатраты в часах, днях, неделях, стоимость в деньгах. ## Сохранение файла (file-режим) - Имя результата: `<имя исходного файла без расширения>-enhanced.md`. Если оригинал `postanovka.md`, результат `postanovka-enhanced.md` в той же папке. - Кодировка: utf-8. - Оригинал не перезаписывать, не удалять, не переименовывать. - Если файл-результат уже существует, перезаписать без спроса (это повторный запуск скила). ## Обработка кодировки Исходные файлы читаются как utf-8. Если Read возвращает явный mojibake (нечитаемая кириллица вида "ж©", "­", квадраты), сообщи пользователю, что файл похоже в cp1251 или другой кодировке, и попроси сохранить в utf-8. Автоопределение кодировки в скиле не реализовано намеренно - это осознанное упрощение первой версии. ## Фразы-триггеры (для надежности срабатывания) Скил должен распознавать эти формулировки пользователя как триггеры, даже если команда `/prompt-enhancer` не указана явно: - улучши / улучшить промпт - расширь / проработай / оформи постановку (задачи, ТЗ) - структурируй ТЗ / задание - сделай промпт подробнее / точнее / лучше - подготовь подробное ТЗ из заметки / черновика - причеши задание / постановку - преобразуй в понятное ТЗ / в подробную инструкцию ## Ограничения - Скил переписывает форму, не содержание. Если исходный промпт логически противоречив или неполон, результат тоже будет неполным (см. принцип 5 - без новых требований). - Для очень длинных исходных текстов (2000+ слов) обработка может упустить детали. В таком случае разбивай текст на логические блоки и обрабатывай по частям. - Скил не предполагает знаний предметной области за пределами исходника. Если нужны уточнения про 1С-специфику, дополнительно используй `/1c-config-router`, `/composing-1c-queries` и смежные скилы репозитория.