workflow-ai 1.0.0

package/src/skills/review-result/SKILL.md

@@ -0,0 +1,274 @@
+---
+name: review-result
+description: Проверить результат выполнения задачи на соответствие Definition of Done. Используется после execute-task для валидации качества работы.
+---
+
+# Проверка результата (Review Result)
+
+Этот skill проверяет результат выполнения задачи на соответствие критериям готовности (Definition of Done) из тикета.
+
+## Когда использовать
+
+- Задача выполнена и тикет перемещён в `review/`
+- Требуется валидация качества перед перемещением в `done/`
+- Retry-логика пайплайна: определить status для goto-перехода
+
+## Шаги проверки
+
+### 0. Проверить наличие предыдущего успешного ревью
+
+**До любых проверок** найди в тикете секцию `## Ревью`.
+
+Если секция существует и содержит запись со статусом `passed` (в виде `✅ passed` или просто `passed`) — ревью уже пройдено успешно ранее. Немедленно верни результат без выполнения дальнейших проверок:
+
+```
+---RESULT---
+status: passed
+issues: []
+---RESULT---
+```
+
+> Логика: повторная проверка уже прошедшего ревью — лишняя работа. Если задача была одобрена — она одобрена.
+
+Только если ни одной успешной записи нет — переходи к шагу 1.
+
+### 1. Прочитать тикет
+
+ID тикета передаётся в промпте как `ticket_id` в секции Context.
+
+```
+Путь: .workflow/tickets/review/{TICKET-ID}.md
+```
+
+**Важно:** НЕ перемещай тикет — перемещение выполняется отдельным stage пайплайна по результату этого skill.
+
+Извлечь:
+- Definition of Done (DoD) — чеклист критериев готовности
+- Детали задачи — требования к реализации
+- Результат выполнения (секция Result) — что сделано
+
+### 2. Проверить каждый пункт DoD
+
+Для каждого критерия из Definition of Done:
+
+| Тип проверки | Описание |
+|--------------|----------|
+| `file_exists` | Файл существует по указанному пути |
+| `compilation` | Код компилируется / линтер проходит |
+| `tests` | Тесты проходят |
+| `text` | Текстовый критерий выполнен (содержимое, структура) |
+| `structure` | Структура соответствует шаблону |
+
+### 3. Сверить результат с требованиями
+
+Сравнить секцию «Результат выполнения» с «Деталями задачи»:
+- Все ли требования учтены
+- Соответствует ли реализация описанию
+- Нет ли расхождений
+
+### 4. Сформировать вердикт
+
+Возвращать структурированный результат строго в одном из двух форматов:
+
+> **КРИТИЧНО**: `status` принимает ТОЛЬКО два значения: `passed` или `failed`.
+> Любой другой вывод (`default`, `ok`, `done`, `complete`, `yes`, и т.д.) — **ОШИБКА**.
+> Пайплайн не продолжится корректно, если статус не распознан.
+
+Если **все** пункты DoD выполнены:
+
+```
+---RESULT---
+status: passed
+issues: []
+---RESULT---
+```
+
+Если **хотя бы один** пункт DoD не выполнен:
+
+```
+---RESULT---
+status: failed
+issues:
+  - "Пункт DoD X не выполнен: ожидалось Y, получено Z"
+  - "Файл X не создан"
+  - "Тест Y не прошёл"
+---RESULT---
+```
+
+> Блок `---RESULT---` должен быть в выводе **ровно один раз**, в самом конце ответа.
+
+### 5. При `failed`: детализировать замечания
+
+Для каждого невыполненного пункта:
+- Описать что ожидалось
+- Описать что получено
+- Указать файл/строку если применимо
+
+## Алгоритм проверки
+
+```
+0. Быстрый выход:
+   - Прочитать тикет
+   - Найти секцию "## Ревью"
+   - Если есть запись с "passed" → вернуть status: passed, остановиться
+
+1. Парсинг тикета:
+   - Извлечь DoD (список критериев)
+   - Извлечь Result (что сделано)
+   - Извлечь Детали задачи (требования)
+
+2. Для каждого пункта DoD:
+   - Определить тип проверки (file/compilation/tests/text)
+   - Выполнить проверку
+   - Записать результат (pass/fail + комментарий)
+
+3. Сверка Result ↔ Детали задачи:
+   - Все ли файлы созданы
+   - Соответствует ли структура
+   - Нет ли расхождений
+
+4. Формирование вердикта:
+   - Если все пункты pass → status: passed
+   - Если есть fail → status: failed + список issues
+
+5. Вывод результата в формате ---RESULT---
+
+6. Пометка тикета о результате ревью:
+   - Добавить/обновить секцию `## Ревью` в тикете
+   - Указать:
+     - Дата ревью
+     - Статус: passed/failed
+     - Краткий самари (если failed — что не так)
+   - Сохранить тикет в той же директории
+```
+
+## Типы проверок
+
+### file_exists
+
+Проверка существования файла:
+
+```
+Критерий: "[ ] Файл `src/logger.py` создан"
+Проверка: os.path.exists("src/logger.py")
+Результат: pass/fail
+```
+
+### compilation
+
+Проверка компиляции / линта:
+
+```
+Критерий: "[ ] Код проходит линтер"
+Проверка: npm run lint / ruff check / etc.
+Результат: pass/fail + вывод
+```
+
+### tests
+
+Проверка тестов:
+
+```
+Критерий: "[ ] Тесты проходят"
+Проверка: npm test / pytest / etc.
+Результат: pass/fail + вывод
+```
+
+### text
+
+Текстовая проверка:
+
+```
+Критерий: "[ ] Описан алгоритм проверки DoD"
+Проверка: Поиск раздела "Алгоритм" в файле
+Результат: pass/fail
+```
+
+### structure
+
+Проверка структуры:
+
+```
+Критерий: "[ ] Структура аналогична существующим skills"
+Проверка: Сравнение с шаблоном
+Результат: pass/fail + замечания
+```
+
+## Пример использования
+
+```
+Проверь результат IMPL-006 на соответствие DoD.
+```
+
+```
+review-result .workflow/tickets/in-progress/IMPL-006.md
+```
+
+## Пример вывода
+
+### Успешная проверка
+
+```markdown
+---RESULT---
+status: passed
+issues: []
+---RESULT---
+```
+
+### Неуспешная проверка
+
+```markdown
+---RESULT---
+status: failed
+issues:
+  - "Пункт DoD 'Файл .workflow/src/skills/review-result/SKILL.md создан' не выполнен: файл не найден"
+  - "Пункт DoD 'Описан алгоритм проверки DoD' не выполнен: раздел 'Алгоритм' отсутствует"
+  - "Тесты не прошли: 2 failed, 5 passed"
+---RESULT---
+```
+
+## Формат секции ревью в тикете
+
+После проверки skill добавляет в тикет секцию:
+
+```markdown
+## Ревью
+
+| Дата | Статус | Самари |
+|------|--------|--------|
+| 2026-03-03 14:30 | ✅ passed | Все критерии DoD выполнены |
+| 2026-03-03 15:45 | ❌ failed | Не пройдены тесты, отсутствует файл logger.py |
+```
+
+Или в текстовом формате:
+
+```markdown
+## Ревью
+
+**Дата:** 2026-03-03 14:30  
+**Статус:** passed/failed  
+**Самари:** Краткое описание результата (что не так, если failed)
+```
+
+## Интеграция с пайплайном
+
+В retry-логике пайплайна:
+
+1. `execute-task` выполняет задачу
+2. `review-result` проверяет результат
+3. По `status` определяется goto-переход:
+   - `passed` → следующий stage
+   - `failed` → retry или blocked
+
+## Результат
+
+- Структурированный вердикт (passed/failed)
+- Список замечаний (если есть)
+- **Тикет помечен секцией `## Ревью`** с датой, статусом и кратким самари
+- Готово для использования в goto-логике
+
+## Связанные skills
+
+- `execute-task` — выполнение задачи перед проверкой
+- `move-ticket` — перемещение по результатам проверки
+- `check-conditions` — проверка условий для зависимых задач

package/templates/plan-template.md

@@ -0,0 +1,116 @@
+---
+# Шаблон плана для системы Kilo Code Agent Workflow
+
+id: "PLAN-{NNN}"
+title: "Название плана"
+status: draft                    # draft | active | completed | archived
+author: architect
+
+created_at: ""                   # ISO 8601
+updated_at: ""
+completed_at: ""
+
+# Связь с предыдущим планом (если есть)
+previous_plan: ""
+# Связанные отчёты
+related_reports: []
+---
+
+# План: {Название}
+
+## Цель
+
+<!-- Чего хотим достичь. Конкретная, измеримая цель. -->
+
+## Контекст
+
+<!-- 
+Почему это важно:
+- Какая предыстория
+- Какие проблемы решаем
+- Что будет если не сделать
+-->
+
+## Scope (Границы)
+
+### Включено в scope
+
+- Пункт 1
+- Пункт 2
+- Пункт 3
+
+### Исключено из scope
+
+- Пункт 1
+- Пункт 2
+
+## Высокоуровневые задачи
+
+<!-- 
+Каждая задача будет декомпозирована Administrator'ом на тикеты.
+Указывайте приоритет и зависимости.
+-->
+
+### 1. Задача 1
+
+**Приоритет:** Высокий  
+**Зависимости:** Нет  
+**Описание:** Что нужно сделать
+
+### 2. Задача 2
+
+**Приоритет:** Средний  
+**Зависимости:** Задача 1  
+**Описание:** Что нужно сделать
+
+### 3. Задача 3
+
+**Приоритет:** Низкий  
+**Зависимости:** Задачи 1, 2  
+**Описание:** Что нужно сделать
+
+## Технические решения
+
+<!-- 
+Ключевые архитектурные и технические решения.
+Почему выбрали именно такой подход.
+-->
+
+## Риски и зависимости
+
+| Риск | Вероятность | Влияние | Митигация |
+|------|-------------|---------|-----------|
+| Риск 1 | Высокая | Высокое | Как будем предотвращать/решать |
+| Риск 2 | Средняя | Среднее | Как будем предотвращать/решать |
+
+## Внешние зависимости
+
+<!-- Зависимости от внешних систем, команд, ресурсов -->
+
+- Зависимость 1
+- Зависимость 2
+
+## Критерии успеха
+
+<!-- Как поймём, что план выполнен успешно -->
+
+- [ ] Критерий 1
+- [ ] Критерий 2
+- [ ] Критерий 3
+
+## Метрики
+
+<!-- Что будем измерять для оценки успешности -->
+
+| Метрика | Текущее значение | Целевое значение |
+|---------|-----------------|------------------|
+| Метрика 1 | X | Y |
+| Метрика 2 | X | Y |
+
+---
+
+## История изменений
+
+| Дата | Автор | Изменение |
+|------|-------|-----------|
+| YYYY-MM-DD | Architect | Создан план |

package/templates/report-template.md

@@ -0,0 +1,178 @@
+---
+# Шаблон отчёта для системы Kilo Code Agent Workflow
+
+id: "REPORT-{NNN}"
+type: daily                      # daily | sprint | milestone
+period_start: ""                 # ISO 8601
+period_end: ""
+author: administrator
+
+created_at: ""
+related_plan: ""                 # ID или путь к плану
+---
+
+# Отчёт: {Тип} за {Период}
+
+**Дата создания:** YYYY-MM-DD  
+**Период:** YYYY-MM-DD — YYYY-MM-DD  
+**Связанный план:** {ссылка на план}
+
+---
+
+## Сводка
+
+<!-- Краткое резюме периода в 2-3 предложениях -->
+
+| Метрика | Значение |
+|---------|----------|
+| Выполнено задач | X |
+| В работе | Y |
+| Заблокировано | Z |
+| Новых задач | N |
+
+---
+
+## Выполненные задачи
+
+| ID | Задача | Роль | Результат | Время |
+|----|--------|------|-----------|-------|
+| CODE-001 | Название | code | Успешно | 2h |
+| ARCH-002 | Название | architect | Успешно | 1h |
+
+### Детали выполненных задач
+
+#### CODE-001: Название задачи
+
+**Summary:** Краткое описание результата
+
+**Ключевые изменения:**
+- Изменение 1
+- Изменение 2
+
+**Изменённые файлы:**
+- `path/to/file1.ts`
+- `path/to/file2.ts`
+
+---
+
+## Задачи в работе
+
+| ID | Задача | Статус | Исполнитель | Прогресс |
+|----|--------|--------|-------------|----------|
+| CODE-003 | Название | in-progress | code | 50% |
+
+### Заметки по задачам в работе
+
+<!-- Важная информация о ходе выполнения -->
+
+---
+
+## Заблокированные задачи
+
+| ID | Задача | Причина блокировки | Требуется |
+|----|--------|-------------------|-----------|
+| DEBUG-001 | Название | Описание проблемы | Решение архитектора |
+
+### Анализ блокировок
+
+<!-- 
+Детальный анализ причин блокировок и рекомендации по их устранению
+-->
+
+---
+
+## Метрики производительности
+
+### Velocity
+
+- **Выполнено задач:** X
+- **Story points (если используются):** Y
+- **Среднее время на задачу:** Z часов
+
+### Распределение по ролям
+
+| Роль | Задач | % от общего |
+|------|-------|-------------|
+| code | X | X% |
+| debug | Y | Y% |
+| architect | Z | Z% |
+
+### Распределение по приоритетам
+
+| Приоритет | Выполнено | В работе | Заблокировано |
+|-----------|-----------|----------|---------------|
+| Critical | X | X | X |
+| High | X | X | X |
+| Medium | X | X | X |
+| Low | X | X | X |
+
+---
+
+## Риски и проблемы
+
+### Выявленные проблемы
+
+1. **Проблема 1**
+   - Описание
+   - Влияние
+   - Предлагаемое решение
+
+### Потенциальные риски
+
+1. **Риск 1**
+   - Вероятность: Высокая/Средняя/Низкая
+   - Влияние: Высокое/Среднее/Низкое
+   - Митигация: Как предотвратить
+
+---
+
+## Рекомендации для Architect
+
+<!-- 
+Выводы и предложения на основе анализа выполненных задач.
+Что требует решения или изменения в плане.
+-->
+
+### Требуют решения
+
+1. Вопрос/проблема 1
+2. Вопрос/проблема 2
+
+### Предложения по оптимизации
+
+1. Предложение 1
+2. Предложение 2
+
+### Готовность к следующему этапу
+
+<!-- 
+Оценка готовности к переходу к следующей фазе плана.
+Что ещё нужно сделать.
+-->
+
+---
+
+## План на следующий период
+
+### Приоритетные задачи
+
+1. Задача 1 (из backlog)
+2. Задача 2 (из backlog)
+
+### Ожидаемые deliverables
+
+- Deliverable 1
+- Deliverable 2
+
+---
+
+## Приложения
+
+### Ссылки на артефакты
+
+- Ссылка 1
+- Ссылка 2
+
+### Дополнительные материалы
+
+<!-- Графики, диаграммы, скриншоты если нужны -->

package/templates/ticket-template.md

@@ -0,0 +1,103 @@
+---
+# Шаблон тикета для универсальной системы координации агентов
+# Скопируйте этот файл и заполните поля
+
+id: "{TYPE}-{NNN}"              # IMPL-001, FIX-015, PLAN-003
+title: "Название задачи"
+status: backlog                  # backlog | ready | in-progress | blocked | review | done
+priority: 3                      # 1-критический, 2-высокий, 3-средний, 4-низкий, 5-когда-нибудь
+
+# Тип задачи
+type: implementation             # planning | implementation | bugfix | review | documentation | admin
+
+# Требования к агенту-исполнителю (для выбора подходящего инструмента)
+required_capabilities: []
+  # - code_generation        # Генерация кода
+  # - code_editing           # Редактирование кода
+  # - file_operations        # Работа с файлами
+  # - debugging              # Отладка
+  # - code_analysis          # Анализ кода
+  # - documentation          # Написание документации
+  # - strategic_thinking     # Стратегическое планирование
+  # - typescript             # Знание TypeScript
+  # - python                 # Знание Python
+
+created_at: ""                   # ISO 8601: 2026-02-28T12:00:00Z
+updated_at: ""                   # Обновляется при изменении
+completed_at: ""                 # Заполняется при завершении
+
+parent_plan: ""                  # Путь к плану: plans/current/plan-001.md
+parent_task: ""                  # ID родительской задачи для подзадач
+
+# Зависимости - задачи, которые должны быть выполнены ДО этой
+dependencies: []
+  # - IMPL-001
+  # - PLAN-002
+
+# Условия выполнения - все должны быть истинны для начала работы
+conditions: []
+  # - type: tasks_completed      # Все зависимости выполнены
+  # - type: date_after           # После определённой даты
+  #   value: "2026-03-01"
+  # - type: file_exists          # Файл должен существовать
+  #   value: "src/config.ts"
+  # - type: manual_approval      # Требует ручного подтверждения
+
+# Контекст - информация для агента-исполнителя
+context:
+  files: []                      # Файлы для работы
+    # - src/api/routes.ts
+    # - docs/api-spec.md
+  references: []                 # Ссылки на документацию
+    # - https://docs.example.com/api
+  notes: ""                      # Дополнительные заметки
+
+# Оценка сложности
+complexity: medium               # simple | medium | complex
+
+tags: []
+  # - backend
+  # - api
+  # - refactoring
+---
+
+## Описание
+
+<!-- Краткое описание того, что нужно сделать -->
+
+## Детали задачи
+
+<!-- Подробное описание с техническими деталями -->
+
+## Критерии готовности (Definition of Done)
+
+- [ ] Критерий 1
+- [ ] Критерий 2
+- [ ] Критерий 3
+
+---
+
+## Результат выполнения
+
+<!-- Заполняется агентом-исполнителем после выполнения -->
+
+### Summary
+
+<!-- Краткое описание того, что было сделано -->
+
+### Изменённые файлы
+
+<!-- 
+- `path/to/file1.ts` - описание изменений
+- `path/to/file2.ts` - описание изменений 
+-->
+
+### Заметки для следующих задач
+
+<!-- Важная информация для связанных задач -->
+
+### Время выполнения
+
+- Started: 
+- Completed: 
+- Agent used: <!-- Какой агент/инструмент использовался -->