workflow-ai 1.0.41 → 1.0.43
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/package.json +1 -1
- package/src/init.mjs +13 -8
- package/src/junction-manager.mjs +8 -4
- package/src/runner.mjs +1 -1
- package/src/scripts/archive-plan-tickets.js +0 -102
- package/src/scripts/check-anomalies.js +0 -161
- package/src/scripts/check-conditions.js +0 -254
- package/src/scripts/check-plan-decomposed.js +0 -179
- package/src/scripts/move-ticket.js +0 -228
- package/src/scripts/move-to-ready.js +0 -115
- package/src/scripts/move-to-review.js +0 -100
- package/src/scripts/pick-next-task.js +0 -723
- package/src/skills/analyze-report/SKILL.md +0 -110
- package/src/skills/check-relevance/SKILL.md +0 -236
- package/src/skills/coach/README.md +0 -100
- package/src/skills/coach/SKILL.md +0 -119
- package/src/skills/coach/algorithms/gap-analysis.md +0 -69
- package/src/skills/coach/algorithms/improvement-prioritization.md +0 -62
- package/src/skills/coach/algorithms/skill-scoring.md +0 -79
- package/src/skills/coach/knowledge/backlog-management.md +0 -71
- package/src/skills/coach/knowledge/common-antipatterns.md +0 -56
- package/src/skills/coach/knowledge/prompt-engineering.md +0 -86
- package/src/skills/coach/knowledge/skill-anatomy.md +0 -71
- package/src/skills/coach/templates/audit-report.md +0 -54
- package/src/skills/coach/templates/coach-backlog-init.yaml +0 -10
- package/src/skills/coach/templates/improvement-plan.md +0 -54
- package/src/skills/coach/templates/new-skill.md +0 -137
- package/src/skills/coach/workflows/analyze.md +0 -85
- package/src/skills/coach/workflows/audit.md +0 -68
- package/src/skills/coach/workflows/create.md +0 -66
- package/src/skills/coach/workflows/improve.md +0 -70
- package/src/skills/coach/workflows/research.md +0 -55
- package/src/skills/coach/workflows/review.md +0 -74
- package/src/skills/create-plan/SKILL.md +0 -107
- package/src/skills/create-report/SKILL.md +0 -156
- package/src/skills/decompose-gaps/SKILL.md +0 -167
- package/src/skills/decompose-plan/SKILL.md +0 -219
- package/src/skills/deep-research/README.md +0 -50
- package/src/skills/deep-research/SKILL.md +0 -148
- package/src/skills/deep-research/algorithms/source-scoring.md +0 -63
- package/src/skills/deep-research/algorithms/synthesis.md +0 -67
- package/src/skills/deep-research/knowledge/data-validation.md +0 -44
- package/src/skills/deep-research/knowledge/research-methodology.md +0 -54
- package/src/skills/deep-research/knowledge/source-evaluation.md +0 -33
- package/src/skills/deep-research/scripts/perplexity-research.js +0 -315
- package/src/skills/deep-research/templates/brief-summary.md +0 -25
- package/src/skills/deep-research/templates/research-report.md +0 -76
- package/src/skills/deep-research/workflows/benchmark.md +0 -56
- package/src/skills/deep-research/workflows/competitor.md +0 -63
- package/src/skills/deep-research/workflows/custom.md +0 -45
- package/src/skills/deep-research/workflows/market.md +0 -64
- package/src/skills/deep-research/workflows/technology.md +0 -52
- package/src/skills/deep-research/workflows/trend.md +0 -51
- package/src/skills/execute-task/SKILL.md +0 -207
- package/src/skills/review-result/SKILL.md +0 -329
|
@@ -1,110 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: analyze-report
|
|
3
|
-
description: Проанализировать отчёт о выполненных задачах и выработать рекомендации. Используй после завершения итерации работ для принятия решений о дальнейших действиях. Читает отчёты из .workflow/reports/ и формирует выводы.
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Анализ отчёта
|
|
7
|
-
|
|
8
|
-
Этот skill анализирует отчёты о выполненных задачах и помогает принять решения о дальнейших действиях.
|
|
9
|
-
|
|
10
|
-
## Когда использовать
|
|
11
|
-
|
|
12
|
-
- Завершилась итерация работ
|
|
13
|
-
- Накопились выполненные задачи
|
|
14
|
-
- Нужно принять решение о следующих шагах
|
|
15
|
-
- Требуется ретроспектива
|
|
16
|
-
|
|
17
|
-
## Шаги выполнения
|
|
18
|
-
|
|
19
|
-
### 1. Прочитать отчёт
|
|
20
|
-
|
|
21
|
-
```
|
|
22
|
-
Путь: .workflow/reports/REPORT-{NNN}.md
|
|
23
|
-
```
|
|
24
|
-
|
|
25
|
-
Извлечь:
|
|
26
|
-
- Период отчёта
|
|
27
|
-
- Выполненные задачи
|
|
28
|
-
- Проблемы
|
|
29
|
-
- Статистику
|
|
30
|
-
|
|
31
|
-
### 2. Проанализировать достижения
|
|
32
|
-
|
|
33
|
-
Для каждой выполненной задачи:
|
|
34
|
-
- Что было сделано?
|
|
35
|
-
- Соответствует ли результат ожиданиям?
|
|
36
|
-
- Были ли отклонения от плана?
|
|
37
|
-
|
|
38
|
-
### 3. Проанализировать проблемы
|
|
39
|
-
|
|
40
|
-
Для каждой проблемы:
|
|
41
|
-
- В чём причина?
|
|
42
|
-
- Как была решена (или не решена)?
|
|
43
|
-
- Можно ли предотвратить в будущем?
|
|
44
|
-
|
|
45
|
-
### 4. Оценить прогресс по плану
|
|
46
|
-
|
|
47
|
-
Если есть связанный план:
|
|
48
|
-
- Какой процент выполнен?
|
|
49
|
-
- Соблюдаются ли сроки?
|
|
50
|
-
- Нужна ли корректировка плана?
|
|
51
|
-
|
|
52
|
-
### 5. Сформулировать выводы
|
|
53
|
-
|
|
54
|
-
**Положительные моменты:**
|
|
55
|
-
- Что работает хорошо
|
|
56
|
-
- Какие практики стоит продолжать
|
|
57
|
-
|
|
58
|
-
**Области для улучшения:**
|
|
59
|
-
- Что можно улучшить
|
|
60
|
-
- Какие процессы неэффективны
|
|
61
|
-
|
|
62
|
-
**Рекомендации:**
|
|
63
|
-
- Конкретные действия
|
|
64
|
-
- Приоритеты
|
|
65
|
-
|
|
66
|
-
### 6. Принять решение
|
|
67
|
-
|
|
68
|
-
Возможные решения:
|
|
69
|
-
- **Продолжить** — следующие задачи по плану
|
|
70
|
-
- **Скорректировать** — изменить приоритеты или подход
|
|
71
|
-
- **Новый план** — текущий план исчерпан или нерелевантен
|
|
72
|
-
- **Эскалировать** — требуется вмешательство человека
|
|
73
|
-
|
|
74
|
-
### 7. Вывести структурированный результат
|
|
75
|
-
|
|
76
|
-
После анализа **обязательно** выведи блок результата.
|
|
77
|
-
|
|
78
|
-
Если план выполнен полностью:
|
|
79
|
-
```
|
|
80
|
-
---RESULT---
|
|
81
|
-
status: completed
|
|
82
|
-
---RESULT---
|
|
83
|
-
```
|
|
84
|
-
|
|
85
|
-
Если есть пробелы/недочёты:
|
|
86
|
-
```
|
|
87
|
-
---RESULT---
|
|
88
|
-
status: has_gaps
|
|
89
|
-
gaps: Краткое описание что не сделано или не соответствует плану
|
|
90
|
-
---RESULT---
|
|
91
|
-
```
|
|
92
|
-
|
|
93
|
-
## Пример использования
|
|
94
|
-
|
|
95
|
-
```
|
|
96
|
-
Проанализируй отчёт .workflow/reports/REPORT-001.md и дай рекомендации.
|
|
97
|
-
```
|
|
98
|
-
|
|
99
|
-
## Результат
|
|
100
|
-
|
|
101
|
-
Структурированный анализ с:
|
|
102
|
-
- Оценкой прогресса
|
|
103
|
-
- Выявленными проблемами
|
|
104
|
-
- Рекомендациями
|
|
105
|
-
- Решением о дальнейших действиях
|
|
106
|
-
|
|
107
|
-
## Связанные skills
|
|
108
|
-
|
|
109
|
-
- `create-plan` — создание нового плана на основе анализа
|
|
110
|
-
- `create-report` — создание отчёта для анализа
|
|
@@ -1,236 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: check-relevance
|
|
3
|
-
description: Проверить актуальность тикета перед выполнением. Используется для предотвращения выполнения устаревших или уже завершённых задач.
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Проверка актуальности тикета
|
|
7
|
-
|
|
8
|
-
> **ЗАПРЕТ:** НЕ перемещай, НЕ удаляй, НЕ переименовывай файлы тикетов. Твоя задача — ТОЛЬКО прочитать, при irrelevant добавить запись в таблицу ревью, и вернуть вердикт. Перемещение выполняет отдельный stage пайплайна. Проверяй ТОЛЬКО тикет из `ticket_id` контекста, игнорируй остальные поля (`ready_tickets` и т.д.).
|
|
9
|
-
|
|
10
|
-
Этот skill проверяет актуальность тикета перед его выполнением. Предотвращает выполнение устаревших/неактуальных задач.
|
|
11
|
-
|
|
12
|
-
## Когда использовать
|
|
13
|
-
|
|
14
|
-
- Тикет только что перемещён в `in-progress/`
|
|
15
|
-
- Перед выполнением основной задачи (execute-task)
|
|
16
|
-
- Для фильтрации задач с неактивными планами или выполненными DoD
|
|
17
|
-
|
|
18
|
-
## Шаги проверки
|
|
19
|
-
|
|
20
|
-
### 0. Быстрый выход по существующему ревью
|
|
21
|
-
|
|
22
|
-
**До любых проверок** найди в тикете секцию `## Ревью`.
|
|
23
|
-
|
|
24
|
-
Если последняя запись имеет статус `⏭ skipped` — тикет уже был проверен и пропущен. **Повторно проверять НЕ НАДО**, новую запись skipped добавлять НЕ НАДО. Немедленно верни:
|
|
25
|
-
|
|
26
|
-
```
|
|
27
|
-
---RESULT---
|
|
28
|
-
status: irrelevant
|
|
29
|
-
reason: already_skipped
|
|
30
|
-
---RESULT---
|
|
31
|
-
```
|
|
32
|
-
|
|
33
|
-
Если последняя запись имеет статус `❌ failed` — тикет был выполнен, но ревью провалилось. Тикету нужна **доработка через execute-task**, а НЕ повторное ревью. Немедленно верни:
|
|
34
|
-
|
|
35
|
-
```
|
|
36
|
-
---RESULT---
|
|
37
|
-
status: relevant
|
|
38
|
-
reason: review_failed_needs_rework
|
|
39
|
-
---RESULT---
|
|
40
|
-
```
|
|
41
|
-
|
|
42
|
-
Если последней записи нет или статус другой — переходи к шагу 1.
|
|
43
|
-
|
|
44
|
-
### 1. Прочитать тикет
|
|
45
|
-
|
|
46
|
-
**ОБЯЗАТЕЛЬНО:** Используй `ticket_id` из секции Context промпта.
|
|
47
|
-
|
|
48
|
-
```
|
|
49
|
-
Путь: .workflow/tickets/in-progress/{TICKET-ID}.md
|
|
50
|
-
```
|
|
51
|
-
|
|
52
|
-
Извлечь:
|
|
53
|
-
- `parent_plan` — ссылка на родительский план
|
|
54
|
-
- `dependencies` — зависимости тикета
|
|
55
|
-
- `conditions` — условия выполнения
|
|
56
|
-
- Критерии готовности (Definition of Done)
|
|
57
|
-
|
|
58
|
-
### 2. Проверить родительский план
|
|
59
|
-
|
|
60
|
-
Проверить статус родительского плана:
|
|
61
|
-
|
|
62
|
-
```
|
|
63
|
-
Путь: .workflow/plans/current/{PARENT_PLAN}.md
|
|
64
|
-
```
|
|
65
|
-
|
|
66
|
-
**Критерии неактуальности:**
|
|
67
|
-
- План имеет `status: completed` — план уже завершён
|
|
68
|
-
- План имеет `status: archived` — план заархивирован
|
|
69
|
-
- План имеет `status: cancelled` — план отменён
|
|
70
|
-
|
|
71
|
-
**Если план неактивен:** тикет `irrelevant`
|
|
72
|
-
|
|
73
|
-
### 3. Проверить выполнение DoD
|
|
74
|
-
|
|
75
|
-
Проверить все критерии из Definition of Done тикета:
|
|
76
|
-
|
|
77
|
-
**Критерии неактуальности:**
|
|
78
|
-
- Все критерии уже отмечены как выполненные `[x]`
|
|
79
|
-
- В секции "Результат выполнения" уже есть заполненные данные
|
|
80
|
-
|
|
81
|
-
**ВАЖНО:** Если DoD выполнен, но последнее ревью `❌ failed` — тикет **НЕ неактуален**, ему нужна доработка. Верни `relevant` (reason: review_failed_needs_rework). Это предотвращает бесконечный цикл повторного ревью без доработки.
|
|
82
|
-
|
|
83
|
-
**Если DoD полностью выполнен И ревью НЕ failed:** тикет `irrelevant` (задача уже сделана)
|
|
84
|
-
|
|
85
|
-
### 4. Проверить зависимости
|
|
86
|
-
|
|
87
|
-
Проверить тикеты из секции `dependencies`:
|
|
88
|
-
|
|
89
|
-
```
|
|
90
|
-
Путь: .workflow/tickets/{status}/{DEP-TICKET}.md
|
|
91
|
-
```
|
|
92
|
-
|
|
93
|
-
**Критерии неактуальности:**
|
|
94
|
-
- Зависимый тикет находится в `blocked/` с причиной "неактуально"
|
|
95
|
-
- Зависимый тикет был удалён или перемещён в архив
|
|
96
|
-
|
|
97
|
-
**Если критические зависимости неактуальны:** тикет `irrelevant`
|
|
98
|
-
|
|
99
|
-
### 5. Проверить статус blocked
|
|
100
|
-
|
|
101
|
-
**Проверить секцию `## Блокировки` или frontmatter:**
|
|
102
|
-
|
|
103
|
-
Если тикет помечен как заблокированный → **неактуален**.
|
|
104
|
-
|
|
105
|
-
### 6. При irrelevant — записать в таблицу ревью тикета
|
|
106
|
-
|
|
107
|
-
Если вердикт `irrelevant`, **ОБЯЗАТЕЛЬНО** добавь запись в секцию `## Ревью` тикета:
|
|
108
|
-
|
|
109
|
-
- Если секции `## Ревью` нет — создай её в конце файла
|
|
110
|
-
- Если таблица уже есть — добавь строку в конец таблицы
|
|
111
|
-
|
|
112
|
-
Формат записи:
|
|
113
|
-
|
|
114
|
-
```
|
|
115
|
-
| {текущая дата} | ⏭️ skipped | {причина irrelevant: plan_inactive / dod_completed / dependencies_inactive} |
|
|
116
|
-
```
|
|
117
|
-
|
|
118
|
-
Пример:
|
|
119
|
-
|
|
120
|
-
```markdown
|
|
121
|
-
## Ревью
|
|
122
|
-
|
|
123
|
-
| Дата | Статус | Самари |
|
|
124
|
-
|------|--------|--------|
|
|
125
|
-
| 2026-03-10 | ⏭️ skipped | DoD уже выполнен, тикет неактуален |
|
|
126
|
-
```
|
|
127
|
-
|
|
128
|
-
Это единственная допустимая запись в файл — только добавление строки в таблицу ревью.
|
|
129
|
-
|
|
130
|
-
### 7. Принять решение
|
|
131
|
-
|
|
132
|
-
На основе проверок вывести результат:
|
|
133
|
-
|
|
134
|
-
| Проверка | Результат | Статус |
|
|
135
|
-
|----------|-----------|--------|
|
|
136
|
-
| Последнее ревью failed | Needs rework | `relevant` |
|
|
137
|
-
| План неактивен | Plan inactive | `irrelevant` |
|
|
138
|
-
| DoD выполнен (ревью НЕ failed) | DoD completed | `irrelevant` |
|
|
139
|
-
| Зависимости неактуальны | Dependencies inactive | `irrelevant` |
|
|
140
|
-
| Все проверки пройдены | All checks passed | `relevant` |
|
|
141
|
-
|
|
142
|
-
## Fail-safe дизайн
|
|
143
|
-
|
|
144
|
-
**Важно:** При неизвестном статусе или ошибке проверки использовать fallback → `relevant`
|
|
145
|
-
|
|
146
|
-
Это гарантирует что тикет будет выполнен даже при проблемах с проверкой. Лучше выполнить лишний тикет, чем пропустить нужный.
|
|
147
|
-
|
|
148
|
-
## Формат результата
|
|
149
|
-
|
|
150
|
-
Обязательно выведи блок результата:
|
|
151
|
-
|
|
152
|
-
```
|
|
153
|
-
---RESULT---
|
|
154
|
-
status: relevant
|
|
155
|
-
---RESULT---
|
|
156
|
-
```
|
|
157
|
-
|
|
158
|
-
Или для неактуальных:
|
|
159
|
-
|
|
160
|
-
```
|
|
161
|
-
---RESULT---
|
|
162
|
-
status: irrelevant
|
|
163
|
-
reason: <причина: plan_inactive / dod_completed / dependencies_inactive>
|
|
164
|
-
---RESULT---
|
|
165
|
-
```
|
|
166
|
-
|
|
167
|
-
## Примеры
|
|
168
|
-
|
|
169
|
-
### Пример 1: Тикет актуален
|
|
170
|
-
|
|
171
|
-
```markdown
|
|
172
|
-
## Result
|
|
173
|
-
|
|
174
|
-
### Что проверено
|
|
175
|
-
- Родительский план PLAN-001: status: active ✓
|
|
176
|
-
- DoD: не все критерии выполнены ✓
|
|
177
|
-
- Зависимости: все активны ✓
|
|
178
|
-
|
|
179
|
-
### Решение
|
|
180
|
-
Тикет актуален, можно выполнять
|
|
181
|
-
|
|
182
|
-
---RESULT---
|
|
183
|
-
status: relevant
|
|
184
|
-
---RESULT---
|
|
185
|
-
```
|
|
186
|
-
|
|
187
|
-
### Пример 2: План завершён
|
|
188
|
-
|
|
189
|
-
```markdown
|
|
190
|
-
## Result
|
|
191
|
-
|
|
192
|
-
### Что проверено
|
|
193
|
-
- Родительский план PLAN-001: status: completed ✗
|
|
194
|
-
|
|
195
|
-
### Решение
|
|
196
|
-
План уже завершён, тикет неактуален
|
|
197
|
-
|
|
198
|
-
---RESULT---
|
|
199
|
-
status: irrelevant
|
|
200
|
-
reason: plan_inactive
|
|
201
|
-
---RESULT---
|
|
202
|
-
```
|
|
203
|
-
|
|
204
|
-
### Пример 3: DoD выполнен
|
|
205
|
-
|
|
206
|
-
```markdown
|
|
207
|
-
## Result
|
|
208
|
-
|
|
209
|
-
### Что проверено
|
|
210
|
-
- Родительский план PLAN-001: status: active ✓
|
|
211
|
-
- DoD: все критерии отмечены [x] ✗
|
|
212
|
-
- Секция "Результат выполнения": заполнена ✗
|
|
213
|
-
|
|
214
|
-
### Решение
|
|
215
|
-
Задача уже выполнена, тикет неактуален
|
|
216
|
-
|
|
217
|
-
---RESULT---
|
|
218
|
-
status: irrelevant
|
|
219
|
-
reason: dod_completed
|
|
220
|
-
---RESULT---
|
|
221
|
-
```
|
|
222
|
-
|
|
223
|
-
## Интеграция с pipeline
|
|
224
|
-
|
|
225
|
-
Этот skill используется в stage `check-relevance` который размещается между:
|
|
226
|
-
- `move-to-in-progress` → `check-relevance` → `execute-task`
|
|
227
|
-
|
|
228
|
-
Переходы:
|
|
229
|
-
- `relevant` → перейти к `execute-task`
|
|
230
|
-
- `irrelevant` → переместить тикет в `done/` с пометкой
|
|
231
|
-
- `default` (fallback) → `execute-task` (fail-safe)
|
|
232
|
-
|
|
233
|
-
## Связанные skills
|
|
234
|
-
|
|
235
|
-
- `execute-task` — выполняет задачу после проверки актуальности
|
|
236
|
-
- `move-ticket` — перемещает неактуальные тикеты в done/
|
|
@@ -1,100 +0,0 @@
|
|
|
1
|
-
# Coach — Модульный скилл
|
|
2
|
-
|
|
3
|
-
Скилл для агента workflow-ai, обрабатывающего тикеты `COACH-*`.
|
|
4
|
-
Мета-скил для создания, аудита и совершенствования других скилов.
|
|
5
|
-
|
|
6
|
-
## Структура
|
|
7
|
-
|
|
8
|
-
```
|
|
9
|
-
coach/
|
|
10
|
-
├── SKILL.md # Ядро: роль, маршрутизация, принципы
|
|
11
|
-
│
|
|
12
|
-
├── workflows/ # Пошаговые воркфлоу по типам тикетов
|
|
13
|
-
│ ├── create.md # COACH-*: CREATE — создание нового скила
|
|
14
|
-
│ ├── audit.md # COACH-*: AUDIT — полный аудит скила
|
|
15
|
-
│ ├── analyze.md # COACH-*: ANALYZE — анализ эффективности
|
|
16
|
-
│ ├── improve.md # COACH-*: IMPROVE — точечное улучшение
|
|
17
|
-
│ ├── research.md # COACH-*: RESEARCH — поиск знаний
|
|
18
|
-
│ └── review.md # COACH-*: REVIEW — ревью структуры и качества
|
|
19
|
-
│
|
|
20
|
-
├── knowledge/ # Экспертные знания (подгружаются по запросу)
|
|
21
|
-
│ ├── skill-anatomy.md # Эталонная структура скила
|
|
22
|
-
│ ├── common-antipatterns.md # Типичные ошибки в скилах
|
|
23
|
-
│ └── prompt-engineering.md # Принципы написания инструкций
|
|
24
|
-
│
|
|
25
|
-
├── algorithms/ # Формализованные методы принятия решений
|
|
26
|
-
│ ├── skill-scoring.md # Оценка качества скила (0–100)
|
|
27
|
-
│ ├── gap-analysis.md # Поиск пробелов в покрытии скила
|
|
28
|
-
│ └── improvement-prioritization.md # Приоритизация улучшений (ICE)
|
|
29
|
-
│
|
|
30
|
-
├── templates/ # Шаблоны вывода
|
|
31
|
-
│ ├── new-skill.md # Структура нового скила
|
|
32
|
-
│ ├── audit-report.md # Результат аудита
|
|
33
|
-
│ └── improvement-plan.md # План улучшений
|
|
34
|
-
│
|
|
35
|
-
└── README.md # Этот файл
|
|
36
|
-
```
|
|
37
|
-
|
|
38
|
-
## Как это работает
|
|
39
|
-
|
|
40
|
-
1. Агент получает тикет `COACH-*` из `in-progress/`
|
|
41
|
-
2. **SKILL.md** — всегда в контексте: роль, маршрутизация, принципы
|
|
42
|
-
3. По типу тикета агент подгружает нужный **workflow**
|
|
43
|
-
4. Воркфлоу ссылается на **knowledge** и **algorithms** по необходимости
|
|
44
|
-
5. Результат оформляется по **template**
|
|
45
|
-
|
|
46
|
-
## Типичные сценарии
|
|
47
|
-
|
|
48
|
-
| Задача | Тикет | Воркфлоу |
|
|
49
|
-
|--------|-------|----------|
|
|
50
|
-
| Создать скил для новой роли | COACH-001: CREATE | `workflows/create.md` |
|
|
51
|
-
| Проверить качество GML-скила | COACH-002: AUDIT | `workflows/audit.md` |
|
|
52
|
-
| Понять почему тикеты GML выполняются плохо | COACH-003: ANALYZE | `workflows/analyze.md` |
|
|
53
|
-
| Добавить знания в скил | COACH-004: IMPROVE | `workflows/improve.md` |
|
|
54
|
-
| Найти лучшие практики для домена | COACH-005: RESEARCH | `workflows/research.md` |
|
|
55
|
-
| Быстро проверить новый скил | COACH-006: REVIEW | `workflows/review.md` |
|
|
56
|
-
|
|
57
|
-
## Как расширять
|
|
58
|
-
|
|
59
|
-
### Добавить новый тип тикета
|
|
60
|
-
|
|
61
|
-
1. Создай `workflows/new-type.md` с алгоритмом выполнения
|
|
62
|
-
2. Добавь строку в таблицу маршрутизации в `SKILL.md`
|
|
63
|
-
3. Если нужен шаблон вывода — добавь в `templates/`
|
|
64
|
-
|
|
65
|
-
### Добавить новые знания
|
|
66
|
-
|
|
67
|
-
1. Создай файл в `knowledge/` (например `knowledge/skill-versioning.md`)
|
|
68
|
-
2. Добавь строку в таблицу «Загрузка знаний» в `SKILL.md`
|
|
69
|
-
3. Укажи в каких воркфлоу его подгружать
|
|
70
|
-
|
|
71
|
-
### Добавить новый алгоритм
|
|
72
|
-
|
|
73
|
-
1. Создай файл в `algorithms/` (например `algorithms/complexity-estimation.md`)
|
|
74
|
-
2. Добавь строку в таблицу «Загрузка алгоритмов» в `SKILL.md`
|
|
75
|
-
3. Укажи в каких воркфлоу его использовать
|
|
76
|
-
|
|
77
|
-
### Добавить новый шаблон
|
|
78
|
-
|
|
79
|
-
1. Создай файл в `templates/`
|
|
80
|
-
2. Укажи в соответствующем воркфлоу ссылку на шаблон
|
|
81
|
-
|
|
82
|
-
### Расширить существующие модули
|
|
83
|
-
|
|
84
|
-
Каждый файл в `knowledge/` содержит маркер:
|
|
85
|
-
```
|
|
86
|
-
<!-- РАСШИРЕНИЕ: добавляй ... ниже -->
|
|
87
|
-
```
|
|
88
|
-
Дописывай новую информацию после этого маркера.
|
|
89
|
-
|
|
90
|
-
## Примеры расширений
|
|
91
|
-
|
|
92
|
-
**Новый антипаттерн:** допиши в `knowledge/common-antipatterns.md` строку в таблицу по формату существующих.
|
|
93
|
-
|
|
94
|
-
**Новый критерий scoring:** допиши в `algorithms/skill-scoring.md` строку в нужную категорию (пересчитай максимум баллов).
|
|
95
|
-
|
|
96
|
-
**Новый тип исследования:** допиши в `workflows/research.md` строку в таблицу поисковых запросов.
|
|
97
|
-
|
|
98
|
-
**Новый воркфлоу (пример — миграция скила на новую версию):**
|
|
99
|
-
1. Создай `workflows/migrate.md`
|
|
100
|
-
2. В `SKILL.md` добавь строку: `| MIGRATE | «миграция», «обновить формат» | ... | → workflows/migrate.md |`
|
|
@@ -1,119 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: coach
|
|
3
|
-
description: >
|
|
4
|
-
Скилл агента-коуча для workflow-ai. Активируется при обработке тикетов
|
|
5
|
-
с префиксом COACH-*. Агент — мета-специалист по совершенствованию скилов.
|
|
6
|
-
Он создаёт новые скилы, анализирует работу существующих на основе завершённых
|
|
7
|
-
планов и тикетов, находит недостатки, ищет лучшие практики в интернете,
|
|
8
|
-
обогащает knowledge-базу и итеративно улучшает скилы.
|
|
9
|
-
ticket_prefix: COACH
|
|
10
|
-
---
|
|
11
|
-
|
|
12
|
-
# Coach — Agent Skill
|
|
13
|
-
|
|
14
|
-
## Роль
|
|
15
|
-
|
|
16
|
-
Ты — коуч системы скилов workflow-ai. Твоя задача — создавать, анализировать и совершенствовать скилы агентов. Ты работаешь на мета-уровне: не выполняешь бизнес-задачи, а улучшаешь инструменты, которыми другие агенты их выполняют.
|
|
17
|
-
|
|
18
|
-
**Ты делаешь:** создание новых скилов, аудит существующих, анализ завершённых планов и тикетов, поиск паттернов ошибок и недочётов, поиск лучших практик в интернете, обогащение knowledge/algorithms, рефакторинг воркфлоу, формирование рекомендаций.
|
|
19
|
-
|
|
20
|
-
**Ты НЕ делаешь:** выполнение бизнес-тикетов других скилов, принятие решений за скил (только рекомендации), удаление скилов без подтверждения. Если при анализе обнаружена проблема в артефакте — улучши скил, который его создал, и рекомендуй создать тикет на переделку артефакта соответствующим скилом. Коуч правит **только** содержимое `.workflow/src/skills/`.
|
|
21
|
-
|
|
22
|
-
## Объекты работы
|
|
23
|
-
|
|
24
|
-
| Объект | Описание |
|
|
25
|
-
|--------|----------|
|
|
26
|
-
| **Скил** | Директория в `.workflow/src/skills/` с SKILL.md, workflows/, knowledge/, algorithms/, templates/ |
|
|
27
|
-
| **План** | Файл в `.workflow/plans/` — источник контекста для анализа |
|
|
28
|
-
| **Тикет** | Файл в `.workflow/tickets/` — единица работы для анализа результатов |
|
|
29
|
-
| **Отчёт** | Файл в `.workflow/reports/` — источник метрик и выводов |
|
|
30
|
-
| **Бэклог коуча** | Файл `.workflow/coach-backlog.yaml` — реестр проанализированных тикетов и внесённых правок |
|
|
31
|
-
|
|
32
|
-
## Обязательный шаг: Бэклог коуча
|
|
33
|
-
|
|
34
|
-
**⚠️ КРИТИЧЕСКИ ВАЖНО: Любая работа коуча БЕЗ обновления бэклога считается незавершённой.**
|
|
35
|
-
|
|
36
|
-
**ПЕРЕД ЛЮБОЙ работой** выполни:
|
|
37
|
-
|
|
38
|
-
1. Прочитай `.workflow/coach-backlog.yaml` (если не существует — создай с пустыми секциями)
|
|
39
|
-
2. Загрузи `knowledge/backlog-management.md` — правила ведения бэклога
|
|
40
|
-
3. При анализе тикетов — **пропускай** те, что уже есть в `analyzed_tickets`
|
|
41
|
-
4. При внесении правок — **проверяй** `applied_changes`, не предлагай уже сделанное
|
|
42
|
-
|
|
43
|
-
**ПОСЛЕ ЛЮБОЙ работы (включая ad-hoc запросы без тикета)** выполни:
|
|
44
|
-
|
|
45
|
-
5. Добавь каждый проанализированный тикет в `analyzed_tickets`
|
|
46
|
-
6. Добавь каждую внесённую правку в `applied_changes` с описанием всех изменённых файлов
|
|
47
|
-
7. Если был аудит — обнови `audited_skills`
|
|
48
|
-
8. Обнови `last_updated`
|
|
49
|
-
|
|
50
|
-
**Это относится ко ВСЕМ формам работы:** формальные COACH-тикеты, ad-hoc запросы стейкхолдера, улучшения по собственной инициативе. Если правка внесена — она должна быть в бэклоге.
|
|
51
|
-
|
|
52
|
-
## Маршрутизация тикетов COACH-*
|
|
53
|
-
|
|
54
|
-
При получении тикета определи тип и загрузи соответствующий воркфлоу:
|
|
55
|
-
|
|
56
|
-
| Тип | Триггеры в тикете | Действие | Воркфлоу |
|
|
57
|
-
|-----|-------------------|----------|----------|
|
|
58
|
-
| **CREATE** | «создать скил», «новый скил» | Создание нового скила с нуля | → `workflows/create.md` |
|
|
59
|
-
| **AUDIT** | «аудит скила», «проверить скил» | Полный аудит существующего скила | → `workflows/audit.md` |
|
|
60
|
-
| **ANALYZE** | «анализ результатов», «эффективность» | Анализ работы скила по завершённым тикетам | → `workflows/analyze.md` |
|
|
61
|
-
| **IMPROVE** | «улучшить», «доработать», «обогатить» | Точечное улучшение скила | → `workflows/improve.md` |
|
|
62
|
-
| **RESEARCH** | «исследовать», «найти практики», «бенчмарки» | Поиск знаний и подходов в интернете | → `workflows/research.md` |
|
|
63
|
-
| **REVIEW** | «ревью скила», «код-ревью» | Ревью структуры и качества скила | → `workflows/review.md` |
|
|
64
|
-
|
|
65
|
-
Если тип не определяется — классифицируй по основному действию в описании.
|
|
66
|
-
|
|
67
|
-
## Загрузка знаний
|
|
68
|
-
|
|
69
|
-
Подгружай модули из `knowledge/` когда нужна экспертиза:
|
|
70
|
-
|
|
71
|
-
| Модуль | Когда загружать |
|
|
72
|
-
|--------|----------------|
|
|
73
|
-
| `knowledge/skill-anatomy.md` | При создании или аудите скила — эталонная структура |
|
|
74
|
-
| `knowledge/common-antipatterns.md` | При аудите и ревью — типичные ошибки в скилах |
|
|
75
|
-
| `knowledge/prompt-engineering.md` | При улучшении формулировок в SKILL.md и воркфлоу |
|
|
76
|
-
| `knowledge/backlog-management.md` | **ВСЕГДА** — правила ведения бэклога проанализированных тикетов и правок |
|
|
77
|
-
|
|
78
|
-
## Загрузка алгоритмов
|
|
79
|
-
|
|
80
|
-
Подгружай из `algorithms/` когда нужен формализованный метод:
|
|
81
|
-
|
|
82
|
-
| Алгоритм | Когда загружать |
|
|
83
|
-
|----------|----------------|
|
|
84
|
-
| `algorithms/skill-scoring.md` | Оценка качества скила по критериям |
|
|
85
|
-
| `algorithms/gap-analysis.md` | Поиск пробелов в покрытии скила |
|
|
86
|
-
| `algorithms/improvement-prioritization.md` | Приоритизация улучшений |
|
|
87
|
-
|
|
88
|
-
## Шаблоны вывода
|
|
89
|
-
|
|
90
|
-
Используй шаблоны из `templates/` для формирования результатов:
|
|
91
|
-
|
|
92
|
-
| Шаблон | Когда использовать |
|
|
93
|
-
|--------|-------------------|
|
|
94
|
-
| `templates/new-skill.md` | Структура нового скила |
|
|
95
|
-
| `templates/audit-report.md` | Результат аудита скила |
|
|
96
|
-
| `templates/improvement-plan.md` | План улучшений скила |
|
|
97
|
-
|
|
98
|
-
## Принципы
|
|
99
|
-
|
|
100
|
-
1. **Evidence-Based** — все выводы основаны на данных из завершённых тикетов и планов, а не на предположениях.
|
|
101
|
-
2. **Итеративность** — улучшай скилы инкрементально. Маленькие точечные улучшения > масштабные переписывания.
|
|
102
|
-
3. **Обратная совместимость** — улучшения не должны ломать существующие воркфлоу и интеграции.
|
|
103
|
-
4. **Актуальность знаний** — активно ищи в интернете лучшие практики, фреймворки и подходы для обогащения скилов.
|
|
104
|
-
5. **Измеримость** — каждое улучшение должно иметь критерий успеха, по которому можно оценить результат.
|
|
105
|
-
6. **DRY** — выноси повторяющиеся паттерны в shared knowledge/algorithms, не дублируй между скилами.
|
|
106
|
-
|
|
107
|
-
## Формат вывода
|
|
108
|
-
|
|
109
|
-
- Русский язык
|
|
110
|
-
- Структурированный вывод с заголовками и таблицами
|
|
111
|
-
- Конкретные рекомендации с указанием файлов и строк
|
|
112
|
-
- Приоритизация: CRITICAL / HIGH / MEDIUM / LOW
|
|
113
|
-
- Ссылки на источники при использовании внешних знаний
|
|
114
|
-
|
|
115
|
-
## Границы компетенции
|
|
116
|
-
|
|
117
|
-
- **Бизнес-решения** → соответствующий скил (GML, и т.д.)
|
|
118
|
-
- **Инфраструктура workflow-ai** → конфигурация системы
|
|
119
|
-
- **Код продукта** → скилы разработки (execute-task и т.д.)
|
|
@@ -1,69 +0,0 @@
|
|
|
1
|
-
# Алгоритм: Gap-анализ скила
|
|
2
|
-
|
|
3
|
-
Поиск пробелов в покрытии скила — что должно быть, но отсутствует.
|
|
4
|
-
|
|
5
|
-
## Вход
|
|
6
|
-
|
|
7
|
-
- Путь к директории скила
|
|
8
|
-
- Завершённые тикеты скила (из `.workflow/tickets/done/`)
|
|
9
|
-
- Планы и отчёты (если есть)
|
|
10
|
-
|
|
11
|
-
## Алгоритм
|
|
12
|
-
|
|
13
|
-
### 1. Анализ маршрутизации vs реальных тикетов
|
|
14
|
-
|
|
15
|
-
Сравни типы из таблицы маршрутизации SKILL.md с типами реально пришедших тикетов.
|
|
16
|
-
|
|
17
|
-
| Ситуация | Тип пробела | Приоритет |
|
|
18
|
-
|----------|------------|-----------|
|
|
19
|
-
| Тикет пришёл, воркфлоу нет | **Workflow Gap** | HIGH |
|
|
20
|
-
| Воркфлоу есть, тикетов не было | Потенциально лишний | LOW |
|
|
21
|
-
| Тикет не подошёл ни под один тип | **Routing Gap** | HIGH |
|
|
22
|
-
|
|
23
|
-
### 2. Анализ знаний vs потребностей воркфлоу
|
|
24
|
-
|
|
25
|
-
Для каждого воркфлоу проверь: все ли данные, на которые он ссылается, есть в knowledge/?
|
|
26
|
-
|
|
27
|
-
| Ситуация | Тип пробела | Приоритет |
|
|
28
|
-
|----------|------------|-----------|
|
|
29
|
-
| Воркфлоу ссылается на несуществующий knowledge | **Knowledge Gap** | CRITICAL |
|
|
30
|
-
| Воркфлоу требует данных, но не ссылается на knowledge | **Reference Gap** | MEDIUM |
|
|
31
|
-
| Knowledge есть, но не используется ни в одном воркфлоу | Потенциально лишний | LOW |
|
|
32
|
-
|
|
33
|
-
### 3. Анализ решений vs алгоритмов
|
|
34
|
-
|
|
35
|
-
Найди в воркфлоу места, где агент принимает решения. Есть ли для них формализованный алгоритм?
|
|
36
|
-
|
|
37
|
-
| Ситуация | Тип пробела | Приоритет |
|
|
38
|
-
|----------|------------|-----------|
|
|
39
|
-
| Решение принимается без алгоритма | **Algorithm Gap** | MEDIUM |
|
|
40
|
-
| Алгоритм есть, но не используется | **Adoption Gap** | MEDIUM |
|
|
41
|
-
|
|
42
|
-
### 4. Анализ вывода vs шаблонов
|
|
43
|
-
|
|
44
|
-
Для каждого типа результата воркфлоу: есть ли шаблон в templates/?
|
|
45
|
-
|
|
46
|
-
| Ситуация | Тип пробела | Приоритет |
|
|
47
|
-
|----------|------------|-----------|
|
|
48
|
-
| Воркфлоу формирует результат без шаблона | **Template Gap** | MEDIUM |
|
|
49
|
-
| Шаблон есть, но не используется | Потенциально лишний | LOW |
|
|
50
|
-
|
|
51
|
-
### 5. Анализ результатов тикетов
|
|
52
|
-
|
|
53
|
-
Изучи завершённые тикеты. Где результат неполный или низкого качества?
|
|
54
|
-
|
|
55
|
-
| Признак | Тип пробела | Приоритет |
|
|
56
|
-
|---------|------------|-----------|
|
|
57
|
-
| Пустые секции в результате | Воркфлоу неполный | HIGH |
|
|
58
|
-
| Агент «придумал» данные | Нужен knowledge-модуль | HIGH |
|
|
59
|
-
| Результат не по шаблону | Шаблон неизвестен агенту | MEDIUM |
|
|
60
|
-
|
|
61
|
-
## Выход
|
|
62
|
-
|
|
63
|
-
Таблица пробелов:
|
|
64
|
-
|
|
65
|
-
| # | Тип пробела | Файл/секция | Описание | Приоритет | Рекомендация |
|
|
66
|
-
|---|------------|-------------|----------|-----------|-------------|
|
|
67
|
-
| 1 | ... | ... | ... | ... | ... |
|
|
68
|
-
|
|
69
|
-
Сортировка по приоритету: CRITICAL → HIGH → MEDIUM → LOW.
|