feat(skills): wiki bucket sources/ → summaries/ — mappa-knowledge, project-bootstrap, using-markitdown, using-projects-meta (+README) (решение 2026-08-24)
This commit is contained in:
@@ -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>` — одну страницу-резюме на источник (~50–150 строк;
|
||||
3. Создай `summaries/<slug>` — одну страницу-резюме на источник (~50–150 строк;
|
||||
ссылку на 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>` (новая) + 3–15 entities/concepts/packages (+ опционально `index`) |
|
||||
| Ingest одного документа | `summaries/<slug>` (новая) + 3–15 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.
|
||||
- Нарративный оп-лог руками.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user