Блок 1 · Урок 4 из 4 · ≈ 9 минут · цель: принимать дизайн через критерии

Хороший дизайн для руководителя агента

Главная мысль: хороший дизайн в работе с агентом - это не “красиво выглядит в коде”, а “понятно, что обещано снаружи, что спрятано внутри и как проверить результат”.

Вопрос: что должен знать пользователь модуля?

Приёмка: проверяем поведение, а не внутреннюю красоту.

Зачем это вам

Когда агент приносит решение, легко смотреть только на экран: работает ли кнопка, нет ли ошибки, стало ли похоже на просьбу. Но архитектурно важнее другое: насколько легко будет изменить это через неделю.

Вы можете принимать дизайн по простым критериям: маленький интерфейс, скрытая сложность, понятный словарь, тесты через поведение, отсутствие лишних seams.

Суть

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

Назовите интерфейс. Что должен знать внешний код: вход, результат, ошибки, ограничения, порядок использования?

Назовите спрятанную сложность. Что теперь можно менять внутри, не переписывая вызывающие места?

Назовите проверку. Как убедиться, что поведение работает, не закрепляя внутренние шаги?

Аналогия

Руководить агентом - как принимать работу мастера: мало сказать “выглядит аккуратно”. Нужны критерии: что должно работать снаружи, что можно чинить внутри и как проверить, что обещание выполнено.

Запомните одно

Хороший дизайн для руководителя агента - это список проверяемых вопросов, а не эстетическое чувство “код стал аккуратнее”.

Фраза агента → что он имеет в виду

«Какой интерфейс вы хотите?»
Агент просит определить внешний контракт: что можно вызвать и что это обещает.
«Это лучше спрятать внутрь»
Деталь не должна стать знанием для всех вызывающих мест.
«Добавлю acceptance criteria»
Поведение будет принято по проверяемым условиям, а не по впечатлению.

Мини-словарь

Design criterion
Критерий дизайна: проверяемое условие, по которому можно оценить архитектурное решение.
Acceptance criteria
Критерии приёмки: список условий, по которым понятно, что задача выполнена.

Проверьте себя

Как лучше принять архитектурную работу агента?

Связанные материалы

Основной источник