feat(skills): wiki bucket sources/ → summaries/ — mappa-knowledge, project-bootstrap, using-markitdown, using-projects-meta (+README) (решение 2026-08-24)

This commit is contained in:
2026-08-25 13:52:56 +03:00
parent 0ed7060116
commit 805077902d
5 changed files with 24 additions and 24 deletions

View File

@@ -1,7 +1,7 @@
---
name: mappa-knowledge
author: ours
version: 1.3.0
version: 1.4.0
description: >
Цикл работы со знаниями проекта в Mappa (Karpathy LLM Wiki, канал =
mappa-сущности): ingest → query → lint + граф-слой для
@@ -42,7 +42,7 @@ README/ADR (не персистентная база знаний), проект
## Три слоя (не смешивать)
1. **Raw-источники**`sources/<slug>` страницы. Иммутабельны: читай, не
1. **Raw-источники**`summaries/<slug>` страницы. Иммутабельны: читай, не
редактируй (единственное исключение — блок-цитата `> Status` по явной
просьбе пользователя).
2. **Вики** — остальные страницы (entities/concepts/packages/contradictions/open-questions/overview).
@@ -101,7 +101,7 @@ per-type рефы полными именами (`[[task:N]]`/`[[inbox:N]]`).
1. Прочитай источник полностью.
2. Извлеки: entities, concepts, packages, кросс-резы.
3. Создай `sources/<slug>` — одну страницу-резюме на источник (~50150 строк;
3. Создай `summaries/<slug>` — одну страницу-резюме на источник (~50150 строк;
ссылку на raw клади в frontmatter `raw_path` + `ingested:`).
4. Для каждой затронутой страницы:
- есть → обнови (`wiki_update(project, id, body, version)` — version свежая
@@ -195,7 +195,7 @@ updated: 2026-08-24
---
```
Страницы `sources/` дополнительно несут `ingested: YYYY-MM-DD` и `raw_path: …`.
Страницы `summaries/` дополнительно несут `ingested: YYYY-MM-DD` и `raw_path: …`.
`contradictions/``status: open | resolved | accepted-divergence` и `affects:`.
`open-questions/``status: open | answered | obsolete` и `touches:`.
@@ -203,7 +203,7 @@ updated: 2026-08-24
- `kebab-case`, **только латиница**. Кириллицу/др. скрипты транслитерируй
(`план переписывания``ozon-client-rewrite`). Оригинальный title — в H1 и frontmatter.
- `entities/<name>`, `concepts/<name>`, `packages/<name>`, `sources/<slug>`,
- `entities/<name>`, `concepts/<name>`, `packages/<name>`, `summaries/<slug>`,
`contradictions/<slug>`, `open-questions/<slug>`.
### Оп-лог — таблица `logs`, не страница
@@ -224,7 +224,7 @@ level/since/component/entity, retention 14d). Ручную `log`-страниц
| Ситуация | Что трогаем |
|---|---|
| Ingest одного документа | `sources/<slug>` (новая) + 315 entities/concepts/packages (+ опционально `index`) |
| Ingest одного документа | `summaries/<slug>` (новая) + 315 entities/concepts/packages (+ опционально `index`) |
| Query | (чтение) + возможно новая страница |
| Query реляционный | graph_* (BFS), не чтение |
| Lint | (чтение) + graph_backlinks/stats для сирот |
@@ -232,8 +232,8 @@ level/since/component/entity, retention 14d). Ручную `log`-страниц
## Частые ошибки
- **Правка `sources/`.** Нельзя. Только статус-блок по явной просьбе.
- **Дамп сырья в `sources/`.** Резюме — это резюме. Ссылайся на raw, не копируй.
- **Правка `summaries/`.** Нельзя. Только статус-блок по явной просьбе.
- **Дамп сырья в `summaries/`.** Резюме — это резюме. Ссылайся на raw, не копируй.
- **Молчаливые перезаписи.** Новый источник противоречит странице — пометь
блоком `> **Противоречие:**`; не затирай.
- **Нарративный оп-лог.** Не веди его руками: сервис пишет logs сам (admin.logs).
@@ -253,7 +253,7 @@ level/since/component/entity, retention 14d). Ручную `log`-страниц
## Red flags
- Реляционный вопрос → читаешь страницу вместо `graph_*`.
- Правка `sources/` или молчаливая перезапись противоречия.
- Правка `summaries/` или молчаливая перезапись противоречия.
- Wiki-мутация update без version (last-write-wins) или create с выдуманным claim.
- Нарративный оп-лог руками.