/prompt-enhancer - улучшение промптов и постановок задач
Превращает короткую заметку или неструктурированное задание в подробное императивное ТЗ. Подходит для разработчиков 1С, которым нужно оформить быстро сформулированную мысль в понятную постановку задачи.
Когда использовать
Вызывай скил по фразам пользователя:
- "улучши промпт", "сделай промпт лучше / точнее / подробнее"
- "проработай постановку", "оформи задачу", "причеши задание"
- "структурируй ТЗ", "подготовь ТЗ из заметки"
- "расширь описание задачи", "преобразуй это в подробную инструкцию"
Скил работает с любой предметной областью, но специально учитывает особенности задач 1С (термины, имена реквизитов, объектов, форм).
Режимы работы
| Режим |
Триггер |
Что делает |
| Inline |
аргумент - произвольный текст |
Улучшенный промпт выводится в чат |
| File |
аргумент - путь к существующему файлу |
Результат сохраняется рядом с суффиксом -enhanced.md |
| Interactive |
аргумент пустой |
Спросить у пользователя текст или путь |
Алгоритм определения режима
Режим выбирается детерминированно, без эвристики по тексту аргумента:
- Если аргумент пустой - режим Interactive. Попросить у пользователя текст промпта или путь к файлу обычным сообщением.
- Иначе попытаться прочитать аргумент через инструмент Read.
- Если Read вернул содержимое файла - режим File.
- Если Read вернул ошибку вида "файл не существует / не найден" - это штатный путь, не сбой. Переключиться в Inline: аргумент целиком использовать как текст промпта.
- Не определять режим по наличию ".md" в тексте. Формулировка "оформи ТЗ про .md генерацию" не должна интерпретироваться как путь. Проверку существования файла делает Read, не парсинг строки.
Принципы преобразования
Ядро скила. При каждой генерации возвращайся к этому списку:
- Сохранение исходника как источника истины. Все термины, имена реквизитов, вкладок, объектов, форм, подсистем, числа, перечни переносить буквально. Не заменять "Орг_КодИсточника77" на "служебный реквизит".
- Императив вместо описания. "нужно вывести" превращать в "Выведи", "надо бы проанализировать" в "Проанализируй". Результат это план действий, не рассказ.
- Явное выделение граничных случаев. Условия-исключения выносить отдельным предложением в форме "если ..., то ...", не прятать в скобках. Граничный случай должен бросаться в глаза.
- Фиксация ожидаемого вывода. Добавить раздел "Для каждого элемента укажи" с нумерованным списком полей. Формат результата (таблица, структурированный список, JSON) называть явно.
- Без новых требований. Не добавлять требований, которых не было в исходнике: тесты, документация, роли, откаты, логирование. Улучшение это форма, не содержание.
- Нумерация шагов анализа. Разбить пользовательские пожелания на дискретные проверяемые операции 1..N. Каждый шаг одна операция.
- Сохранение намерения, а не дословного текста. Если в исходнике "подготовь список", а далее перечислены аналитические задачи, сначала идет анализ, потом составление списка. Восстановить правильный порядок.
- Нейтральный деловой регистр. Убрать разговорные и эмоциональные элементы ("надо бы", "как-то так", "хотелось бы"), оставить нейтральную формулировку.
- Короткая суть в первой строке. Перед пошаговым планом одно предложение, передающее цель задачи.
- Форматирование по правилам репо. Без длинных и коротких тире (только обычный дефис), без буквы е с точками, без оценок времени и ROI.
Шаблон улучшенного промпта
Обязательные блоки результата:
- Цель - одно предложение, что нужно сделать.
- Шаги анализа - нумерованный список императивов (Проанализируй, Изучи, Определи, Выведи).
- Граничные случаи - явные условия "если ..., то ..." с конкретными именами и значениями из исходника.
- Формат вывода - название формата (таблица / структурированный список / JSON) и перечень полей, которые должны быть в результате.
- Дополнительные уточнения (опционально) - детали, если в исходнике были указаны сроки, ответственные, зависимости.
Пример "до/после"
Исходный промпт (короткий, неструктурированный):
Задача - все нетиповые реквизиты в типовых объектах вывести на вкладку "Доп. реквизиты Орг". Вкладку разместить самой последней. Если добавлен только один реквизит, Орг_КодИсточника77, то ничего не делаем. Подготовь список объектов, проанализируй формы элементов, определи, куда и как добавить вкладку.
Улучшенный промпт (структурированный, подробный):
Проанализируй все типовые объекты конфигурации и подготовь список тех, в которых присутствуют нетиповые реквизиты. Изучи формы элементов этих объектов. Добавь в каждую форму новую вкладку "Доп. реквизиты Орг" последней по порядку. Перенеси на вкладку все нетиповые реквизиты, кроме случая, когда единственный нетиповой реквизит это Орг_КодИсточника77 (тогда изменения не вносятся). Для каждого объекта укажи:
- Наименование объекта.
- Список нетиповых реквизитов.
- Название используемой формы элемента и текущую структуру вкладок.
- Рекомендуемые изменения по размещению вкладки и переносу реквизитов с учетом логики интерфейса.
Сформируй вывод в виде удобной таблицы или структурированного списка для дальнейшего внедрения.
Дополнительные кейсы смотри в 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 и смежные скилы репозитория.
1---2name: prompt-enhancer-23description: Улучшает и структурирует короткие неструктурированные промпты и постановки задач, превращая их в подробные императивные ТЗ с пронумерованными шагами анализа, явными граничными случаями и описанием формата ожидаемого вывода. Сохраняет все термины и условия исходника, не добавляет новых требований. Используй когда пользователь просит: улучшить промпт, проработать постановку, расширить описание задачи, структурировать ТЗ, оформить заметку в подробную инструкцию, сделать промпт точнее или подробнее, подготовить ТЗ из черновика, причесать задание, преобразовать короткую заметку в понятное ТЗ. Принимает текст в аргументе команды или путь к .md файлу.4---56# /prompt-enhancer - улучшение промптов и постановок задач78Превращает короткую заметку или неструктурированное задание в подробное императивное ТЗ. Подходит для разработчиков 1С, которым нужно оформить быстро сформулированную мысль в понятную постановку задачи.910## Когда использовать1112Вызывай скил по фразам пользователя:1314- "улучши промпт", "сделай промпт лучше / точнее / подробнее"15- "проработай постановку", "оформи задачу", "причеши задание"16- "структурируй ТЗ", "подготовь ТЗ из заметки"17- "расширь описание задачи", "преобразуй это в подробную инструкцию"1819Скил работает с любой предметной областью, но специально учитывает особенности задач 1С (термины, имена реквизитов, объектов, форм).2021## Режимы работы2223| Режим | Триггер | Что делает |24|-------|---------|------------|25| Inline | аргумент - произвольный текст | Улучшенный промпт выводится в чат |26| File | аргумент - путь к существующему файлу | Результат сохраняется рядом с суффиксом `-enhanced.md` |27| Interactive | аргумент пустой | Спросить у пользователя текст или путь |2829## Алгоритм определения режима3031Режим выбирается детерминированно, без эвристики по тексту аргумента:32331. Если аргумент пустой - режим Interactive. Попросить у пользователя текст промпта или путь к файлу обычным сообщением.342. Иначе попытаться прочитать аргумент через инструмент Read.35 - Если Read вернул содержимое файла - режим File.36 - Если Read вернул ошибку вида "файл не существует / не найден" - это штатный путь, не сбой. Переключиться в Inline: аргумент целиком использовать как текст промпта.373. Не определять режим по наличию ".md" в тексте. Формулировка "оформи ТЗ про .md генерацию" не должна интерпретироваться как путь. Проверку существования файла делает Read, не парсинг строки.3839## Принципы преобразования4041Ядро скила. При каждой генерации возвращайся к этому списку:42431. **Сохранение исходника как источника истины.** Все термины, имена реквизитов, вкладок, объектов, форм, подсистем, числа, перечни переносить буквально. Не заменять "Орг_КодИсточника77" на "служебный реквизит".442. **Императив вместо описания.** "нужно вывести" превращать в "Выведи", "надо бы проанализировать" в "Проанализируй". Результат это план действий, не рассказ.453. **Явное выделение граничных случаев.** Условия-исключения выносить отдельным предложением в форме "если ..., то ...", не прятать в скобках. Граничный случай должен бросаться в глаза.464. **Фиксация ожидаемого вывода.** Добавить раздел "Для каждого элемента укажи" с нумерованным списком полей. Формат результата (таблица, структурированный список, JSON) называть явно.475. **Без новых требований.** Не добавлять требований, которых не было в исходнике: тесты, документация, роли, откаты, логирование. Улучшение это форма, не содержание.486. **Нумерация шагов анализа.** Разбить пользовательские пожелания на дискретные проверяемые операции 1..N. Каждый шаг одна операция.497. **Сохранение намерения, а не дословного текста.** Если в исходнике "подготовь список", а далее перечислены аналитические задачи, сначала идет анализ, потом составление списка. Восстановить правильный порядок.508. **Нейтральный деловой регистр.** Убрать разговорные и эмоциональные элементы ("надо бы", "как-то так", "хотелось бы"), оставить нейтральную формулировку.519. **Короткая суть в первой строке.** Перед пошаговым планом одно предложение, передающее цель задачи.5210. **Форматирование по правилам репо.** Без длинных и коротких тире (только обычный дефис), без буквы е с точками, без оценок времени и ROI.5354## Шаблон улучшенного промпта5556Обязательные блоки результата:57581. **Цель** - одно предложение, что нужно сделать.592. **Шаги анализа** - нумерованный список императивов (Проанализируй, Изучи, Определи, Выведи).603. **Граничные случаи** - явные условия "если ..., то ..." с конкретными именами и значениями из исходника.614. **Формат вывода** - название формата (таблица / структурированный список / JSON) и перечень полей, которые должны быть в результате.625. **Дополнительные уточнения** (опционально) - детали, если в исходнике были указаны сроки, ответственные, зависимости.6364## Пример "до/после"6566**Исходный промпт (короткий, неструктурированный):**6768> Задача - все нетиповые реквизиты в типовых объектах вывести на вкладку "Доп. реквизиты Орг". Вкладку разместить самой последней. Если добавлен только один реквизит, Орг_КодИсточника77, то ничего не делаем. Подготовь список объектов, проанализируй формы элементов, определи, куда и как добавить вкладку.6970**Улучшенный промпт (структурированный, подробный):**7172> Проанализируй все типовые объекты конфигурации и подготовь список тех, в которых присутствуют нетиповые реквизиты. Изучи формы элементов этих объектов. Добавь в каждую форму новую вкладку "Доп. реквизиты Орг" последней по порядку. Перенеси на вкладку все нетиповые реквизиты, кроме случая, когда единственный нетиповой реквизит это Орг_КодИсточника77 (тогда изменения не вносятся). Для каждого объекта укажи:73>74> 1. Наименование объекта.75> 2. Список нетиповых реквизитов.76> 3. Название используемой формы элемента и текущую структуру вкладок.77> 4. Рекомендуемые изменения по размещению вкладки и переносу реквизитов с учетом логики интерфейса.78>79> Сформируй вывод в виде удобной таблицы или структурированного списка для дальнейшего внедрения.8081Дополнительные кейсы смотри в `examples/`.8283## DO / DON'T8485**DO:**86- Сохранять имена объектов, реквизитов, вкладок, констант, перечисления буквально.87- Превращать просьбы в императивы, добавлять структуру и нумерацию.88- Выносить исключения и граничные случаи отдельным предложением.89- Указывать формат ожидаемого результата явно.90- Добавлять короткую суть первой строкой перед пошаговым планом.9192**DON'T:**93- Придумывать новые требования, которых не было в исходнике (роли, тесты, откат, печать, логирование).94- Заменять конкретные термины обобщениями.95- Добавлять технические решения ("используй БСП", "сделай через HTTP сервис"), если они не упомянуты в исходнике.96- Использовать длинное тире, короткое тире, двойной дефис, букву е с точками.97- Оценивать трудозатраты в часах, днях, неделях, стоимость в деньгах.9899## Сохранение файла (file-режим)100101- Имя результата: `<имя исходного файла без расширения>-enhanced.md`. Если оригинал `postanovka.md`, результат `postanovka-enhanced.md` в той же папке.102- Кодировка: utf-8.103- Оригинал не перезаписывать, не удалять, не переименовывать.104- Если файл-результат уже существует, перезаписать без спроса (это повторный запуск скила).105106## Обработка кодировки107108Исходные файлы читаются как utf-8. Если Read возвращает явный mojibake (нечитаемая кириллица вида "ж©", "", квадраты), сообщи пользователю, что файл похоже в cp1251 или другой кодировке, и попроси сохранить в utf-8. Автоопределение кодировки в скиле не реализовано намеренно - это осознанное упрощение первой версии.109110## Фразы-триггеры (для надежности срабатывания)111112Скил должен распознавать эти формулировки пользователя как триггеры, даже если команда `/prompt-enhancer` не указана явно:113114- улучши / улучшить промпт115- расширь / проработай / оформи постановку (задачи, ТЗ)116- структурируй ТЗ / задание117- сделай промпт подробнее / точнее / лучше118- подготовь подробное ТЗ из заметки / черновика119- причеши задание / постановку120- преобразуй в понятное ТЗ / в подробную инструкцию121122## Ограничения123124- Скил переписывает форму, не содержание. Если исходный промпт логически противоречив или неполон, результат тоже будет неполным (см. принцип 5 - без новых требований).125- Для очень длинных исходных текстов (2000+ слов) обработка может упустить детали. В таком случае разбивай текст на логические блоки и обрабатывай по частям.126- Скил не предполагает знаний предметной области за пределами исходника. Если нужны уточнения про 1С-специфику, дополнительно используй `/1c-config-router`, `/composing-1c-queries` и смежные скилы репозитория.
Desko77