Политика и реестр использования ИИ, которые небольшая команда может проверять
Политика использования ИИ говорит людям, что им можно. Реестр говорит, что можно каждой ИИ-возможности в вашей команде, кто её запускает и когда нужно решение человека. Держите его одним файлом в репозитории и пусть тест роняет сборку, если у возможности нет строки.
🎯 Для Руководитель команды или разработчик, который запускает ИИ-агентов на общей работе
- Что входит в реестр ИИ и что должна сказать политика в шести строках
- Как собрать реестр за полчаса и защитить его тестом
- Где реестр перестаёт помогать
📋 Что такое реестр и почему одной политики мало
Политика использования ИИ описывает, что людям разрешено. Реестр описывает, что фактически разрешено каждой ИИ-возможности в команде, кто может её запустить и когда нужен человек. Без реестра политика остаётся пожеланием: во вторник никто не скажет, какой агент может менять файлы, какой пишет в клиентскую систему, а какой только читает.
Реестр — обычный файл в репозитории. Одна строка на возможность: роль агента, библиотека промптов, коннектор, задание по расписанию. На каждой строке одни и те же семь вопросов, поэтому ревьюер читает сорок строк за десять минут.
| Поле | На какой вопрос отвечает | Пример |
|---|---|---|
| id | Как это называется? | release-notes-writer |
| назначение | Правило или действие: оно только описывает, как работать, или действует? | правило / действует |
| источник полномочий | Это наше обязательное правило или чужой совет, который можно не выполнять? | своё / совет |
| класс риска | Что самое опасное оно может затронуть? | только чтение · запись в репозиторий · изменение во внешней системе · платное или необратимое |
| низший уровень | Какой исполнитель вправе это запускать? | дешёвая модель · средняя · старшая · человек |
| нужен человек | Должен ли человек одобрить до действия? | да / нет |
| владелец | Кто отвечает, когда сломается? | имя, а не общий псевдоним команды |
🧭 Политика в шести строках
- У каждой используемой ИИ-возможности есть строка в реестре до того, как она работает на реальной задаче.
- Внешний совет (руководство поставщика, найденный шаблон) помечается как совет и никогда не становится обязательным правилом.
- Возможность, которая меняет внешнюю систему или касается денег и необратимого, каждый раз требует именованного человека для одобрения.
- Действующая возможность такого рода не запускается на самом дешёвом исполнителе.
- Правило, которое только описывает порядок работы, действует на всех уровнях, включая скрипты без модели.
- Реестр проверяет тест. Возможность, которая есть на диске, но не имеет строки, роняет сборку.
🛠️ Практика: соберите реестр за полчаса
- Перечислите все ИИ-возможности, которые команда использует сегодня. Ищите в трёх местах: репозиторий (файлы промптов, конфиги агентов), настройки редактора и задания по расписанию. По одной строке на каждую.
- Заполните семь полей. Если двое спорят о классе риска, берите более высокий.
- Отметьте «нужен человек» у каждой строки, которая что-то меняет вне вашего репозитория. Об исключениях пока не спорьте.
- Сохраните строки одним файлом YAML или CSV, например
ai-register.yaml, в корне репозитория. - Напишите тест, который читает файл и падает в четырёх случаях: нет обязательного поля, дубликат id, строка с чужим советом помечена как обязательное правило, в репозитории есть файл возможности без строки.
- Запустите тест, исправьте найденное и закоммитьте реестр вместе с тестом.
✅ Проверьте себя
- Выберите возможность наугад и ответьте на семь вопросов только по файлу, никого не спрашивая.
- Добавьте файл возможности без строки. Тест падает и называет файл.
- Пометьте строку с изменением во внешней системе как «человек не нужен». Тест падает и называет строку.
- Новый человек за две минуты понимает, какие возможности могут действовать без одобрения.
🚧 Когда это не работает
- Реестр описывает заявленное, а не используемое. Если человек вставляет промпт в инструмент, которого нет в списке, реестр это не увидит. Тест видит только отслеживаемые файлы.
- Команда из одного человека без общего репозитория. Тесту нечего охранять. Короткий письменный список всё равно полезен, но от забывчивости не спасёт.
- Возможности внутри размещённого инструмента, который вы не можете осмотреть. Можно записать подключение и его права, но не внутреннее поведение поставщика.
- Реестр без ревью дрейфует. Если строки не трогали квартал, считайте его устаревшим и повторите шаг 1.
- Политика для галочки. Шесть правил без теста и владельца ничего не меняют. Если тест написать нельзя, сократите политику, пока можно.
📊 Доказательства
Мы ведём такой реестр для собственных навыков агентов. На 3 ноября 2026 (UTC) в нём было 32 строки: 17 только чтение, 6 запись в репозиторий, 6 изменение во внешней системе и 3 связаны с деньгами; 12 требуют решения человека; 24 действуют, а 8 — правила, которые только описывают порядок работы. Семь тестов, которые его охраняют, в тот же день прошли. Среди прочего они проверяют схему и уникальность id, что чужой совет никогда не помечен обязательным, что строки с изменением во внешней системе и с деньгами требуют человека и, если действуют, работают на среднем уровне или выше, что правила исходят от нашего собственного источника полномочий, и что файлы на диске и строки совпадают в обе стороны.
| Что измерено | Строки по классу риска и по необходимости человека в нашем реестре |
| Когда | 3 ноября 2026, 21:17 UTC |
| Артефакт | Наш реестр навыков и его файл тестов в закрытом репозитории (7 тестов прошли) |
| Ограничение | Это число заявленного. Оно не показывает, как часто запускалась каждая возможность, и ничего не говорит о вашей команде |
➡️ Дальше
Когда реестр есть, решите, что делать, если агент всё же ошибся: План реагирования для небольшой команды. Что подтверждает квитанция о запуске, читайте в Квитанциях задач агента.
Источники
- Права и потоки данных: что агент может затрагивать и что покидает вашу машину.
- AI judging: почему «он говорит, что готово» — не приёмка: приёмка по проверкам.
- Разработка по спецификации на готовых пакетах задач: передача работы с критериями приёмки.
- Расходы, бюджеты и лимиты: бюджет на задачу.
🔗 Связи статьи
Открыть полный граф знаний ↗Связи опубликованных статей. Выберите узел, чтобы открыть статью у заголовка.
Связи статей · клавиатура / текст
Та же тема
- Векторная база — это карта, а не источник: чему нас научил поиск
- Когда неизвестно, сколько стоил вызов модели: заморозка, затем сверка
- Как разбить большую задачу для дешёвой модели: урок 24 000 байт
- Навыки, MCP-инструменты и правила: три способа дать агенту возможности
- Восемь ошибок наших агентов в shell и git и правило на каждую
- Несколько агентов, один репозиторий: правила владения из реальных инцидентов
Следующие шаги
Связанные материалы
Векторная база — это карта, а не источник: чему нас научил поиск
Векторная база находит фрагменты, близкие по смыслу к вашему вопросу. Она не знает, какие из них верны или актуальны. Считайте каждое попадание указателем: откройте названный файл, сверьте хэш, а числа берите из артефакта, а не из найденного абзаца.
ИИ-агенты и MCP простыми словамиКогда неизвестно, сколько стоил вызов модели: заморозка, затем сверка
Иногда вызов модели обрывается по таймауту, и вы не знаете, списал ли провайдер деньги. Никогда не записывайте это как ноль. Пометьте как неопределённое, остановите новые платные вызовы и пусть названный человек сверит это с выпиской провайдера. Отказы до генерации — исключение.
ИИ-агенты и MCP простыми словамиКак разбить большую задачу для дешёвой модели: урок 24 000 байт
Дешёвая модель хорошо справляется с одной небольшой чёткой задачей и плохо — с большой кучей. Мы ограничиваем задачу 24 000 байт и отклоняем большие до вызова любой модели. Режьте по единицам — один файл или одна страна на задачу — и проверяйте размер до запуска.
ИИ-агенты и MCP простыми словамиНавыки, MCP-инструменты и правила: три способа дать агенту возможности
Агенты получают способности по-разному. Правило ограничивает, что они делают, навык говорит, как делать работу, а MCP-инструмент позволяет вызывать функцию. У каждого свой риск, поэтому объявляйте все три в реестре и проверяйте тестом, что ничего не существует вне списка.
💬 Комментарии