Dmitry
22eda53d79
Affected files: .obsidian/graph.json 99 System/INDEX.md 99 System/Tools/agent-tools/AGENT_TOOLS.md 99 System/Tools/agent-tools/vault_audit.py 99 System/Tools/agent-tools/vault_common.py 99 System/Tools/agent-tools/vault_frontmatter.py 99 System/Tools/agent-tools/vault_index.py 99 System/Tools/agent-tools/vault_ingest.py AGENTS.md
58 lines
2.7 KiB
Markdown
58 lines
2.7 KiB
Markdown
---
|
|
title: Agent tools для vault
|
|
status: stable
|
|
type: guide
|
|
tags: [agent, tooling, vault]
|
|
created: 2026-06-16
|
|
updated: 2026-06-16
|
|
aliases: []
|
|
---
|
|
|
|
# Agent tools для vault
|
|
|
|
Набор утилит для ИИ-агентов. Вывод — JSON, чтобы агент мог читать результат без парсинга Markdown-таблиц.
|
|
|
|
Запускать из корня vault:
|
|
|
|
```bash
|
|
python3 "99 System/Tools/agent-tools/vault_index.py" dump
|
|
```
|
|
|
|
## Команды
|
|
|
|
### `vault_index.py`
|
|
|
|
- `dump` — вывести все заметки из vault как JSON.
|
|
- `query --term "CI/CD" --limit 10` — найти близкие заметки.
|
|
- `rebuild` — пересобрать `99 System/INDEX.md`. Это write-команда.
|
|
|
|
### `vault_ingest.py`
|
|
|
|
- `scan` — показать файлы из `00 Inbox/` и `01 Ideas/`.
|
|
- `classify PATH` — эвристически классифицировать источник.
|
|
- `plan PATH` — выдать JSON-план ingest: назначение, похожие заметки, возможные wikilinks.
|
|
|
|
Команды read-only. Они не заменяют обязательный план и подтверждение перед workflow.
|
|
|
|
### `vault_audit.py`
|
|
|
|
- `broken-links` — найти wikilinks на несуществующие заметки.
|
|
- `orphans` — найти заметки без входящих ссылок.
|
|
- `source-links` — проверить wikilinks в `source`.
|
|
- `components` — найти компоненты графа ссылок.
|
|
- `all` — выполнить все проверки.
|
|
|
|
Команды read-only.
|
|
|
|
### `vault_frontmatter.py`
|
|
|
|
- `check [PATH ...]` — проверить обязательные поля и допустимые `status/type`.
|
|
- `normalize PATH ...` — нормализовать frontmatter выбранных файлов. Это write-команда.
|
|
|
|
## Правила для агентов
|
|
|
|
- Перед `ingest`, `wiki`, `audit`, `remind`, `query` сначала читать `99 System/INDEX.md`; скрипты помогают, но не отменяют правила `AGENTS.md`.
|
|
- Write-команды запускать только когда workflow уже подтверждён пользователем или правило явно требует обновить индекс.
|
|
- `vault_ingest.py plan` — вспомогательный план, не окончательное решение. Агент обязан проверить содержимое источника сам.
|
|
- После создания, удаления, перемещения заметки или изменения frontmatter запускать `vault_index.py rebuild`.
|