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

Дата: 2026-08-23.
Статус: ACTIVE.
Тип задачи: проектирование процесса разработки.
Компоненты: AI-агенты, документация, project Skills.
Теги: memory, skills, agents, governance, recovery.
Связанные решения: 0021.
Связанный Skill: .agents/skills/agent-learning/SKILL.md.

Контекст и границы¶

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

Память должна быть общей для проектных ролей и не заменять AGENTS.md, ADR, docs/STATUS.md или Git. Локальная память AI-клиента остаётся только вспомогательным recall-слоем.

Что сработало¶

Разделение обязательных правил, текущего состояния, повторяемого опыта и исполняемых Skills.
Запись только полезного повторяемого знания вместо протоколирования каждого действия.
Продвижение первого наблюдения через подтверждение в Skill-кандидат.
Поиск существующего Skill до создания и обновление при совпадающем контракте.
Независимый review критических Skills и сохранение прежних permission boundaries.

Что не сработало и почему¶

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

Проверки и свидетельства¶

Решение явно принято владельцем 2026-08-23.
Проектный путь .agents/skills соответствует поддерживаемому repo-scoped расположению Codex.
Структура Skill проверяется штатным валидатором skill-creator.

Когда применять¶

При завершении задачи с неочевидным повторяемым опытом, повторении известной процедуры, создании нового Skill или улучшении существующего.

Когда не применять¶

Для фиксации каждого очевидного шага, хранения секретов, подмены канонических решений или получения дополнительных полномочий.

Следующее улучшение¶

После первого реального повторного применения проверить качество поиска записи, корректность выбора update/new и достаточность шаблона. Изменять существующий agent-learning, а не создавать второй Skill с тем же назначением.