feat(P1): новый LLM-промпт для документации — правила A-E

- value_list → читаемый текст (Допустимые значения)
- regex → описание формата
- пустые описания → заполнять из MAN
- группы map-fixed → 1 предложение о содержимом
- операции без описания → шаблоны
- MAN-контекст для params/ops файлов
- max_tokens 4096 → 8192
- вывод в docs_llm/ вместо перезаписи docs/
This commit is contained in:
“Naeel”
2026-08-09 21:11:03 +04:00
parent ac2ce0ea53
commit c9a881aa84
8 changed files with 696 additions and 48 deletions
+35
View File
@@ -0,0 +1,35 @@
# Sonnet: финальный план P1 — 05_generate_docs_llm.py
## Пайплайн на один сервис
```
docs/Name.md ─┐
docs/Name_params_create.md ─┤ LLM → docs_llm/Name.md
docs/Name_params_modify.md ─┤ docs_llm/Name_params_create.md
docs/Name_ops.md ─┤ docs_llm/Name_params_modify.md
docs/Name_example.md ─┘ docs_llm/Name_ops.md
docs_llm/Name_example.md
docs/Name_outputs.md ─── copy → docs_llm/Name_outputs.md
docs/Name_params.md ─── copy → docs_llm/Name_params.md
docs/Name_subresource*.md ─── copy → docs_llm/Name_subresource*.md
```
## Ключевые детали
### MAN-контекст
- Извлекается из `docs/Name.md` (raw HTML) функцией `extract_man()`
- Передаётся в том же сообщении что и params/ops файлы
- Для главной страницы (Name.md) и примеров (_example.md) — без MAN
### Параметры LLM
- `max_tokens`: 4096 → **8192**
- `temperature`: 0.15 (без изменений)
- `model`: gpt-oss-120b (без изменений)
### Интеграция с 04_build_and_publish_docs.sh
Вариант A: DOCS_GEN_DIR → `docs_llm/`. Скрипт копирует guides/, 30_registry/, index.md в docs_llm/.
## Вопрос: subresource-страницы обрабатывать LLM?
postgres_user.md, postgres_database.md, postgres_backup.md — их структура как у _params_create.md.
Пока копировать as-is или тоже через LLM?