workflow-ai 1.0.41 → 1.0.43

package/src/skills/coach/templates/new-skill.md

@@ -1,137 +0,0 @@
-# Шаблон: Структура нового скила
-
-При создании нового скила создай следующие файлы по этому шаблону.
-
-## SKILL.md
-
-```markdown
----
-name: {skill-name}
-description: >
-  {2-3 предложения: кто агент, что делает, в каком контексте}
-ticket_prefix: {PREFIX}
----
-
-# {Skill Name} — Agent Skill
-
-## Роль
-
-{Конкретное описание роли, контекст, ограничения}
-
-**Ты делаешь:** {перечисление}
-
-**Ты НЕ делаешь:** {перечисление с указанием куда направить}
-
-## Команда / Взаимодействие
-
-{RACI-матрица если применимо, или описание взаимодействий}
-
-## Маршрутизация тикетов {PREFIX}-*
-
-| Тип | Триггеры в тикете | Действие | Воркфлоу |
-|-----|-------------------|----------|----------|
-| **TYPE1** | «ключевые слова» | Описание | → `workflows/type1.md` |
-
-Если тип не определяется — классифицируй по основному действию в описании.
-
-## Загрузка знаний
-
-| Модуль | Когда загружать |
-|--------|----------------|
-| `knowledge/module.md` | Условие |
-
-## Загрузка алгоритмов
-
-| Алгоритм | Когда загружать |
-|----------|----------------|
-| `algorithms/algo.md` | Условие |
-
-## Шаблоны вывода
-
-| Шаблон | Когда использовать |
-|--------|-------------------|
-| `templates/template.md` | Условие |
-
-## Принципы
-
-1. **Принцип 1** — конкретное описание.
-{3-7 принципов}
-
-## Формат вывода
-
-- Язык
-- Стиль
-- Конкретность
-- Actionable
-
-## Границы компетенции
-
-- **Зона X** → куда направить
-```
-
-## Workflow файл
-
-```markdown
-# Воркфлоу: {TYPE} — {Название}
-
-{Одно предложение: что делает этот воркфлоу.}
-
-## Алгоритм выполнения
-
-### 1. {Глагол в повелительном наклонении}
-
-{Пояснение + таблица/список конкретных действий}
-{Ссылки на knowledge/ и algorithms/ где нужны данные}
-
-### 2. ...
-
-### N. Валидация / Чеклист
-
-- [ ] Критерий 1
-- [ ] Критерий 2
-```
-
-## Knowledge файл
-
-```markdown
-# {Название модуля знаний}
-
-{Краткое описание: что содержит и для чего.}
-
-## {Категория 1}
-
-| Параметр | Значение | Описание |
-|----------|----------|----------|
-| ... | ... | ... |
-
-## {Категория 2}
-
-...
-
-<!-- РАСШИРЕНИЕ: добавляй {что именно} ниже -->
-```
-
-## Algorithm файл
-
-```markdown
-# Алгоритм: {Название}
-
-{Одно предложение: для чего этот алгоритм.}
-
-## Вход
-
-{Что подаётся на вход.}
-
-## Алгоритм
-
-### 1. {Шаг}
-...
-
-## Выход
-
-{Что получаем.}
-
-## Пример
-
-{Конкретный пример применения.}
-```

package/src/skills/coach/workflows/analyze.md

@@ -1,85 +0,0 @@
-# Воркфлоу: ANALYZE — Анализ эффективности скила
-
-Анализ работы скила на основе завершённых планов, тикетов и отчётов.
-
-## Алгоритм выполнения
-
-### 0. Загрузка бэклога (ОБЯЗАТЕЛЬНО)
-
-1. Прочитай `.workflow/coach-backlog.yaml`
-2. Выпиши список уже проанализированных `ticket_id` из `analyzed_tickets`
-3. Выпиши список уже внесённых правок из `applied_changes` для целевого скила
-4. **В шаге 1 пропусти тикеты, которые уже в бэклоге**
-5. **В шаге 5 не предлагай правки, которые уже в `applied_changes`**
-
-### 1. Сбор данных
-
-Собери все завершённые артефакты, связанные со скилом.
-**Исключи тикеты, уже присутствующие в бэклоге (`analyzed_tickets`).**
-
-| Источник | Где искать | Что извлечь |
-|----------|-----------|-------------|
-| Завершённые тикеты | `.workflow/tickets/done/` | Результаты, время, качество |
-| Планы | `.workflow/plans/` | Цели, декомпозиция, отклонения |
-| Отчёты | `.workflow/reports/` | Метрики, выводы, проблемы |
-
-Фильтруй по `ticket_prefix` скила.
-
-### 2. Анализ паттернов
-
-**Паттерны успеха:**
-- Какие типы тикетов выполняются хорошо?
-- Какие воркфлоу дают стабильный качественный результат?
-- Какие knowledge-модули используются чаще всего?
-
-**Паттерны проблем:**
-- Какие тикеты завершаются с неполным результатом?
-- Где агент отклоняется от воркфлоу?
-- Какие знания отсутствуют и требуют дополнения?
-- Где агент «додумывает» вместо использования knowledge?
-
-**⚠️ Проверка соответствия процесса (ОБЯЗАТЕЛЬНО для каждого тикета):**
-
-Для каждого анализируемого тикета выполни сверку:
-
-1. Открой SKILL.md анализируемого скила
-2. Найди предписанные **инструменты** (скрипты, API, MCP-серверы) и **шаги workflow**
-3. В тикете найди секции «Agent used», «Что сделано», «Время выполнения»
-4. Сравни: предписанный инструмент == фактически использованный?
-5. Расхождение = **finding**, даже если результат тикета формально ✅ passed
-
-Пример: скил предписывает `perplexity-research.js`, а агент использовал встроенный `web_search` — это нарушение workflow, даже если DoD выполнен. Хороший результат **не маскирует** нарушение процесса.
-
-### 3. Gap-анализ
-
-Применить → `algorithms/gap-analysis.md`
-
-Определи:
-- Типы задач, которые приходят, но не имеют воркфлоу
-- Знания, которые нужны, но отсутствуют в knowledge/
-- Решения, которые принимаются ad-hoc вместо формализованного алгоритма
-
-### 4. Метрики качества
-
-| Метрика | Как считать |
-|---------|------------|
-| Полнота результата | % тикетов с заполненными всеми секциями DoD |
-| Соответствие воркфлоу | % тикетов, где агент следовал шагам воркфлоу |
-| Использование knowledge | Частота обращений к knowledge-модулям |
-| Время выполнения | Среднее время по типам тикетов |
-
-### 5. Формирование выводов
-
-- Топ-3 сильные стороны скила
-- Топ-3 проблемы / узкие места
-- Топ-3 возможности для улучшения
-- Конкретные рекомендации с указанием файлов для изменения
-
-Результат оформи как часть отчёта → `templates/audit-report.md`
-
-### 6. Обновление бэклога (ОБЯЗАТЕЛЬНО)
-
-1. Добавь каждый проанализированный тикет в `analyzed_tickets` бэклога
-2. Если внесены правки — добавь в `applied_changes`
-3. Обнови `last_updated`
-4. Правила формата → `knowledge/backlog-management.md`

package/src/skills/coach/workflows/audit.md

@@ -1,68 +0,0 @@
-# Воркфлоу: AUDIT — Полный аудит скила
-
-Комплексная проверка существующего скила на полноту, качество и актуальность.
-
-## Алгоритм выполнения
-
-### 0. Загрузка бэклога (ОБЯЗАТЕЛЬНО)
-
-1. Прочитай `.workflow/coach-backlog.yaml`
-2. Проверь `audited_skills` — когда последний раз проводился аудит этого скила
-3. Проверь `applied_changes` — какие правки уже внесены после предыдущего аудита
-4. **Учитывай уже внесённые правки** — не отмечай как проблему то, что уже исправлено
-
-### 1. Инвентаризация
-
-Прочитай все файлы скила и составь карту:
-
-| Проверка | Что смотреть |
-|----------|-------------|
-| Структура | Все ли директории и обязательные файлы на месте? |
-| SKILL.md | Все ли секции заполнены? Актуальна ли маршрутизация? |
-| Workflows | Покрыты ли все типы тикетов? Есть ли пробелы? |
-| Knowledge | Актуальны ли знания? Нет ли устаревших данных? |
-| Algorithms | Формализованы ли методы? Есть ли конкретные пороги/формулы? |
-| Templates | Покрыты ли все типы вывода? Консистентны ли форматы? |
-| README | Описывает ли структуру и процесс расширения? |
-
-### 2. Оценка качества
-
-Применить → `algorithms/skill-scoring.md`
-
-Оцени по каждому критерию и выведи итоговый балл.
-
-### 3. Проверка антипаттернов
-
-Загрузи → `knowledge/common-antipatterns.md`
-
-Проверь каждый антипаттерн. Зафиксируй найденные.
-
-### 4. Анализ связности
-
-- Все ли ссылки из SKILL.md ведут на существующие файлы?
-- Все ли файлы в knowledge/ и algorithms/ упомянуты в SKILL.md?
-- Есть ли «осиротевшие» файлы без ссылок?
-- Консистентна ли терминология между файлами?
-
-### 5. Сравнение с эталоном
-
-Загрузи → `knowledge/skill-anatomy.md`
-
-Сравни скил с эталонной структурой. Какие компоненты отсутствуют или неполны?
-
-### 6. Формирование отчёта
-
-Используй шаблон → `templates/audit-report.md`
-
-Результат должен содержать:
-- Общий балл качества
-- Список найденных проблем с приоритетами
-- Конкретные рекомендации по каждой проблеме
-- План улучшений с приоритизацией
-
-### 7. Обновление бэклога (ОБЯЗАТЕЛЬНО)
-
-1. Обнови/добавь запись в `audited_skills` бэклога
-2. Если анализировались тикеты — добавь в `analyzed_tickets`
-3. Обнови `last_updated`
-4. Правила формата → `knowledge/backlog-management.md`

package/src/skills/coach/workflows/create.md

@@ -1,66 +0,0 @@
-# Воркфлоу: CREATE — Создание нового скила
-
-Создание полноценного модульного скила с нуля по запросу.
-
-## Алгоритм выполнения
-
-### 1. Сбор требований
-
-Из тикета извлеки:
-- **Роль** — кем является агент с этим скилом?
-- **Зона ответственности** — что делает и что НЕ делает?
-- **Типы тикетов** — какие задачи будет обрабатывать?
-- **Команда / RACI** — с кем взаимодействует (если применимо)?
-- **Домен знаний** — какая экспертиза нужна?
-
-Если информации недостаточно — сформулируй уточняющие вопросы.
-
-### 2. Исследование домена
-
-- Поищи в интернете лучшие практики и фреймворки для данной роли/домена
-- Изучи существующие скилы в `.workflow/src/skills/` для переиспользования паттернов
-- Определи, какие knowledge-модули можно переиспользовать из других скилов
-
-### 3. Проектирование структуры
-
-Используй эталон → `knowledge/skill-anatomy.md`
-
-Определи:
-
-| Компонент | Что создать |
-|-----------|-------------|
-| **SKILL.md** | Роль, RACI, маршрутизация, принципы, формат вывода |
-| **workflows/** | По одному файлу на каждый тип тикета |
-| **knowledge/** | Экспертные знания домена |
-| **algorithms/** | Формализованные методы принятия решений |
-| **templates/** | Шаблоны вывода для каждого типа результата |
-
-### 4. Создание скила
-
-Создай все файлы по шаблону → `templates/new-skill.md`
-
-**Порядок создания:**
-1. `SKILL.md` — ядро скила
-2. `workflows/` — пошаговые алгоритмы
-3. `knowledge/` — экспертные знания
-4. `algorithms/` — методы принятия решений
-5. `templates/` — шаблоны вывода
-6. `README.md` — документация
-
-### 5. Валидация
-
-Проверь скил по алгоритму → `algorithms/skill-scoring.md`
-
-Критерии:
-- [ ] SKILL.md содержит все обязательные секции
-- [ ] Каждый тип тикета имеет свой воркфлоу
-- [ ] Воркфлоу ссылаются на knowledge и algorithms
-- [ ] Шаблоны вывода покрывают все типы результатов
-- [ ] README.md описывает структуру и расширение
-- [ ] Нет дублирования с существующими скилами
-- [ ] Принципы конкретны и actionable
-
-### 6. Регистрация
-
-- Добавь скил в таблицу в `CLAUDE.md` и `QWEN.md`
-- Убедись что ticket_prefix уникален

package/src/skills/coach/workflows/improve.md

@@ -1,70 +0,0 @@
-# Воркфлоу: IMPROVE — Точечное улучшение скила
-
-Внесение конкретных улучшений в существующий скил на основе аудита, анализа или запроса.
-
-## Алгоритм выполнения
-
-### 0. Загрузка бэклога (ОБЯЗАТЕЛЬНО)
-
-1. Прочитай `.workflow/coach-backlog.yaml`
-2. Проверь `applied_changes` для целевого скила — какие правки уже внесены
-3. **Не вноси повторно правки, которые уже есть в бэклоге**
-4. Учитывай контекст предыдущих улучшений при планировании новых
-
-### 1. Определи scope улучшения
-
-Из тикета извлеки:
-- Какой скил улучшаем?
-- Какая конкретная проблема или потребность?
-- Есть ли ссылка на аудит/анализ с рекомендациями?
-
-### 2. Изучи текущее состояние
-
-Прочитай файлы скила, которые затрагивает улучшение. Пойми текущую логику прежде чем менять.
-
-### 3. Определи тип улучшения
-
-| Тип | Действие |
-|-----|----------|
-| **Новый воркфлоу** | Создай `workflows/new-type.md`, добавь в маршрутизацию SKILL.md |
-| **Новые знания** | Создай/дополни файл в `knowledge/`, добавь в таблицу загрузки |
-| **Новый алгоритм** | Создай `algorithms/new-algo.md`, добавь в таблицу загрузки |
-| **Новый шаблон** | Создай `templates/new-template.md`, укажи в воркфлоу |
-| **Уточнение воркфлоу** | Добавь/исправь шаги в существующем воркфлоу |
-| **Обогащение knowledge** | Дополни существующий файл в knowledge/ после маркера расширения |
-| **Рефакторинг** | Реструктуризация без изменения поведения |
-
-### 4. Исследование (если нужно)
-
-Если улучшение требует новых знаний:
-- Поищи в интернете лучшие практики, фреймворки, методологии
-- Адаптируй найденное под формат knowledge/ или algorithms/
-- Укажи источник
-
-### 5. Внесение изменений
-
-- Следуй принципу минимальных изменений
-- Не ломай существующие ссылки и интеграции
-- Добавляй, а не переписывай (если не рефакторинг)
-- Обнови README.md если структура изменилась
-
-### 6. Валидация
-
-- Проверь все ссылки из SKILL.md
-- Убедись что новые файлы упомянуты в таблицах загрузки
-- Проверь консистентность терминологии
-
-### 7. Документирование
-
-Сформируй план улучшений → `templates/improvement-plan.md` с:
-- Что изменено и почему
-- Какие файлы затронуты
-- Ожидаемый эффект
-- Как проверить результат
-
-### 8. Обновление бэклога (ОБЯЗАТЕЛЬНО)
-
-1. Добавь каждую внесённую правку в `applied_changes` бэклога
-2. Если анализировались тикеты — добавь в `analyzed_tickets`
-3. Обнови `last_updated`
-4. Правила формата → `knowledge/backlog-management.md`

package/src/skills/coach/workflows/research.md

@@ -1,55 +0,0 @@
-# Воркфлоу: RESEARCH — Исследование и поиск знаний
-
-Поиск лучших практик, фреймворков и подходов в интернете для обогащения скилов.
-
-## Алгоритм выполнения
-
-### 1. Определи цель исследования
-
-Из тикета извлеки:
-- Для какого скила ищем знания?
-- Какой домен / тема?
-- Какой тип знаний нужен: методология, метрики, бенчмарки, инструменты?
-
-### 2. Сформулируй поисковые запросы
-
-Составь 3–5 поисковых запросов на русском и английском:
-
-| Тип запроса | Пример |
-|-------------|--------|
-| Лучшие практики | «best practices [domain] framework 2025» |
-| Методологии | «[domain] methodology checklist» |
-| Метрики и бенчмарки | «[domain] KPI benchmarks SaaS» |
-| Инструменты | «[domain] tools stack comparison» |
-| Антипаттерны | «[domain] common mistakes pitfalls» |
-
-### 3. Поиск и фильтрация
-
-- Выполни поиск в интернете
-- Отфильтруй результаты по релевантности и актуальности (приоритет — свежие источники)
-- Извлеки ключевые идеи, фреймворки, чеклисты
-
-### 4. Адаптация под формат скила
-
-Преобразуй найденное в формат модулей скила:
-
-| Найденное | Куда добавить |
-|-----------|--------------|
-| Фреймворк принятия решений | `algorithms/` |
-| Набор метрик или бенчмарков | `knowledge/` |
-| Чеклист или пошаговый процесс | `workflows/` или `knowledge/` |
-| Шаблон документа | `templates/` |
-
-### 5. Интеграция
-
-- Создай или дополни соответствующие файлы в скиле
-- Добавь ссылки в таблицы загрузки SKILL.md
-- Укажи источник информации и дату получения
-
-### 6. Оформление результата
-
-Результат исследования:
-- Краткое резюме найденного
-- Список источников с кратким описанием каждого
-- Конкретные изменения, внесённые в скил
-- Рекомендации для дальнейшего исследования

package/src/skills/coach/workflows/review.md

@@ -1,74 +0,0 @@
-# Воркфлоу: REVIEW — Ревью скила
-
-Быстрое ревью структуры и качества скила с фокусом на конкретные аспекты.
-
-## Алгоритм выполнения
-
-### 0. Загрузка бэклога (ОБЯЗАТЕЛЬНО)
-
-1. Прочитай `.workflow/coach-backlog.yaml`
-2. Проверь `applied_changes` — какие правки уже внесены в целевой скил
-3. **Учитывай контекст предыдущих правок** при формировании замечаний
-
-### 1. Определи фокус ревью
-
-Из тикета извлеки: какой аспект проверить?
-
-| Фокус | Что проверять |
-|-------|--------------|
-| **Структура** | Полнота директорий и файлов, ссылочная целостность |
-| **Качество промптов** | Чёткость инструкций, отсутствие двусмысленности |
-| **Покрытие** | Все ли сценарии обработаны, нет ли пробелов |
-| **Консистентность** | Единообразие терминов, форматов, стиля |
-| **Актуальность** | Не устарели ли знания, бенчмарки, инструменты |
-
-Если фокус не указан — проведи ревью по всем аспектам.
-
-### 2. Чтение и анализ
-
-Прочитай все файлы скила. Для каждого файла проверь:
-
-**SKILL.md:**
-- [ ] Роль описана конкретно (не абстрактно)
-- [ ] RACI / зоны ответственности чёткие
-- [ ] Маршрутизация покрывает все типы тикетов
-- [ ] Таблицы загрузки knowledge и algorithms полны
-- [ ] Принципы actionable, а не декларативные
-- [ ] Формат вывода специфицирован
-
-**Workflows:**
-- [ ] Каждый шаг — конкретное действие (не «подумай»)
-- [ ] Есть ссылки на knowledge/algorithms где нужны данные
-- [ ] Есть критерии завершения / чеклисты
-- [ ] Нет дублирования между воркфлоу
-
-**Knowledge:**
-- [ ] Данные структурированы (таблицы, списки)
-- [ ] Есть маркеры расширения `<!-- РАСШИРЕНИЕ: ... -->`
-- [ ] Нет субъективных оценок без обоснования
-- [ ] Источники указаны где применимо
-
-**Algorithms:**
-- [ ] Алгоритм формализован (шаги, пороги, формулы)
-- [ ] Входные и выходные данные определены
-- [ ] Есть примеры применения
-
-**Templates:**
-- [ ] Все поля обязательны или помечены как опциональные
-- [ ] Формат единообразен с другими шаблонами
-- [ ] Есть placeholder-подсказки
-
-### 3. Формирование замечаний
-
-Для каждого замечания укажи:
-- **Файл и секция** — где проблема
-- **Приоритет** — CRITICAL / HIGH / MEDIUM / LOW
-- **Проблема** — что не так
-- **Рекомендация** — как исправить
-
-### 4. Итоговая оценка
-
-- Общая оценка: READY / NEEDS_WORK / MAJOR_ISSUES
-- Количество замечаний по приоритетам
-- Топ-3 вещи, которые сделаны хорошо
-- Топ-3 вещи, которые нужно исправить

package/src/skills/create-plan/SKILL.md

@@ -1,107 +0,0 @@
----
-name: create-plan
-description: Создать стратегический план для проекта. Используй когда нужно спланировать новую функциональность, проект или задачу. Создаёт файл плана в .workflow/plans/current/ по шаблону со SMART-целями, scope, рисками и критериями успеха.
----
-
-# Создание плана
-
-Этот skill создаёт стратегический план для достижения цели.
-
-## Когда использовать
-
-- Начинается новый проект или крупная задача
-- Нужно переосмыслить направление после отчёта
-- Требуется структурированный план с декомпозицией
-
-## Шаги выполнения
-
-### 1. Изучить контекст
-
-Если есть предыдущие отчёты в `.workflow/reports/`:
-- Прочитай последний отчёт
-- Выдели ключевые проблемы и достижения
-- Учти рекомендации
-
-Если есть активные планы в `.workflow/plans/current/`:
-- Определи связь с новым планом
-
-### 2. Сформулировать SMART-цель
-
-Цель должна быть:
-- **S**pecific — конкретной (что именно)
-- **M**easurable — измеримой (как проверим)
-- **A**chievable — достижимой (реалистичной)
-- **R**elevant — релевантной (зачем нужна)
-- **T**ime-bound — ограниченной во времени
-
-### 3. Определить scope
-
-**Включено:**
-- Что будет сделано
-- Какие результаты ожидаем
-
-**Исключено:**
-- Что НЕ будем делать
-- Ограничения
-
-### 4. Разбить на высокоуровневые задачи
-
-Для каждой задачи укажи:
-- Краткое название
-- Приоритет (1-5, где 1 — критический)
-- Зависимости от других задач
-- Исполнитель (роль из команды)
-- Описание
-
-Задачи должны быть декомпозируемыми. Порядок должен учитывать зависимости.
-
-**Правило назначения исполнителей:**
-Не назначай HUMAN, если агент может выполнить задачу автономно. Агент имеет доступ к:
-- **Playwright MCP-browser** — открывает URL в браузере, включая аутентифицированные сервисы (если сессия активна)
-- **WebSearch / WebFetch** — публичные данные
-- **Файлы проекта** — данные в корне
-
-HUMAN назначается только когда агент **подтверждённо** не может получить доступ (2FA, оплата, физические действия). При неопределённости — назначай агента с `fallback: HUMAN`.
-
-### 5. Определить риски
-
-Для каждого риска:
-- Описание
-- Вероятность (высокая/средняя/низкая)
-- Влияние (высокое/среднее/низкое)
-- Митигация (как предотвратить/решить)
-
-### 6. Записать критерии успеха
-
-Как поймём что план выполнен:
-- Конкретные результаты
-- Метрики
-- Проверяемые условия
-
-### 7. Сохранить план
-
-1. Прочитай шаблон: `.workflow/templates/plan-template.md`
-2. Определи следующий ID: найди все файлы `PLAN-*.md` в `.workflow/plans/` (рекурсивно), возьми максимальный номер и прибавь 1. Если файлов нет — начни с `PLAN-001`.
-3. Сохрани в: `.workflow/plans/current/PLAN-{NNN}.md`
-
-## Пример использования
-
-```
-Создай план для системы авторизации.
-Контекст: Python, FastAPI, PostgreSQL. Срок: 2 недели.
-Требования: JWT токены, refresh токены, роли пользователей.
-```
-
-## Результат
-
-Файл `.workflow/plans/current/PLAN-001.md` с:
-- Целью и контекстом
-- Scope (включено/исключено)
-- Высокоуровневыми задачами
-- Рисками и митигацией
-- Критериями успеха
-
-## Связанные skills
-
-- `analyze-report` — анализ отчётов перед планированием
-- `decompose-plan` — декомпозиция плана на тикеты