DB.FlowExp_WorkStatistics/README.md

70 lines
3.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# DB.FlowExp_WorkStatistics — общая статистика применения навыка kit-dev-flow
Единое хранилище опыта работы навыка `kit-dev-flow` (плагин kit-knowledge,
маркетплейс dev-sys-qa-interactive): карточки прогонов workflow по **всем
проектам**, где навык применялся. Данные пишутся навыком автоматически —
действий разработчика не требуется.
## Как работает петля
```
прогон workflow → карточка (авто: commit + push) → агрегаты flow_stats.py
↑ ↓
└──── промпты субагентов следующего шага ← навык читает перед шагом
```
- **После каждого прогона** навык: метрики из отчёта рана ZCode → карточка
→ `git add + commit + push` (remote недоступен — карточка копится в
локальном клоне и уезжает со следующим успешным пушем).
- **Перед планированием шага** навык: `git pull` → агрегаты по классу шага
по всем проектам → удачные приёмы в промпты, неудачные исключаются,
выбор формы (пресет/генерация) — по фактической статистике.
## Формат карточки
Путь: `runs/<год>/<дата>-<проект>-<шаг>-<hash>.md`
```markdown
---
date: 2026-11-05 14:30
project: kit-rag
step: 7.4 этап 2
kind: db # документ | требования | архитектура | db | этап-модуля
form: preset # preset | generated
preset: kit-dev-process
model: GLM-5.3-Flash
agents: 6
revisions: 2
escalations: 1
result: success # success | partial | fail
duration_min: 45
run_id: dwfrun-...
---
## Что делали
…
## Уроки (что учесть в следующий раз)
- …
```
Имена файлов уникальны (дата+проект+шаг+hash) — параллельная запись
нескольких разработчиков конфликтов не создаёт.
## Подключение (однократно на машину)
В `~/.zcode/kit-knowledge.json`:
```json
{
"flow_exp_dir": "I:\\Kit\\DB.FlowExp_WorkStatistics",
"flow_exp_remote": "https://git.mind01.ru/DB/DB.FlowExp_WorkStatistics.git"
}
```
Нет локального клона — навык склонирует по `flow_exp_remote` сам.
## Сводка
`_summary.md` — агрегированный отчёт за период (генерируется
`flow_stats.py` из плагина kit-knowledge; обновляется вручную, cron-задачей
или при замыкании итерации).