用一段提示词把 Google OKF 知识库接入 AGENTS.md 作为智能体记忆

Как я использую OKF в своих проектах?

Я запускаю этот промпт и дальше агент читает правила из AGENTS.md и использует как agentic memory:

Внедри в текущий репозиторий минимальную базу инженерных знаний в Google Open Knowledge Format (OKF v0.2). Правила её использования закрепи в корневом AGENTS.md.

Спецификация:
https://github.com/GoogleCloudPlatform/open-knowledge-format/blob/main/SPEC.md

1. Исследуй проект

Прочитай инструкции для агентов, README, ADR, документацию, конфигурацию сборки и CI. Найди существующий корпус знаний и устройство harness, включая xpowers, если он используется.

Сохрани действующие инструкции. Если подходящий корпус уже существует, развивай его вместо создания параллельного.

2. Создай knowledge/

Начни с index.md и 3–5 содержательных документов по реально исследованному проекту: архитектура, контракты, инварианты, проверка изменений, диагностика.

Возможные категории: architecture/, decisions/, contracts/, runbooks/, incidents/. Создавай только нужные; пустые разделы и заглушки не нужны.

Соблюдай OKF:

* В корневом index.md укажи okf_version: "0.2", добавь ссылки и краткие описания документов.
* В каждом обычном Markdown-документе используй YAML frontmatter с непустым type; добавь title, description и status.
* index.md и log.md оформляй по специальным правилам спецификации.
* Связывай документы относительными Markdown-ссылками.
* Указывай реальные источники в sources; для GitHub по возможности используй ссылки с commit SHA.
* generated и stale_after добавляй по необходимости.
* verified заполняй только после фактической проверки, указывая реального проверяющего и время.

Не дублируй большие README и ADR — ссылайся на них.

3. Проверяй основания

Утверждения о текущем поведении сверяй с кодом, тестами и конфигурацией. Причины решений ищи в ADR и истории.

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

4. Добавь правила в AGENTS.md

Обнови корневой AGENTS.md, сохранив существующие инструкции; если файла нет — создай. Добавь отдельный раздел «Использование базы знаний» с конкретными правилами:

Перед существенной задачей:

* Прочитать knowledge/index.md.
* Выбрать относящиеся к задаче документы; при необходимости искать по knowledge/ через rg и переходить по ссылкам.
* Не загружать весь корпус без необходимости.
* Проверять status, stale_after и основания verified. Просроченные сведения перепроверять, deprecated учитывать как историю.

Во время работы:

* Сверять критичные утверждения с текущими источниками.
* При расхождении знаний и кода установить, что устарело или нарушено; не выбирать версию автоматически.
* Отделять подтверждённые факты от гипотез.

Перед завершением задачи:

* Оценить, появились ли устойчивые знания: решение, инвариант, ограничение, причина ошибки или проверенная процедура.
* Обновить существующий документ либо создать новый со ссылками на основания.
* При изменении поведения обновить связанные знания в том же PR.
* Поддерживать индекс и внутренние ссылки.
* После существенной правки пересмотреть прежние verified; неподтверждённые сведения оставить черновиком.
* Не сохранять рутинный пересказ сессии и дубликаты.
* В отчёте указать обновлённые документы либо отметить, что обновление знаний не требовалось.

Инструкции harness держи вне OKF bundle. Если другие агенты используют отдельные файлы инструкций, добавь в них ссылку на эти правила без копирования всего раздела.

5. Проверь и заверши

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

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

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