workflow-ai 1.0.0

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

@@ -0,0 +1,156 @@
+---
+name: create-report
+description: Сформировать отчёт о выполненных задачах. Используй по завершении итерации для документирования прогресса. Собирает информацию из done/ тикетов и создаёт отчёт в .workflow/reports/.
+---
+
+# Создание отчёта
+
+Этот skill формирует отчёт о выполненных задачах на основе завершённых тикетов.
+
+## Когда использовать
+
+- Завершилась итерация работ
+- Накопились выполненные задачи в done/
+- Нужно зафиксировать прогресс
+- Перед принятием решений о следующих шагах
+
+## Шаги выполнения
+
+### 1. Собрать информацию
+
+Прочитать все тикеты из:
+- `.workflow/tickets/done/` — выполненные
+- `.workflow/tickets/blocked/` — заблокированные
+- `.workflow/tickets/in-progress/` — в работе
+
+### 1.5. Проверка аномалий: in-progress тикеты с заполненным результатом
+
+**Важно:** Перед формированием отчёта проверить in-progress тикеты на наличие заполненных результатов.
+
+**Автоматическая проверка (рекомендуется):**
+
+Использовать скрипт `.workflow/src/scripts/check-anomalies.js`:
+
+```bash
+node .workflow/src/scripts/check-anomalies.js
+```
+
+Скрипт выводит результат в формате:
+```
+---RESULT---
+status: ok|anomalies_found|error
+anomalies_count: N
+anomalies: [{"id": "IMPL-001", "title": "...", "recommendation": "..."}]
+---RESULT---
+```
+
+**Ручная проверка (если скрипт недоступен):**
+
+Для каждого тикета в `.workflow/tickets/in-progress/`:
+1. Прочитать содержимое файла
+2. Найти раздел `## Результат выполнения` (или `## Result`)
+3. Проверить подраздел `### Summary` (или `### Что сделано`)
+4. Если подраздел содержит непустой текст (не только `<!-- ... -->` комментарии) — это аномалия
+
+**Критерии заполнения:**
+- Раздел содержит текст, отличный от шаблонов `<!-- ... -->`
+- Есть конкретное описание выполненной работы
+- Указаны изменённые файлы или конкретные результаты
+
+**Действия при обнаружении аномалии:**
+- Добавить тикет в секцию "Аномалии" отчёта
+- Указать рекомендацию: "Проверьте тикет и переместите в done/ или review/ если выполнен"
+
+### 2. Определить период
+
+```
+Период: от последнего отчёта до сейчас
+
+Если отчётов нет — от создания первого тикета
+```
+
+### 3. Для каждой выполненной задачи
+
+Извлечь:
+- ID и название
+- Время выполнения (created_at → completed_at)
+- Результат (из секции Result)
+- Проблемы (если были)
+
+### 4. Сформировать статистику
+
+```
+Выполнено: N задач
+В работе: M задач
+Заблокировано: K задач
+В очереди: L задач
+
+По типам:
+- IMPL: X
+- FIX: Y
+- DOCS: Z
+```
+
+### 5. Выделить проблемы и аномалии
+
+**Проблемы:**
+
+Для каждой заблокированной задачи:
+- Причина блокировки
+- Как разблокировать
+
+Для задач с problems:
+- Описание проблемы
+- Как была решена
+
+**Аномалии:**
+
+Если на шаге 1.5 найдены in-progress тикеты с заполненным результатом:
+- Создать подсекцию "Аномалии"
+- Для каждого тикета указать:
+  - ID и название
+  - Рекомендацию: "Проверьте тикет и переместите в done/ или review/ если выполнен"
+
+### 6. Связать с планом
+
+Если есть активный план:
+- Какой процент выполнен
+- Какие задачи из плана закрыты
+- Что осталось
+
+### 7. Сохранить отчёт
+
+1. Прочитай шаблон: `.workflow/templates/report-template.md`
+2. Определи следующий ID: найди все файлы `REPORT-*.md` в `.workflow/reports/`, возьми максимальный номер и прибавь 1. Если файлов нет — начни с `REPORT-001`.
+3. Сохрани в: `.workflow/reports/REPORT-{NNN}.md`
+
+### 8. Вывести структурированный результат
+
+После сохранения **обязательно** выведи блок результата:
+
+```
+---RESULT---
+status: default
+report_id: REPORT-001
+---RESULT---
+```
+
+## Пример использования
+
+```
+Создай отчёт о выполненных задачах за последнюю неделю.
+```
+
+## Результат
+
+Файл `.workflow/reports/REPORT-001.md` содержащий:
+- Период отчёта
+- Список выполненных задач с результатами
+- Статистику
+- Проблемы и их решения
+- Прогресс по плану
+
+## Связанные skills
+
+- `analyze-report` — анализ отчёта
+- `create-plan` — создание плана на основе выводов

package/src/skills/decompose-gaps/SKILL.md

@@ -0,0 +1,122 @@
+---
+name: decompose-gaps
+description: Декомпозировать недочёты (gaps) из анализа отчёта в новые тикеты. Используй после analyze-report когда план выполнен не полностью. Создаёт тикеты в .workflow/tickets/backlog/ на основе выявленных пробелов, а не на основе исходного плана.
+---
+
+# Декомпозиция недочётов в тикеты
+
+Этот skill создаёт новые тикеты на основе **недочётов (gaps)**, выявленных при анализе отчёта. В отличие от `decompose-plan`, он работает не с исходным планом, а с конкретными пробелами — что не было сделано, что сделано некорректно, что требует доработки.
+
+## Когда использовать
+
+- Анализ отчёта выявил пробелы (`status: has_gaps`)
+- Нужно создать точечные задачи на доработку
+- Требуется закрыть конкретные недочёты, а не декомпозировать весь план заново
+
+## Входные данные (из context)
+
+| Параметр | Описание |
+|----------|----------|
+| `gaps` | Описание недочётов из analyze-report |
+| `report_id` | ID отчёта, в котором выявлены недочёты |
+| `plan_id` | ID исходного плана (для ссылки) |
+
+## Шаги выполнения
+
+### 1. Прочитать описание недочётов
+
+Из context-переменной `gaps` извлечь:
+- Какие задачи не были выполнены
+- Какие результаты не соответствуют ожиданиям
+- Какие доработки требуются
+
+### 2. Прочитать отчёт для полного контекста
+
+```
+Путь: .workflow/reports/REPORT-{report_id}.md
+```
+
+Извлечь:
+- Что было выполнено (для понимания текущего состояния)
+- Какие проблемы возникли
+- Какие файлы были затронуты
+
+### 3. Прочитать исходный план (опционально)
+
+```
+Путь: .workflow/plans/current/PLAN-{plan_id}.md
+```
+
+Сверить gaps с исходными требованиями плана, чтобы понять:
+- Задача была пропущена или выполнена некорректно?
+- Нужна доработка или переделка?
+
+### 4. Для каждого gap создать тикет
+
+Каждый gap → 1 или несколько тикетов.
+
+Критерии хорошего тикета на доработку:
+- **Точечный** — исправляет конкретный недочёт, а не переделывает всё
+- **Атомарный** — одна конкретная работа
+- **С контекстом** — ссылается на отчёт и исходную задачу
+- **Выполнимый** — понятно что делать без дополнительных вопросов
+
+### 5. Определить тип каждого тикета
+
+| Тип | Префикс | Когда использовать |
+|-----|---------|-------------------|
+| Исправление | FIX | Результат не соответствует ожиданиям |
+| Реализация | IMPL | Задача была пропущена |
+| Ревью | REVIEW | Нужна дополнительная проверка |
+| Документация | DOCS | Не хватает документации |
+
+### 6. Назначить приоритеты
+
+Приоритеты для тикетов-доработок обычно выше, чем для обычных задач:
+
+| Приоритет | Значение |
+|-----------|----------|
+| 1 | Critical — блокирует завершение плана |
+| 2 | High — важный пробел |
+| 3 | Medium — мелкий недочёт |
+
+### 7. Создать тикеты
+
+1. Прочитай шаблон: `.workflow/templates/ticket-template.md`
+2. Для каждого тикета:
+   - Определи следующий ID: найди все файлы `{TYPE}-*.md` во всех папках `.workflow/tickets/`, возьми максимальный номер для этого префикса и прибавь 1. Если файлов нет — начни с `{TYPE}-001`.
+   - Заполни шаблон
+   - В описании укажи: `Доработка по результатам REPORT-{report_id}`
+   - Сохрани в `.workflow/tickets/backlog/{TYPE}-{NNN}.md`
+
+### 8. Вывести структурированный результат
+
+После создания тикетов **обязательно** выведи блок результата:
+
+```
+---RESULT---
+status: default
+created_tickets: IMPL-010, FIX-011
+---RESULT---
+```
+
+## Пример использования
+
+```
+Декомпозируй недочёты в новые тикеты.
+
+Context:
+  gaps: Не реализована валидация входных данных; отсутствует обработка ошибок в runner.mjs
+  report_id: REPORT-003
+  plan_id: PLAN-006
+```
+
+## Результат
+
+- Новые тикеты в `.workflow/tickets/backlog/`
+
+## Связанные skills
+
+- `analyze-report` — предшествующий шаг, выявляет gaps
+- `check-conditions` — следующий шаг, проверяет готовность новых тикетов
+- `decompose-plan` — похожий skill, но для декомпозиции всего плана

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

@@ -0,0 +1,109 @@
+---
+name: decompose-plan
+description: Декомпозировать план на исполняемые тикеты. Используй после создания плана для разбиения высокоуровневых задач на конкретные тикеты с зависимостями и условиями. Создаёт тикеты в .workflow/tickets/backlog/.
+---
+
+# Декомпозиция плана на тикеты
+
+Этот skill разбивает высокоуровневый план на исполняемые тикеты для канбан-доски.
+
+## Когда использовать
+
+- Создан новый план
+- Нужно разбить крупную задачу на подзадачи
+- Требуется детальная декомпозиция
+
+## Шаги выполнения
+
+### 1. Прочитать план
+
+```
+Путь: .workflow/plans/current/PLAN-{NNN}.md
+```
+
+Извлечь:
+- Список высокоуровневых задач
+- Зависимости между ними
+- Приоритеты
+- Контекст проекта
+
+### 2. Для каждой задачи определить тикеты
+
+Каждая задача из плана может превратиться в 1+ тикетов.
+
+Критерии хорошего тикета:
+- Атомарный (одна конкретная работа)
+- Выполнимый за 1-4 часа
+- Имеет чёткие критерии готовности
+- Понятно что делать без дополнительных вопросов
+
+### 3. Определить тип каждого тикета
+
+| Тип | Префикс | Описание |
+|-----|---------|----------|
+| Архитектура | ARCH | Создание планов, архитектуры |
+| Реализация | IMPL | Написание кода |
+| Исправление | FIX | Багфиксы |
+| Ревью | REVIEW | Проверка кода/документации |
+| Документация | DOCS | Написание документации |
+| Администрирование | ADMIN | Настройка, конфигурация |
+
+### 4. Определить зависимости
+
+Для каждого тикета:
+- От каких тикетов зависит (`dependencies`)
+- Какие условия должны быть выполнены (`conditions`)
+
+Типы условий:
+- `tasks_completed: [IMPL-001, IMPL-002]` — задачи должны быть выполнены
+- `date_after: "2024-01-15"` — не раньше даты
+- `file_exists: "src/config.py"` — файл должен существовать
+- `manual_approval: true` — требуется одобрение человека
+
+### 5. Назначить приоритеты
+
+| Приоритет | Значение |
+|-----------|----------|
+| 1 | Critical — блокирует всё |
+| 2 | High — важно для прогресса |
+| 3 | Medium — стандартная работа |
+| 4 | Low — можно отложить |
+| 5 | Someday — когда-нибудь |
+
+### 6. Создать тикеты
+
+1. Прочитай шаблон: `.workflow/templates/ticket-template.md`
+2. Для каждого тикета:
+   - Определи следующий ID: найди все файлы `{TYPE}-*.md` во всех папках `.workflow/tickets/`, возьми максимальный номер для этого префикса и прибавь 1. Если файлов нет — начни с `{TYPE}-001`.
+   - Заполни шаблон
+   - Сохрани в `.workflow/tickets/backlog/{TYPE}-{NNN}.md`
+
+### 7. Обновить план
+
+Добавь в план ссылки на созданные тикеты.
+
+### 8. Вывести структурированный результат
+
+После создания тикетов **обязательно** выведи блок результата:
+
+```
+---RESULT---
+status: default
+---RESULT---
+```
+
+## Пример использования
+
+```
+Декомпозируй план .workflow/plans/current/PLAN-001.md на тикеты.
+```
+
+## Результат
+
+- Тикеты в `.workflow/tickets/backlog/`
+- Обновлённый план с ссылками на тикеты
+
+## Связанные skills
+
+- `create-plan` — создание плана для декомпозиции
+- `check-conditions` — проверка готовности тикетов

package/src/skills/execute-task/SKILL.md

@@ -0,0 +1,117 @@
+---
+name: execute-task
+description: Выполнить задачу из тикета. Используй когда нужно выполнить конкретный тикет из in-progress. Читает описание задачи, выполняет работу, записывает результат. Перемещение в done/blocked выполняется отдельным stage.
+---
+
+# Выполнение задачи
+
+Этот skill выполняет задачу из тикета и записывает результат.
+
+## Когда использовать
+
+- Есть тикет в `in-progress/`
+- Нужно выполнить конкретную задачу
+- Перемещение в done/blocked будет выполнено отдельным stage пайплайна
+
+## Шаги выполнения
+
+### 1. Прочитать тикет
+
+ID тикета передаётся в промпте как `ticket_id` в секции Context.
+
+```
+Путь: .workflow/tickets/ready/{TICKET-ID}.md
+```
+
+**Важно:** НЕ перемещай тикет — он остаётся в `ready/` на время выполнения. Перемещение выполняется отдельным stage пайплайна.
+
+Извлечь:
+- Описание задачи
+- Критерии готовности (Definition of Done)
+- Контекст (файлы, ссылки, заметки)
+
+### 2. Понять задачу
+
+Убедиться что понятно:
+- Что нужно сделать
+- Какой результат ожидается
+- Какие есть ограничения
+
+Если не хватает информации:
+- Создать подзадачу на уточнение
+- Или вывести `status: blocked` в блоке результата (перемещение выполнит pipeline)
+
+### 3. Выполнить работу
+
+В зависимости от типа задачи:
+
+| Тип | Действия |
+|-----|----------|
+| IMPL | Написать код |
+| FIX | Исправить баг |
+| DOCS | Написать документацию |
+| REVIEW | Проверить код/документы |
+| PLAN | Создать план |
+| ADMIN | Выполнить настройку |
+
+### 4. Проверить критерии готовности
+
+Для каждого критерия из Definition of Done:
+- Выполнен ли он?
+- Если нет — что нужно доделать?
+
+### 5. Записать результат
+
+Добавить в тикет секцию Result:
+
+```markdown
+## Result
+
+### Что сделано
+- ...
+
+### Изменённые файлы
+- ...
+
+### Заметки
+- ...
+```
+
+### 6. Перемещение выполняется отдельным stage
+
+**Важно:** Этот skill НЕ перемещает тикет. НЕ выполняй никаких операций с файлами тикетов кроме записи результата.
+
+Запрещено:
+- Перемещать файл тикета в другую папку
+- Обновлять `status` в frontmatter
+- Добавлять `completed_at`
+- Вызывать `move-ticket.js` вручную
+
+Всё это выполняется автоматически скриптом перемещения на следующем stage пайплайна.
+
+### 7. Вывести структурированный результат
+
+После выполнения **обязательно** выведи блок результата:
+
+```
+---RESULT---
+status: default
+---RESULT---
+```
+
+## Пример использования
+
+```
+Выполни задачу .workflow/tickets/in-progress/IMPL-001.md
+```
+
+## Результат
+
+- Выполненная работа (код, документация и т.д.)
+- Обновлённый тикет с секцией Result
+- Тикет остаётся в `ready/` (перемещение выполняется отдельным stage)
+
+## Связанные skills
+
+- `check-conditions` — после выполнения проверить зависимые задачи
+- `create-report` — включить результат в отчёт