“Naeel”
c9a881aa84
- value_list → читаемый текст (Допустимые значения) - regex → описание формата - пустые описания → заполнять из MAN - группы map-fixed → 1 предложение о содержимом - операции без описания → шаблоны - MAN-контекст для params/ops файлов - max_tokens 4096 → 8192 - вывод в docs_llm/ вместо перезаписи docs/
33 lines
1.4 KiB
Markdown
33 lines
1.4 KiB
Markdown
# Документация — финальный план P1 (утверждён)
|
|
|
|
Дата: 2026-08-09
|
|
Источник: Sonnet, после серии брифов и уточнений
|
|
|
|
## Что меняется в 05_generate_docs_llm.py
|
|
|
|
### 1. SYSTEM_PROMPT — замена
|
|
Новый промпт с правилами A-E (см. HISTORY/SONNET/docs_prompt_full_response.md)
|
|
|
|
### 2. max_tokens: 4096 → 8192
|
|
|
|
### 3. Новая функция extract_man(text) → str
|
|
Вырезает блок ## MAN из Name.md. Используется как контекст для params/ops.
|
|
|
|
### 4. Новая функция build_prompt(file_type, filename, content, man) → str
|
|
Формирует сообщение для LLM: тип файла + MAN-контекст + содержимое.
|
|
|
|
### 5. Обработка ВСЕХ типов файлов
|
|
Было: только Name.md
|
|
Стало: Name.md, _params_create.md, _params_modify.md, _ops.md, _example.md
|
|
MAN-контекст: для params и ops, без MAN для главной и примеров.
|
|
|
|
### 6. Копирование в docs_llm/
|
|
- outputs, params-landing, subresource — копировать as-is
|
|
- 30_registry/, guides/, index.md — копировать из docs/
|
|
|
|
### Решения
|
|
- Subresource: копировать as-is (не через LLM)
|
|
- max_tokens: 8192
|
|
- Вывод: docs_llm/
|
|
- 30_registry копировать в самом скрипте
|