refine-intent

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

Зачем

Типичная потеря времени с кодовым агентом выглядит так: вы пишете «сделай нормально авторизацию», агент делает что-то правдоподобное, вы смотрите на результат и понимаете, что имели в виду другое. Дешевле выяснить это до работы, чем после.

Скилл добавляет отдельный шаг перед исполнением:

1. Разведка по репозиторию — всё, что можно прочитать, не спрашивается.
2. Карта неопределённости по осям: результат, границы, ограничения, критерий готовности.
3. Раунды уточнения через вопросы с готовыми вариантами (1–3 вопроса за раз).
4. Проверка на подмену задачи — не сузил ли агент запрос до удобной подзадачи.
5. Итоговая спека: в объёме / вне объёма / ограничения / умолчания / готово, когда.
6. Передача в работу — выполнять сейчас, сохранить спеку в файл или продолжить уточнение.

Диалог ведётся на языке исходного запроса.

Установка

npx skills add prostohz/refine-intent

Глобально и только для Claude Code:

npx skills add prostohz/refine-intent -g -a claude-code

CLI skills ставит скилл в директорию нужного агента (для Claude Code это ~/.claude/skills/ или .claude/skills/). Вручную то же самое:

git clone https://github.com/prostohz/refine-intent.git ~/.claude/skills/refine-intent

Использование

/refine-intent сделай нормально форму логина

Без аргументов скилл берёт последнее содержательное сообщение диалога. Агент также может подхватить его сам, когда запрос выглядит недоопределённым.

Пример

Было: «сделай нормально форму логина»

Раунд 1 — агент читает проект и спрашивает про развилку максимального веса: чинить существующую вёрстку или заменить на компонент из UI-кита, который уже есть в зависимостях.

Раунд 2 — опирается на ответ: что считать «нормально» — валидация и состояния ошибок, или доступность и клавиатурная навигация.

Раунд 3 — граничные случаи: поведение при истёкшей сессии, повторная отправка, серверные ошибки.

Стало:

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

## В объёме
- Инлайн-валидация email и пароля до отправки
- Состояния: загрузка, ошибка сети, неверные учётные данные
- Блокировка повторной отправки

## Вне объёма
- Редизайн, OAuth-провайдеры, восстановление пароля

## Умолчания (принял сам, скажи если не так)
- Тексты ошибок на русском, без i18n-словаря
- Существующий компонент Input не переписываем

## Готово, когда
- Неверный пароль показывает ошибку под полем, форма не сбрасывается
- Двойной клик по «Войти» отправляет один запрос

Когда не нужен

• Задача уже сформулирована точно — скилл только добавит раунд вопросов.
• Механическая правка: переименовать, обновить версию, поправить опечатку.
• Вы сознательно хотите быстрый черновик и готовы его выбросить.

Скилл не останавливается сам: уточнение идёт, пока вы не скажете «хватит». В каждом раунде последний вариант — «Хватит, переходим к спеке», так что выход всегда в один клик. Когда крупные развилки сняты, скилл сам начинает рекомендовать переход к спеке.

Совместимость

Обычный SKILL.md без внешних зависимостей — работает в любом агенте, поддерживающем формат Agent Skills (Claude Code, Codex, Cursor, Zed и другие). Единственное требование к агенту — умение задавать пользователю вопросы с вариантами ответа; без этого раунды выродятся в обычный текстовый диалог.

Лицензия

MIT — см. LICENSE.

---

English

refine-intent is an agent skill that turns a vague prompt into a task spec. It runs clarification in rounds — each question builds on the previous answer, never a batch of ten at once — then outputs scope, constraints, assumptions and acceptance criteria. It never stops on its own: you end it, in one click. The dialogue is conducted in the language of your original request.

npx skills add prostohz/refine-intent