0021 — Общая память агентов и самоулучшение Skills¶

Дата: 2026-08-23.
Статус: Принято пользователем; базовый проектный контур реализуется в DEV.
Ответственный: владелец проекта.

Контекст¶

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

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

Решение¶

Общая память¶

Память разработки SKUARO является общей для всех проектных агентов и хранится в Git.
Обязательные правила остаются в AGENTS.md, политике, архитектуре и ADR. Записи опыта не переопределяют эти источники.
Локальная память Codex используется только как вспомогательный слой восстановления контекста.
Политика, формат и жизненный цикл описаны в docs/AGENT_MEMORY_AND_SKILLS.md.
Полезный повторяемый опыт хранится в docs/agent-memory/; чат и session logs не являются единственным источником такого опыта.

Что записывается¶

Отчёт о содержательной задаче сохраняет результат, файлы, проверки, ошибки, решения, риски и следующий шаг по действующим правилам документирования.
Отдельная запись опыта создаётся только при наличии повторно применимого знания: неочевидного решения, подтверждённой ошибки, устойчивой последовательности, ограничения инструмента или измеримого улучшения.
Запись опыта не может содержать секреты, credentials, персональные или реальные клиентские данные.
Статусы опыта: OBSERVED, VALIDATED, SKILL_CANDIDATE, ACTIVE, DEPRECATED, BLOCKED.

Создание и обновление Skills¶

Перед созданием Skill агент обязан проверить реестр и существующие .agents/skills по цели, входам, выходам, области, permissions и рискам.
Совпадающий контракт означает обновление существующего Skill, а не создание дубликата.
Новый Skill создаётся при новом контракте либо после повторного подтверждения полезной процедуры. После первого выполнения допускается только запись опыта, кроме сложной, дорогой или рискованной процедуры, где ранняя формализация снижает риск.
Улучшение Skill принимается только при проверяемом основании: устранённая ошибка, сокращение ручных шагов, усиление безопасности, новая проверка или подтверждённое расширение области без потери прежнего поведения.
Изменённый Skill применяется как новая версия со следующей подходящей задачи и сохраняет историю через Git.

Контроль автономности¶

Любой агент может создать запись опыта и подготовить новый или обновлённый Skill в границах текущей локальной задачи.
Создание или изменение Skill не расширяет разрешения агента на установку, удаление, публикацию, deploy, Git-операции, работу с секретами или внешними ресурсами.
Критический Skill для deploy, миграций, backup/restore, удаления, production, секретов или безопасности требует независимой проверки и явного разрешения владельца перед опасным действием.
Автор Skill не может единолично признать критический Skill готовым; необходимы отдельные роли tester и/или reviewer.
Skill не меняет собственные правила незаметно в ходе критической операции. Обновление оформляется отдельным изменением и применяется после проверки.

Проектный Skill¶

В репозитории создаётся .agents/skills/agent-learning/SKILL.md.
Skill активируется для ретроспективы повторяемой задачи, записи опыта, создания нового Skill или улучшения существующего.
Он не заменяет системный skill-creator: проектный Skill определяет правила SKUARO, а доступный creator помогает технически создать или обновить Skill.

Последствия¶

Новый агент может восстановить не только текущее состояние, но и подтверждённые способы решения повторяющихся задач.
Агенты разных ролей используют один набор опыта и не формируют несовместимые личные правила.
Количество Skills растёт только при доказанной повторяемости или значимом снижении риска.
Изменения памяти и Skills становятся обычными проверяемыми изменениями DEV и не активируют STAGE/PROD автоматически.

Откат или замена¶

Изоляция памяти по агентам, автоматическое принятие Skill без review, перенос канонических правил только во встроенную память или разрешение Skill самостоятельно расширять permissions требуют нового ADR.