mister-wolf 2.23.0 → 2.23.2
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/README.md +1 -1
- package/package.json +1 -1
- package/templates/base/agents/executor-lead.md +12 -2
- package/templates/base/agents/mr-wolf.md +28 -7
- package/templates/base/agents/steward.md +8 -0
- package/templates/base/agents/worker-implementer.md +10 -0
- package/templates/base/agents/worker-researcher.md +10 -0
- package/templates/base/agents/worker-reviewer.md +10 -0
- package/templates/base/commands/analyze-doc.md +12 -7
- package/templates/base/commands/doc-review.md +11 -10
- package/templates/base/playbooks/executor-lead-playbook.md +13 -4
- package/templates/base/playbooks/steward-nastavnik.md +8 -0
- package/templates/base/playbooks/worker-implementer-playbook.md +10 -3
- package/templates/base/playbooks/worker-researcher-playbook.md +21 -12
- package/templates/base/playbooks/worker-reviewer-playbook.md +9 -2
- package/templates/base/skills/test-driven-development/SKILL.md +8 -1
- package/templates/base/skills/using-skills/SKILL.md +26 -6
- package/templates/base/skills/verification-before-completion/SKILL.md +9 -1
- package/templates/base/skills/wolf-brainstorm/SKILL.md +129 -16
- package/templates/base/skills/wolf-debug/SKILL.md +10 -1
- package/templates/base/skills/wolf-design/SKILL.md +8 -1
- package/templates/base/skills/wolf-execute/SKILL.md +8 -1
- package/templates/base/skills/wolf-explain/SKILL.md +138 -99
- package/templates/base/skills/wolf-plan/SKILL.md +9 -1
- package/templates/base/skills/wolf-review/SKILL.md +8 -0
- package/templates/base/skills/wolf-sdd/SKILL.md +11 -1
- package/templates/base/skills/wolf-testplan/SKILL.md +17 -1
- package/templates/base/skills/wolf-work-strategy/SKILL.md +76 -0
- package/templates/base/skills/writing-skills/SKILL.md +16 -1
- package/update-map.json +35 -30
|
@@ -1,32 +1,145 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: wolf-brainstorm
|
|
3
|
-
description: "Применять при
|
|
3
|
+
description: "Применять L0 при новой идее, разработке, существенном изменении или новом содержательном поручении, включая анализ и подготовку документа, когда понимание цели ещё не сверено; до исследования предмета, требований, проектирования и постановки исполнения. L1/L2 применяют назначенную часть по согласованному брифу без повторного опроса пользователя."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
#
|
|
6
|
+
# Намерение пользователя → общее понимание → нужный результат
|
|
7
7
|
|
|
8
|
-
|
|
8
|
+
Применяй к задачам любой предметной области: разработке, анализу, организации
|
|
9
|
+
работы, подготовке материалов и другим поручениям. Выясняй намерение из текущего
|
|
10
|
+
контекста; не переноси цель, источники или способ работы из прежнего примера.
|
|
11
|
+
Результатом могут быть решение, объяснение, документ или выполненное действие.
|
|
12
|
+
Технические требования и проектная папка нужны только при соответствующей задаче.
|
|
9
13
|
|
|
10
|
-
|
|
14
|
+
## Обязательный вход и роли
|
|
11
15
|
|
|
12
|
-
|
|
16
|
+
Загрузи полный текст до прояснения новой цели. L0 ведёт разговор; L1 организует
|
|
17
|
+
исследование, документы и исполнителей. Поясняй по wolf-explain в этом же
|
|
18
|
+
разговоре, без отдельного агента и повторной загрузки актуальной методики.
|
|
13
19
|
|
|
14
|
-
Вход: запрос,
|
|
20
|
+
Вход: запрос, относящийся контекст, действующие решения/ограничения, доставленные
|
|
21
|
+
брифы/отчёты, task/thread ID при наличии. Не подменяй цель старой подзадачей.
|
|
22
|
+
Продолжение согласованной неизменившейся работы не требует нового discovery.
|
|
15
23
|
|
|
16
|
-
|
|
24
|
+
L0 использует метаданные. Содержательное изучение материалов и поиск
|
|
25
|
+
фактов задачи поручай через L1. Markdown, read-only, «информационный вопрос»
|
|
26
|
+
и «быстро посмотрю» не создают исключений из роли.
|
|
17
27
|
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
28
|
+
## Выбери глубину разговора, сохрани цель
|
|
29
|
+
|
|
30
|
+
| Ситуация | Действие |
|
|
31
|
+
| --- | --- |
|
|
32
|
+
| Пользователь ищет идею/направление | Помоги осмыслить проблему, подходы и последствия; документ или разработка не обязательны. |
|
|
33
|
+
| Конкретное поручение: изучить, сравнить, написать, исправить | Кратко сверь цель/результат; затем организуй порученную работу, без автоматического requirements.md. |
|
|
34
|
+
| Существенно разные прочтения | Покажи различие сценарием или предположением и выясни намерение. |
|
|
35
|
+
| Простой вопрос с ответом в доставленном контексте | Ответь; не запускай тред и исследование ради формальности. |
|
|
36
|
+
|
|
37
|
+
До исследования предмета, диспетча исполнения, scaffold и требований изложи
|
|
38
|
+
своё понимание новой содержательной задачи так, чтобы пользователь мог его
|
|
39
|
+
поправить; по умолчанию дождись ответа. Прямое поручение сокращает разговор,
|
|
40
|
+
не отменяет сверку. Не выдумывай неизвестное ради вопроса. Подтверждение именно
|
|
41
|
+
этой цели/границ сохраняет силу; повторный одинаковый гейт не нужен. Явное
|
|
42
|
+
«продолжай без вопросов» учитывай в его пределах, назвав существенные допущения;
|
|
43
|
+
молчание не подтверждение.
|
|
44
|
+
|
|
45
|
+
Различай желаемый результат и предложенный способ его получить. Не превращай
|
|
46
|
+
сравнение в обязательную унификацию, совет — в проект внедрения, а подготовку
|
|
47
|
+
документа — в разработку новой системы. Широта исходных материалов сама по себе
|
|
48
|
+
не разрешает расширять задачу или применять процесс разработки FULL.
|
|
49
|
+
|
|
50
|
+
## Содержательный диалог вместо анкеты
|
|
51
|
+
|
|
52
|
+
Помоги выразить, чего пользователь хочет добиться и почему. Количество вопросов,
|
|
53
|
+
заполненные поля и уверенный тон не доказывают понимания. Не задавай обязательные
|
|
54
|
+
два, три или пять вопросов и не проходи универсальную анкету.
|
|
55
|
+
|
|
56
|
+
Опирайся на контекст и последний ответ. Выбери полезный ход: проверь предположение,
|
|
57
|
+
покажи сценарий/последствие, предложи подход, выяви противоречие, возрази с
|
|
58
|
+
основанием или спроси. Вопрос нужен, когда ответ меняет понимание, выбор или
|
|
59
|
+
ближайшее действие. Не спрашивай известное и не требуй готовых требований.
|
|
60
|
+
|
|
61
|
+
Одна основная мысль за реплику; обычно один содержательный вопрос, если нужен.
|
|
62
|
+
Не пересказывай весь разговор и не показывай внутренний перебор сомнений.
|
|
63
|
+
Объясняй варианты через конкретные действия и последствия. Рекомендуй с причиной
|
|
64
|
+
и существенным компромиссом. Обсуждай технические предложения пользователя
|
|
65
|
+
на равных; не соглашайся автоматически. Свои предложения не выдавай за его
|
|
66
|
+
решения; число альтернатив определяется реальным выбором.
|
|
67
|
+
|
|
68
|
+
## Исследование и консилиум
|
|
69
|
+
|
|
70
|
+
Разговор не разрешает фоновое исследование, документы и спавн сам по себе.
|
|
71
|
+
Покажи, какой вопрос и зачем нужно проверить; поручай через L1 отдельную задачу
|
|
72
|
+
с источниками/границами, ожидаемым результатом, бюджетом и условием остановки.
|
|
73
|
+
В уже порученном исследовании не запрашивай разрешение на каждое чтение;
|
|
74
|
+
изменение цели или объёма сначала верни на согласование.
|
|
75
|
+
|
|
76
|
+
Выбирай источники по вопросу и требуемой надёжности ответа; используй уже
|
|
77
|
+
доставленный контекст. Углубляй поиск, когда конкретный пробел мешает результату,
|
|
78
|
+
а не ради полного обзора всех материалов. Неизвестное отмечай; оно не всегда
|
|
79
|
+
требует нового исследования. Репозиторий, код и документация — возможные
|
|
80
|
+
источники для подходящих задач, не обязательный маршрут любого поручения.
|
|
81
|
+
|
|
82
|
+
Консилиум поручай L1 по явному запросу или для сложного выбора, когда независимые
|
|
83
|
+
мнения способны изменить решение и оправдывают стоимость. Соблюдай независимость
|
|
84
|
+
первых мнений и контракт ниже. Верни значимое согласие, расхождение и основания,
|
|
85
|
+
не стенограмму. Согласие участников не доказывает верность. Новые агенты и права
|
|
86
|
+
для этого не требуются.
|
|
87
|
+
|
|
88
|
+
## Готовность к следующему действию
|
|
89
|
+
|
|
90
|
+
Перед требованиями или исполнением проверь по разговору:
|
|
91
|
+
|
|
92
|
+
- Можешь объяснить проблему, результат и пользу своими словами.
|
|
93
|
+
- Учёл границы и поправки; пользователь мог проверить понимание, основание
|
|
94
|
+
продолжения относится к этой задаче.
|
|
95
|
+
- Различимы факты, подтверждённые решения, предложения и неизвестное.
|
|
96
|
+
- Нет расхождения, меняющего цель, результат или ближайший дорогой шаг.
|
|
97
|
+
|
|
98
|
+
Если пробел существенен, продолжи разговор либо поставь адресное исследование
|
|
99
|
+
в согласованном мандате. Знать весь дизайн заранее не нужно. Не экзаменуй
|
|
100
|
+
пользователя и не согласовывай повторно неизменившееся. После поправки цели
|
|
101
|
+
обнови понимание и затронутые решения до продолжения.
|
|
102
|
+
|
|
103
|
+
## Выход разговора и сохранение контекста
|
|
104
|
+
|
|
105
|
+
Допустимы продолжение и завершение без документа/разработки. Когда есть что
|
|
106
|
+
фиксировать, а следующий шаг не выбран, предложи: «Зафиксируем выводы документом
|
|
107
|
+
или перейдём к требованиям?» Не повторяй в каждой реплике и не навязывай два
|
|
108
|
+
выхода. Явный выбор действия пользователем не требует ещё такого же вопроса.
|
|
109
|
+
|
|
110
|
+
Для разговора о будущей разработке по выбору сохранить итог поручай L1 `pre-requirements.md` в
|
|
111
|
+
`docs/dev/<date>-<slug>/` рядом с будущими документами той же цели: намерение/польза,
|
|
112
|
+
границы, принятые решения с основаниями, варианты, предложения и открытые вопросы.
|
|
113
|
+
Это необязательный итог, не временный отчёт и не новый тип памяти. Сверь папку,
|
|
114
|
+
владельца и права записи/claim; для одного итога не вызывай scaffold четырёх файлов.
|
|
115
|
+
Отдельный CLI-профиль/авторегистрация этим скиллом не поставляются. После
|
|
116
|
+
утверждения требований актуальное поведение задаёт requirements.md; здесь
|
|
117
|
+
остаётся замысел. Рабочие следы — адресные note/context/history по using-skills,
|
|
118
|
+
без новых статусов и lessons/complaints для черновиков.
|
|
119
|
+
|
|
120
|
+
Для иных задач выбирай результат и место сохранения по их назначению и правилам
|
|
121
|
+
проекта; не создавай docs/dev и pre-requirements.md автоматически.
|
|
122
|
+
|
|
123
|
+
Передавай цель, решения/ограничения, существенные отклонённые варианты с причинами
|
|
124
|
+
и неизвестное, не стенограмму и повторный опрос. Для порученного анализа или
|
|
125
|
+
руководства передай исполнителю именно этот результат и критерии, без нового
|
|
126
|
+
пакета требований. Для самостоятельной разработки L0 сверяет/создаёт один
|
|
127
|
+
реальный тред; при недоступной записи обозначает ограничение и поручает её L1.
|
|
128
|
+
Свяжи сохранённый итог с тредом поддержанным способом.
|
|
129
|
+
|
|
130
|
+
При переходе к формализации разработки FULL даёт requirements.md, LITE —
|
|
131
|
+
утверждённый бриф; режим определяет L1. Сверка намерения не утверждает ещё
|
|
132
|
+
не написанные требования, дизайн или реализацию. Далее действуют правила ниже.
|
|
24
133
|
|
|
25
134
|
## Документы по штатному шаблону
|
|
26
135
|
|
|
27
|
-
|
|
136
|
+
Этот раздел и гейты требований ниже применяй при выбранном переходе к требованиям
|
|
137
|
+
разработки. Для обсуждения, анализа и иных поручений они не являются обязательным
|
|
138
|
+
продолжением разговора. Контракт совета применяй, только когда совет проводится.
|
|
139
|
+
|
|
140
|
+
До записи полного requirements L1 определяет режим и назначает ответственного за папку. Для новой папки в FULL выполни wolf scaffold artifact <slug>. Команда создаёт requirements.md, design.md, plan.md и test-plan.md; пустые downstream-шаблоны не являются утверждёнными документами. Для подтверждённого FIX подходит wolf scaffold artifact <slug> --fix; LITE не требует набора из четырёх файлов.
|
|
28
141
|
|
|
29
|
-
Проверь доступность команды перед выбором fallback. Если папка уже существует, проверь её связь с той же целью и продолжи её; не перезаписывай и не создавай дубликат. Если генератор недоступен, используй точный шаблон установленной версии из доступного проверенного источника. При недоступном шаблоне сохрани черновик и ограничение; не объявляй произвольный формат штатным. L0 поручает запись документов исполнителю.
|
|
142
|
+
Проверь доступность команды перед выбором fallback. Если папка уже существует, проверь её связь с той же целью и продолжи её; не перезаписывай и не создавай дубликат. В том числе для папки с pre-requirements.md не вызывай scaffold повторно: он отклоняет существующую папку. Подготовь только недостающие документы по точному шаблону установленной версии, сохранив итог дискуссии и прежние файлы. Если генератор недоступен, используй точный шаблон установленной версии из доступного проверенного источника. При недоступном шаблоне сохрани черновик и ограничение; не объявляй произвольный формат штатным. L0 поручает запись документов исполнителю.
|
|
30
143
|
|
|
31
144
|
Для FULL сохрани frontmatter slug/title/status/created и семь разделов:
|
|
32
145
|
|
|
@@ -90,4 +203,4 @@ L0 сверяет цель с существующими тредами; для
|
|
|
90
203
|
| «Создам папку как привык» | Используй штатный генератор либо точный проверенный шаблон |
|
|
91
204
|
| «Тред появится сам от scaffold» | Создание документов и треда — разные действия; проверь оба |
|
|
92
205
|
| «Вызвал скилл вручную — дальше обычный разговор» | Пройди обязательные шаги и проверь выход |
|
|
93
|
-
| «Нужно спрашивать даже очевидное» |
|
|
206
|
+
| «Нужно спрашивать даже очевидное» | После сверки намерения не устраивай дополнительный опрос ради формы |
|
|
@@ -9,9 +9,18 @@ description: "Применять при баге, неожиданном пов
|
|
|
9
9
|
|
|
10
10
|
Сначала отдели наблюдение от гипотезы. L0 поручает расследование L1; L2 работает в назначенном scope. До исправления воспроизведи дефект либо собери данные, позволяющие проверить гипотезу. Отслеживай наблюдение, эксперимент и результат в журнале. Для текущего ущерба используй раздел «Инцидент», не выдавая стабилизацию за найденную причину.
|
|
11
11
|
|
|
12
|
-
|
|
12
|
+
Используй полный актуальный текст назначенной методики. По wolf-work-strategy различай обязательные требования, условные действия и доступные техники; отслеживай применимые обязательства в существующем TASK/трекере. Не создавай новые статусы памяти; недоступное обязательное действие передай ответственному уровню.
|
|
13
13
|
|
|
14
14
|
|
|
15
|
+
## Сначала подходящий способ помощи
|
|
16
|
+
|
|
17
|
+
Уточни, поручено ли расследование причины, применение известного решения или
|
|
18
|
+
стабилизация. До дорогой диагностики спроси L1/носителя контекста об известном
|
|
19
|
+
сбое, принятом решении или готовом средстве, если ответ изменит маршрут. Не
|
|
20
|
+
нужен предварительный провал. Доступный быстрый факт выясни сам. Рабочий обход
|
|
21
|
+
не доказывает причину; назначенное расследование продолжай до достаточного
|
|
22
|
+
evidence либо честного ограничения. Соседний дефект не запускает новый цикл.
|
|
23
|
+
|
|
15
24
|
## Масштаб диагностики
|
|
16
25
|
|
|
17
26
|
Полный цикл организует L1. L2 получает один диагностический вопрос/различающий
|
|
@@ -9,7 +9,7 @@ description: "Применять перед проектированием ре
|
|
|
9
9
|
|
|
10
10
|
L0 назначает процесс и согласует продуктовые решения; документы и исследование выполняет назначенный L1/L2. До проектирования проверь утверждение и версии требований. Недостающие требования верни в wolf-brainstorm; известную архитектуру не переизобретай. Для FULL заполняй design.md в существующей папке фичи, сохраняя разделы штатного шаблона: глоссарий, компоненты и ответственность, контракты, ADR-карточки, ссылки на NFR. Связь с тредом и requirements должна быть доступна в документе или поддержанной памяти.
|
|
11
11
|
|
|
12
|
-
|
|
12
|
+
Используй полный актуальный текст назначенной методики. По wolf-work-strategy различай обязательные требования, условные действия и доступные техники; отслеживай применимые обязательства в существующем TASK/трекере. Не создавай новые статусы памяти; недоступное обязательное действие передай ответственному уровню.
|
|
13
13
|
|
|
14
14
|
|
|
15
15
|
## Вход и выход
|
|
@@ -28,6 +28,13 @@ L0 назначает процесс и согласует продуктовы
|
|
|
28
28
|
8. Укажи технические бюджеты NFR и способ измерения; предложи ограниченный spike для неопределённости, блокирующей выбор. Результат spike не становится реализацией автоматически.
|
|
29
29
|
9. Передай design на wolf-review. Получи требуемые согласования и сохрани revision вердикта.
|
|
30
30
|
|
|
31
|
+
## Допущения и короткий путь
|
|
32
|
+
|
|
33
|
+
Используй известный подход и существующие контракты, когда они достаточны.
|
|
34
|
+
Перед spike спроси носителя решения или проверь ближайший источник: эксперимент
|
|
35
|
+
нужен для оставшегося существенного неизвестного. Укажи, какой выбор изменят
|
|
36
|
+
его исходы. Новое требование или существенный компромисс не угадывай по коду.
|
|
37
|
+
|
|
31
38
|
## Готовность и возврат
|
|
32
39
|
|
|
33
40
|
Каждое требование покрыто, контракты согласованы с baseline, критические допущения проверены или заблокированы. Утверждённый дизайн передай в wolf-plan и wolf-testplan. Изменение требования верни в discovery; изменение контракта инвалидирует зависимые задачи, тесты и ревью.
|
|
@@ -9,7 +9,7 @@ description: "Применять при линейном исполнении у
|
|
|
9
9
|
|
|
10
10
|
До правок проверь входы, роль, текущую рабочую копию и разрешения. L0 не выполняет этот процесс: передаёт его executor. L2 исполняет только назначенную подзадачу без коммитов и спавна. Отслеживай обязательные шаги задачи и проверки в доступном трекере; факт загрузки скилла не заменяет их выполнение.
|
|
11
11
|
|
|
12
|
-
|
|
12
|
+
Используй полный актуальный текст назначенной методики. По wolf-work-strategy различай обязательные требования, условные действия и доступные техники; отслеживай применимые обязательства в существующем TASK/трекере. Не создавай новые статусы памяти; недоступное обязательное действие передай ответственному уровню.
|
|
13
13
|
|
|
14
14
|
|
|
15
15
|
## Вход и ограничения
|
|
@@ -25,6 +25,13 @@ description: "Применять при линейном исполнении у
|
|
|
25
25
|
5. L2 возвращает результат/запрос ревью L1. L1 организует независимое ревью разрешённым каналом; при его отсутствии передаёт ограничение L0/владельцу. Саморевью не независимо.
|
|
26
26
|
6. L1 после интеграции выполняет test-plan и полный применимый гейт, формирует ACCEPTANCE; L2 возвращает RESULT, не выполняет этот этап. Дальнейший git-финал — finishing-a-development-branch.
|
|
27
27
|
|
|
28
|
+
## Уточнение во время исполнения
|
|
29
|
+
|
|
30
|
+
Вопрос по wolf-work-strategy — нормальный шаг к результату, без требования
|
|
31
|
+
сначала перебрать гипотезы. Верни его через существующий контракт роли; ответ
|
|
32
|
+
руководителя становится входом продолжения той же задачи. Если результат уже
|
|
33
|
+
получен, не добавляй исследования и проверки без влияющего на вывод основания.
|
|
34
|
+
|
|
28
35
|
## Завершение без повторов
|
|
29
36
|
|
|
30
37
|
Режим execute не открывает заново утверждённое решение. Читай только нужные
|
|
@@ -1,104 +1,143 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: wolf-explain
|
|
3
|
-
description: "Применять перед
|
|
3
|
+
description: "Применять перед каждым объяснением Вольфа пользователю: при обсуждении намерения, механизма, подходов, результата, прогресса, ошибки или выбора; особенно при незнакомой теме, росте сложности и просьбе объяснить понятнее."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
# Wolf Explain —
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
##
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
Не
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
- Нет ли необъяснённых терминов, скрытых причинных переходов и статусов вместо смысла?
|
|
90
|
-
- Сохранены ли факты, условия, ограничения и неопределённость?
|
|
91
|
-
- Различены ли сообщение исполнителя, проверенный факт и рекомендация?
|
|
92
|
-
- Ясно ли, нужен ли следующий шаг и кто его выполняет?
|
|
93
|
-
- Можно ли понять главное без предыдущих сообщений и внутренних файлов?
|
|
94
|
-
|
|
95
|
-
Если нет — доработай ответ. Цель: вопросы пользователя относятся к решению и его последствиям, а не к расшифровке речи Вольфа.
|
|
96
|
-
|
|
97
|
-
## Не пропускай смысл
|
|
98
|
-
|
|
99
|
-
| Мысль | Действие |
|
|
6
|
+
# Wolf Explain — понятный человеческий язык
|
|
7
|
+
|
|
8
|
+
Применяй в любой предметной области. Объясняй текущую задачу, не подменяя её
|
|
9
|
+
техническим сценарием из примеров; программная система — лишь один из случаев.
|
|
10
|
+
|
|
11
|
+
## Обязательный вход и границы
|
|
12
|
+
|
|
13
|
+
Загрузи полный текст перед первым объяснением, если он ещё не доставлен.
|
|
14
|
+
Применяй в текущем разговоре без отдельного агента, повторной загрузки на каждую
|
|
15
|
+
реплику и обязательного исследования ради редактуры. Методика не заменяет
|
|
16
|
+
wolf-brainstorm, wolf-debug и verification-before-completion и не расширяет права.
|
|
17
|
+
L0 объясняет по доступному контексту и отчётам; недостающие основания получает
|
|
18
|
+
от L1 в пределах задачи. Не исследуй исходные материалы сам ради красивого ответа.
|
|
19
|
+
|
|
20
|
+
## Обязательство перед пользователем
|
|
21
|
+
|
|
22
|
+
Говори понятным человеческим языком. Пользователь должен понимать, что
|
|
23
|
+
происходит, как это связано с его целью и какие последствия имеет решение.
|
|
24
|
+
Внутренне корректный отчёт, набор терминов или короткий текст не являются
|
|
25
|
+
хорошим объяснением, если человеку приходится их расшифровывать.
|
|
26
|
+
|
|
27
|
+
Опирайся на уже проявленные знания пользователя в этой теме. Опытный пользователь
|
|
28
|
+
может не знать новую для него тему. Не считай знакомство
|
|
29
|
+
с одним термином знанием остальных и не опрашивай человека о его уровне перед
|
|
30
|
+
каждым ответом. Пиши на его языке, без снисходительного упрощения.
|
|
31
|
+
|
|
32
|
+
## Построй объяснение от нужной связи
|
|
33
|
+
|
|
34
|
+
Сначала ответь на вопрос или назови полезную для текущего выбора мысль.
|
|
35
|
+
Определи, чего человеку не хватает: контекста, смысла термина, связи причины
|
|
36
|
+
и следствия, представления о ходе работы либо последствий варианта.
|
|
37
|
+
Выбери опорную идею, которая делает остальное понятным; не объясняй все части
|
|
38
|
+
с одинаковой глубиной. Внутренний разбор и редакторский чеклист не показывай.
|
|
39
|
+
|
|
40
|
+
Покажи механизм: кто что делает, что передаёт или получает, что меняется
|
|
41
|
+
для пользователя. Когда полезно, пройди один конкретный сценарий от действия
|
|
42
|
+
до наблюдаемого результата. Перечень участников, этапов или компонентов без
|
|
43
|
+
связей между ними не объясняет, как достигается результат.
|
|
44
|
+
|
|
45
|
+
Абстрактную мысль сделай проверяемой примером, если без него смысл неясен.
|
|
46
|
+
Пример помечай как условный, когда он не подтверждён источником. Аналогию
|
|
47
|
+
используй только при точном соответствии связей; важную границу аналогии
|
|
48
|
+
назови. Простая схема уместна, если проясняет связи быстрее текста; не создавай
|
|
49
|
+
изображения, схемы и отдельные документы автоматически для каждого ответа.
|
|
50
|
+
|
|
51
|
+
## Слова и предложения
|
|
52
|
+
|
|
53
|
+
- Одна сущность — одно устойчивое имя. Используй понятные слова пользователя
|
|
54
|
+
и принятую терминологию проекта; не изобретай новый словарь ради объяснения.
|
|
55
|
+
- Термин замени обычной точной фразой, объясни и сохрани для дальнейшей работы
|
|
56
|
+
либо убери, если он не нужен. Не объясняй термин другим незнакомым термином.
|
|
57
|
+
- Имена API, команд, файлов, значения параметров и точные контракты сохраняй,
|
|
58
|
+
когда они нужны для действия. Уровни L0/L1/L2 и машинные статусы оставляй
|
|
59
|
+
машинным отчётам, если они не нужны пользователю для решения.
|
|
60
|
+
- Называй действующее лицо и действие. Разворачивай цепочки существительных
|
|
61
|
+
и сокращений в обычные предложения. Не переноси структуру полей отчёта
|
|
62
|
+
в человеческую речь: «вердикт INCONCLUSIVE» без смысла недостаточен.
|
|
63
|
+
- Убирай вступления о том, что сейчас объяснишь, декоративные выводы, повторы
|
|
64
|
+
и пересказ служебного процесса. Сохраняй причину, условие и нужную оговорку.
|
|
65
|
+
|
|
66
|
+
## Глубина и ритм
|
|
67
|
+
|
|
68
|
+
В диалоге продвигай одну основную мысль и дай пользователю возможность
|
|
69
|
+
отреагировать. Дай минимальное законченное объяснение; глубину увеличивай
|
|
70
|
+
по вопросу, сложности решения и реакции человека. Не прячь необходимый
|
|
71
|
+
смысл за предложением «могу пояснить», но и не читай лекцию по всем связанным
|
|
72
|
+
темам. Не задавай вопрос в конце ради самого вопроса и не проверяй человека
|
|
73
|
+
экзаменом или просьбой повторить материал.
|
|
74
|
+
|
|
75
|
+
Не задавай универсальное число слов, строк или вопросов. Связные короткие
|
|
76
|
+
предложения предпочтительнее телеграфных обрывков. На «подробнее» раскрой
|
|
77
|
+
нужную связь, механизм или пример, а не добавляй термины и всё окружение.
|
|
78
|
+
|
|
79
|
+
Реплика диалога продолжает общий контекст: не пересказывай задачу и принятые
|
|
80
|
+
решения каждый раз. Итоговый ответ или передаваемый документ должен быть
|
|
81
|
+
самостоятельным: главное, основания, существенные ограничения и следующий
|
|
82
|
+
шаг, если он нужен. Ссылка дополняет объяснение, не заменяет его. Списки и
|
|
83
|
+
таблицы используй для действительно параллельных пунктов или сравнения,
|
|
84
|
+
не превращай разговор в обязательный набор заголовков.
|
|
85
|
+
|
|
86
|
+
## Адаптация к цели разговора
|
|
87
|
+
|
|
88
|
+
| Пользователю нужно | Что объяснить |
|
|
100
89
|
| --- | --- |
|
|
101
|
-
|
|
|
102
|
-
|
|
|
103
|
-
|
|
|
104
|
-
|
|
|
90
|
+
| Уточнить намерение | Как ты понял проблему и желаемый результат; покажи существенное допущение так, чтобы его можно было поправить. |
|
|
91
|
+
| Понять процесс или механизм | Что происходит в его задаче и как действие приводит к результату. |
|
|
92
|
+
| Выбрать подход | Реальные варианты, рекомендация, причина и существенный компромисс. Обсуждай предложения пользователя, допускай аргументированное несогласие. |
|
|
93
|
+
| Узнать прогресс | Что выяснено, что осталось и как это влияет на ожидаемый результат; не перечисляй всю топологию агентов. |
|
|
94
|
+
| Получить результат | Что изменилось, чем подтверждено и что не проверено. Различай создание, проверку, приёмку и публикацию. |
|
|
95
|
+
| Разобраться с проблемой | Наблюдаемый сбой, известная или неизвестная причина, последствия и способ продолжить. |
|
|
96
|
+
|
|
97
|
+
Если нужен выбор пользователя, объясни его последствия и рекомендацию.
|
|
98
|
+
Ранее разрешённую работу продолжай без нового запроса разрешения; пояснение
|
|
99
|
+
не создаёт дополнительных гейтов и не превращает частную рекомендацию в
|
|
100
|
+
согласованный scope.
|
|
101
|
+
|
|
102
|
+
## Точность при упрощении
|
|
103
|
+
|
|
104
|
+
Различай факт, предположение, рекомендацию и неизвестное. «Исполнитель
|
|
105
|
+
сообщил» не превращай в «проверено». Пройденная проверка схемы не доказывает
|
|
106
|
+
успех живого сценария. Отсутствие проверки не означает обнаруженную ошибку.
|
|
107
|
+
Не обещай выполненные действия, найденные причины и гарантии без оснований.
|
|
108
|
+
|
|
109
|
+
Сохраняй числа, единицы, версии, условия и ограничения, меняющие решение.
|
|
110
|
+
Различай «не может», «не реализовано» и «не проверено». Противоречие источников
|
|
111
|
+
объясни вместе с его влиянием, не выбирай удобную версию молча. Не убирай
|
|
112
|
+
существенную оговорку ради краткости. Логи и служебные идентификаторы давай
|
|
113
|
+
по необходимости для аудита; секреты и нерелевантные материалы не раскрывай.
|
|
114
|
+
Машинные RESULT/EVIDENCE/ACCEPTANCE сохраняй без переименования полей;
|
|
115
|
+
человеческое объяснение — отдельное изложение того же смысла.
|
|
116
|
+
|
|
117
|
+
## Если пользователь потерял нить
|
|
118
|
+
|
|
119
|
+
Останови наращивание деталей. По его вопросу найди место непонимания и
|
|
120
|
+
объясни заново с недостающего контекста, другой последовательностью или
|
|
121
|
+
конкретным примером. Если причина неясна, задай один адресный вопрос.
|
|
122
|
+
Простое сокращение и замена слов синонимами не восстанавливают пропущенную
|
|
123
|
+
связь. Не обвиняй пользователя и не защищай прежнюю формулировку.
|
|
124
|
+
|
|
125
|
+
Пример по условному сообщению «Заявка зарегистрирована, решение ещё не принято»
|
|
126
|
+
и вопросу «Значит, всё одобрено?»:
|
|
127
|
+
«Пока известно, что заявку получили. Одобрение ещё нужно дождаться: подтверждение
|
|
128
|
+
получения само по себе его не означает. Когда будет решение, в сообщении не указано».
|
|
129
|
+
Не придумывай срок, причину задержки или результат, которых нет в источнике.
|
|
130
|
+
Пример показывает способ объяснения; подбирай содержание к текущей задаче.
|
|
131
|
+
|
|
132
|
+
Повторяющееся непонимание из-за правила общения — основание для behavioral-жалобы
|
|
133
|
+
по существующему протоколу: исходный ответ, вопрос, исправленное объяснение и
|
|
134
|
+
предложение правки. Не считай каждое уточнение ошибкой и не создавай глобальное
|
|
135
|
+
правило автоматически.
|
|
136
|
+
|
|
137
|
+
## Короткая проверка перед отправкой
|
|
138
|
+
|
|
139
|
+
Может ли пользователь понять главную мысль и её связь со своей задачей без
|
|
140
|
+
расшифровки сленга? Названы ли нужные действия, причины и последствия?
|
|
141
|
+
Сохранены ли точность и существенное неизвестное? Ясно ли, требуется ли от
|
|
142
|
+
него решение? Если нет — исправь конкретный пробел, без циклов редактуры
|
|
143
|
+
ради формы. Цель — обсуждать решение, а не расшифровывать речь Вольфа.
|
|
@@ -9,7 +9,7 @@ description: "Применять перед декомпозицией утве
|
|
|
9
9
|
|
|
10
10
|
До планирования проверь тред, режим, актуальные требования, дизайн и основание их утверждения. L0 поручает планирование L1; L2 может готовить назначенную часть, но не владеть общим планом. В FULL заполняй plan.md существующей папки: задачи чекбоксами с task_id, ссылками на design и baseline. В LITE/FIX используй разрешённый бриф; не создавай четыре документа ради формальности. Автор плана не начинает реализацию в рамках этого скилла.
|
|
11
11
|
|
|
12
|
-
|
|
12
|
+
Используй полный актуальный текст назначенной методики. По wolf-work-strategy различай обязательные требования, условные действия и доступные техники; отслеживай применимые обязательства в существующем TASK/трекере. Не создавай новые статусы памяти; недоступное обязательное действие передай ответственному уровню.
|
|
13
13
|
|
|
14
14
|
|
|
15
15
|
## Вход и выход
|
|
@@ -27,6 +27,14 @@ description: "Применять перед декомпозицией утве
|
|
|
27
27
|
7. Сверь plan с test-plan: сценарии входят в соответствующие задачи, NFR имеют измерения, тесты запускаются проектными командами. Исполнение FULL не стартует до этой сверки.
|
|
28
28
|
8. Проведи саморевью и назначенное независимое ревью. Ошибку плана исправляй с повторной проверкой затронутых зависимостей.
|
|
29
29
|
|
|
30
|
+
## План по определённости
|
|
31
|
+
|
|
32
|
+
Детализируй то, что уже можно исполнять; неизвестное, меняющее маршрут, сначала
|
|
33
|
+
сними вопросом носителю контекста, готовым источником или ограниченной пробой.
|
|
34
|
+
Не пиши подробную цепочку реализации на непроверенном допущении. Отметь зависимые
|
|
35
|
+
задачи условными в тексте плана, без нового статуса памяти; после ответа измени
|
|
36
|
+
только затронутую часть. Простой понятный результат не дроби ради числа задач.
|
|
37
|
+
|
|
30
38
|
## Трекинг
|
|
31
39
|
|
|
32
40
|
Пиши задачи чекбоксами с task_id. [x] ставит L1 после проверки результата и необходимых ревью; рядом фиксирует revision/evidence и статус интеграции. Коммит или чекбокс отдельно не доказывает приёмку. Общий plan изменяет L1, не параллельные L2.
|
|
@@ -48,6 +48,14 @@ Security/trust обязателен по релевантным правам, с
|
|
|
48
48
|
утверждает scope. Явное общее ревью сохраняет все критерии в суммарном покрытии,
|
|
49
49
|
не превращается в набор механических проверок.
|
|
50
50
|
|
|
51
|
+
## Соразмерность ревью
|
|
52
|
+
|
|
53
|
+
Выбирай линзы по порученному результату и существенным рискам; общая смысловая
|
|
54
|
+
проверка сохраняет полное согласованное покрытие. Не превращай любую находку
|
|
55
|
+
в аудит соседней подсистемы. Вопрос о смысле/известном решении адресуй владельцу
|
|
56
|
+
через L1 до дорогой реконструкции намерения. Не проси автора подсказать вердикт:
|
|
57
|
+
разъяснение нормы доступно независимым ревьюерам, вывод они делают сами.
|
|
58
|
+
|
|
51
59
|
## Цикл и журнал
|
|
52
60
|
|
|
53
61
|
1. Зафиксируй применимые линзы и версии, запусти независимые мандаты.
|