Дядя Боб уместил правила для ИИ-агента в 750 слов: «готово» без теста не принимается

Если коротко, что такое ИИ агент: это программа на основе нейросети, которая сама читает код, вносит правки и запускает проверки, как стажёр с доступом к проекту. Мартин, которого разработчики зовут «Дядя Боб», переносит на агентов принципы своей книги. Скилл, то есть набор инструкций, который агент подгружает по команде, лежит на GitHub (сайт, где разработчики хранят и публикуют код) и занимает один файл примерно на 750 слов.

Что нового приносит ub-mode агентам?

В репозитории нет программного кода, только два текстовых файла: README.md и SKILL.md. Второй описывает порядок действий агента, первый отсылает к утилитам проверки. Правила разбиты на три части: First Make it Work («Сначала заставь работать»), Then Make it Right («Потом сделай правильно») и Practice («Практика»).

• Сначала тест, потом правка. Агент работает по TDD (разработка через тесты: проверку пишут до изменения кода). Тест должен падать по ожидаемой причине, затем идёт минимальная правка. Если честный тест написать слишком сложно, фиктивный писать нельзя.
• Данные и вход продумываются заранее. До логики агент проектирует структуру данных и проверяет всё, что приходит извне, прямо на входе в систему.
• Повторный запуск без сюрпризов. Код, который пишет в базу или обращается к внешним сервисам, при перезапуске после сбоя должен давать тот же результат, что и первый запуск.
• Убери лишнее, прежде чем добавлять. Агент сначала удаляет ненужные ветки, обёртки и дубли, а новая функциональность ложится на расчищенную основу.
• Журнал решений и маленькие коммиты. Коммит, это сохранённый шаг в истории изменений проекта. В его описании агент излагает причину, суть изменения и способ проверки.

Автор пишет, что частично взял идеи из poteto-mode и pstack.

Почему заплатка не считается исправлением?

В части «Потом сделай правильно» Мартин требует искать первопричину ошибки, а не прятать симптом.

Защитная проверка, которая только прячет падение, это не исправление. : Роберт Мартин, автор «Чистого кода»

Пример из правил: проверка на null (пустое значение, когда данных нет) уберёт падение программы, но не ответит, откуда там взялась пустота. Обратите внимание, правило не запрещает защитные проверки вовсе, оно запрещает считать их исправлением. По той же логике агенту нельзя глушить ошибки компилятора.

Спрятать баг может и сам тест. Если тест проходит, даже когда каждая функция возвращает пустой результат, его надо выбросить. На честных тестах держится и рефакторинг (перестройка кода без изменения его поведения): агент меняет структуру мелкими шагами и проверяет поведение после каждого.

Три утилиты проверяют код вместо самооценки агента

Мартин не доверяет оценке, которую агент даёт своей работе. Скилл требует прогонять код через три утилиты:

• Crapper ставит балл риска каждой функции: чем она сложнее и хуже покрыта тестами, тем выше балл.
• Dryer ищет похожие фрагменты кода.
• Mutator вносит в код мелкие ошибки и смотрит, заметят ли их тесты.

По итогам агент разбивает рискованные функции или покрывает их тестами, убирает дубли, дописывает тесты и удаляет мёртвый код. Пороги Мартина, риск меньше 10 на функцию и дубли от 0,8 похожести, он сам называет личными требованиями.

Как попробовать ub-mode у себя?

1. Скопируйте SKILL.md в каталог skills своего агента. Для Claude в README указан путь ~/.claude/skills/ub-mode/SKILL.md, в примерах есть также Grok и Cursor.
2. Установите Crapper, Dryer и Mutator самостоятельно, без них скилл работает не полностью.
3. Вызовите скилл командой /ub-mode.
4. Дайте небольшую задачу с понятным результатом и проверьте: написан ли падающий тест до правки, не разросся ли объём изменений, какие проверки агент выполнил на деле.

Подойдёт ли ub-mode для YandexGPT и GigaChat?

Источник называет только Claude, Grok и Cursor, о российских моделях и о доступности перечисленных сервисов в России не сказано ничего. Из доступных в РФ аналогов есть YandexGPT и GigaChat, но готовой интеграции с ними в README нет. Сам ub-mode, это текст правил, а не программа, поэтому его логику можно изучить и без подключения.

Что делать с этим прямо сейчас, по ролям

Разработчику. Подключите скилл в Cursor или Claude на тестовом проекте и сравните, как агент работает с правилами и без них. Пороги и правило про основную ветку настройте под свою команду.

Автору Дзена. Если пишете про ИИ, у вас готовый понятный сюжет: известный программист учит машину не врать «готово». Объясните читателю принцип «сначала докажи, потом сдавай» на бытовом примере.

Маркетологу. Если подрядчик делает вам сайт или бота с помощью агентов, спросите, проверяют ли они результат тестами. Правила Мартина дают готовый список вопросов к такому подрядчику.

Предпринимателю. Файл открыт, но для работы нужен агент с поддержкой скиллов и человек, умеющий ставить утилиты. Без разработчика рядом внедрять это не стоит.

Что спрашивают про ub-mode чаще всего?

Что такое ub-mode?

Это файл с инженерными правилами для агента: от разработки через тесты до проверок качества и коммитов. Кода в нём нет, только инструкции.

Нужно ли уметь программировать, чтобы им пользоваться?

Да. Правила касаются тестов, структуры кода и истории изменений, а утилиты проверки ставятся вручную. Человеку без технической подготовки скилл пригодится как пример того, как ставить задачи нейросети.

Можно ли брать пороги Мартина как есть?

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