Скил dream — обслуживание базы знаний
Как скил dream в Datarim поддерживает директорию datarim/ в порядке: находит артефакты на неправильных местах, отмечает противоречия, дедублирует контент и перестраивает индекс.
База знаний, растущая задача за задачей, склонна к дрейфу. Артефакты попадают не в ту директорию. Файлы теряют перекрёстные ссылки. Два документа в итоге описывают одно и то же. Скил dream занимается делопроизводством, которое не позволяет этому накоплению ухудшать качество будущих задач.
Скил работает с директорией datarim/ и documentation/archive/. Исходный код не трогает. Ничего не удаляет без одобрения. Не создаёт новые знания — это работа писателя.
Три операции
Ingest обрабатывает новые артефакты. Проверяет, что каждый файл находится в правильной директории, содержит идентификатор задачи в имени файла, имеет frontmatter и ссылки на связанные документы. Архивный файл без соответствующей записи рефлексии, или рефлексия без соответствующего архива, появляется как находка ingest.
Lint запускает проверку состояния всей базы знаний. Ищет противоречия — два документа с конфликтующими утверждениями по одной теме — и помечает оба выноской, не перезаписывая ни один из них. Также отмечает файлы-сироты без входящих ссылок, битые ссылки, документы длиннее 500 строк, которые следует разделить, и архивные записи в неправильной поддиректории области. Всё попадает в отчёт lint, сгруппированный по критичности: критично, предупреждение, информация.
Consolidate выполняет более глубокую работу: объединяет дублирующиеся документы, извлекает повторяющиеся паттерны из рефлексий на отдельную страницу паттернов, перестраивает индекс и добавляет двунаправленные ссылки между связанными артефактами. Консолидация не запускается автоматически — она требует явной команды.
Один конкретный пример
После десяти задач каталог datarim/index.md устарел — в нём перечислены документы шестимесячной давности и нет пятнадцати более новых артефактов. Запуск /dr-dream index перестраивает каталог: каждый документ в datarim/ и documentation/archive/ получает однострочную запись, сгруппированную по типу. Результат — навигируемый каталог, а не плоский список файлов.
Когда запускается dream
/dr-dream без аргументов запускает все три операции последовательно. Целевые варианты — /dr-dream lint и /dr-dream index — выполняют только указанную операцию. После каждой десятой завершённой задачи фреймворк предлагает полный проход обслуживания; после любого архива с более чем пятью неиндексированными документами — перестройку индекса. Ни одно из предложений не выполняется без явной команды оператора.
Активность добавляется в datarim/history/activity-log.md, создавая датированную запись каждого прохода обслуживания и его результатов.
Смотрите также: пост о команде /dr-dream для пошагового обзора и пост что такое Datarim для общей картины.