Tvijo wiki
Каталог

Темы

Политика и реестр использования ИИ, которые небольшая команда может проверять

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

🎯 Для Руководитель команды или разработчик, который запускает ИИ-агентов на общей работе

📚 Вы узнаете
  • Что входит в реестр ИИ и что должна сказать политика в шести строках
  • Как собрать реестр за полчаса и защитить его тестом
  • Где реестр перестаёт помогать

📋 Что такое реестр и почему одной политики мало

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

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

Поле На какой вопрос отвечает Пример
id Как это называется? release-notes-writer
назначение Правило или действие: оно только описывает, как работать, или действует? правило / действует
источник полномочий Это наше обязательное правило или чужой совет, который можно не выполнять? своё / совет
класс риска Что самое опасное оно может затронуть? только чтение · запись в репозиторий · изменение во внешней системе · платное или необратимое
низший уровень Какой исполнитель вправе это запускать? дешёвая модель · средняя · старшая · человек
нужен человек Должен ли человек одобрить до действия? да / нет
владелец Кто отвечает, когда сломается? имя, а не общий псевдоним команды

🧭 Политика в шести строках

  1. У каждой используемой ИИ-возможности есть строка в реестре до того, как она работает на реальной задаче.
  2. Внешний совет (руководство поставщика, найденный шаблон) помечается как совет и никогда не становится обязательным правилом.
  3. Возможность, которая меняет внешнюю систему или касается денег и необратимого, каждый раз требует именованного человека для одобрения.
  4. Действующая возможность такого рода не запускается на самом дешёвом исполнителе.
  5. Правило, которое только описывает порядок работы, действует на всех уровнях, включая скрипты без модели.
  6. Реестр проверяет тест. Возможность, которая есть на диске, но не имеет строки, роняет сборку.

🛠️ Практика: соберите реестр за полчаса

  1. Перечислите все ИИ-возможности, которые команда использует сегодня. Ищите в трёх местах: репозиторий (файлы промптов, конфиги агентов), настройки редактора и задания по расписанию. По одной строке на каждую.
  2. Заполните семь полей. Если двое спорят о классе риска, берите более высокий.
  3. Отметьте «нужен человек» у каждой строки, которая что-то меняет вне вашего репозитория. Об исключениях пока не спорьте.
  4. Сохраните строки одним файлом YAML или CSV, например ai-register.yaml, в корне репозитория.
  5. Напишите тест, который читает файл и падает в четырёх случаях: нет обязательного поля, дубликат id, строка с чужим советом помечена как обязательное правило, в репозитории есть файл возможности без строки.
  6. Запустите тест, исправьте найденное и закоммитьте реестр вместе с тестом.

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

  • Выберите возможность наугад и ответьте на семь вопросов только по файлу, никого не спрашивая.
  • Добавьте файл возможности без строки. Тест падает и называет файл.
  • Пометьте строку с изменением во внешней системе как «человек не нужен». Тест падает и называет строку.
  • Новый человек за две минуты понимает, какие возможности могут действовать без одобрения.

🚧 Когда это не работает

  • Реестр описывает заявленное, а не используемое. Если человек вставляет промпт в инструмент, которого нет в списке, реестр это не увидит. Тест видит только отслеживаемые файлы.
  • Команда из одного человека без общего репозитория. Тесту нечего охранять. Короткий письменный список всё равно полезен, но от забывчивости не спасёт.
  • Возможности внутри размещённого инструмента, который вы не можете осмотреть. Можно записать подключение и его права, но не внутреннее поведение поставщика.
  • Реестр без ревью дрейфует. Если строки не трогали квартал, считайте его устаревшим и повторите шаг 1.
  • Политика для галочки. Шесть правил без теста и владельца ничего не меняют. Если тест написать нельзя, сократите политику, пока можно.

📊 Доказательства

Мы ведём такой реестр для собственных навыков агентов. На 3 ноября 2026 (UTC) в нём было 32 строки: 17 только чтение, 6 запись в репозиторий, 6 изменение во внешней системе и 3 связаны с деньгами; 12 требуют решения человека; 24 действуют, а 8 — правила, которые только описывают порядок работы. Семь тестов, которые его охраняют, в тот же день прошли. Среди прочего они проверяют схему и уникальность id, что чужой совет никогда не помечен обязательным, что строки с изменением во внешней системе и с деньгами требуют человека и, если действуют, работают на среднем уровне или выше, что правила исходят от нашего собственного источника полномочий, и что файлы на диске и строки совпадают в обе стороны.

Что измерено Строки по классу риска и по необходимости человека в нашем реестре
Когда 3 ноября 2026, 21:17 UTC
Артефакт Наш реестр навыков и его файл тестов в закрытом репозитории (7 тестов прошли)
Ограничение Это число заявленного. Оно не показывает, как часто запускалась каждая возможность, и ничего не говорит о вашей команде

➡️ Дальше

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

Источники

Связи опубликованных статей. Выберите узел, чтобы открыть статью у заголовка.

100%
→ Связанные статьи← Ссылаются сюда⋯ Та же тема
Связи статей · клавиатура / текст

💬 Комментарии

Комментарии публичны и модерируются. Не публикуйте персональные данные.
  • Комментариев пока нет. Будьте первым!

Следующие шаги

ИИ-агенты и MCP простыми словами

Векторная база — это карта, а не источник: чему нас научил поиск

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

ИИ-агенты и MCP простыми словами

Когда неизвестно, сколько стоил вызов модели: заморозка, затем сверка

Иногда вызов модели обрывается по таймауту, и вы не знаете, списал ли провайдер деньги. Никогда не записывайте это как ноль. Пометьте как неопределённое, остановите новые платные вызовы и пусть названный человек сверит это с выпиской провайдера. Отказы до генерации — исключение.

ИИ-агенты и MCP простыми словами

Как разбить большую задачу для дешёвой модели: урок 24 000 байт

Дешёвая модель хорошо справляется с одной небольшой чёткой задачей и плохо — с большой кучей. Мы ограничиваем задачу 24 000 байт и отклоняем большие до вызова любой модели. Режьте по единицам — один файл или одна страна на задачу — и проверяйте размер до запуска.

ИИ-агенты и MCP простыми словами

Навыки, MCP-инструменты и правила: три способа дать агенту возможности

Агенты получают способности по-разному. Правило ограничивает, что они делают, навык говорит, как делать работу, а MCP-инструмент позволяет вызывать функцию. У каждого свой риск, поэтому объявляйте все три в реестре и проверяйте тестом, что ничего не существует вне списка.