Go to file
Витковских Евгений Юрьевич 0683962cd2 README: формат карточек статистики kit-dev-flow и петля опыта 2026-11-05 14:03:38 +05:00
README.md README: формат карточек статистики kit-dev-flow и петля опыта 2026-11-05 14:03:38 +05:00

README.md

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

---
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:

{
  "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-задачей или при замыкании итерации).