AI: Критерии задачи для Агента

Критерии

1. Уникальность задачи

Что оценивает: насколько задача стандартна.
Стандартная задача: Соответствует типичному паттерну, который ИИ-агент уже много раз видел.
Добавить стандартную сортировку по алфавиту в таблицу пользователей.
Уникальная задача: Содержит специфическую бизнес-логику или нестандартные требования.
Добавить сортировку пользователей по комплексному скорингу, который учитывает VIP-статус, недавнюю активность и другие неочевидные параметры.
Решение: Если задача уникальна, декомпозируйте её на несколько более мелких и стандартных подзадач. Это поможет ИИ-агенту лучше справиться с каждой частью.


2. Глубина погружения в код

Что оценивает: сколько контекста (файлов и зависимостей) должен изучить ИИ-агент для выполнения задачи.
Проблема: Чем больше файлов ИИ-агенту нужно прочитать и проанализировать, тем выше вероятность ошибки и перегрузки контекста.
Решение: Разбивайте задачу на последовательные этапы.
Сначала компонент, потом реализация логики, затем интеграция.


3. Знания, которых нет в кодовой базе

Что оценивает: требует ли задача знаний о предметной области, которые не отражены напрямую в коде.
Проблема: ИИ-агент не знает неявных бизнес-правил, особенностей вашей компании или специфики предметной области. Он видит только код.
При расчёте скидки нужно учитывать специальное правило для клиентов из определённого региона, но это правило нигде в коде не описано.
Решение:
  • Отделите процесс "креатива" и описания фичи от процесса разработки.
  • Добавляйте важные нюансы предметной области в промт или в глобальные правила проекта для ИИ-агента.
  • Мысленно ставьте себя на место ИИ и спрашивайте: "Какую информацию мне нужно знать, чтобы выполнить эту задачу, видя только код?"


4. Количество мест для изменений

Что оценивает: сколько файлов и участков кода нужно будет изменить для решения задачи. Это особенно актуально для рефакторинга.
Проблема: ИИ-агенты часто допускают ошибки при внесении изменений в большое количество файлов (> 20).
Простое переименование переменной, используемой по всему проекту.
Решение: Декомпозируйте задачу. Если небольшое изменение затрагивает слишком много файлов и его сложно разбить на части, проще и быстрее выполнить его вручную.


5. Неявные состояния системы

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


Решение, которое нужно принять

    Делегировать как есть (если задача простая и стандартная).
    Декомпозировать на подзадачи.
    Добавить больше контекста (бизнес-правила, детали реализации).
    Выполнить вручную (если задача слишком сложна или рискованна для ИИ).