mister-wolf 2.28.0 → 2.29.0
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
CHANGED
|
@@ -0,0 +1,97 @@
|
|
|
1
|
+
# Спецификация внутреннего языка агентов Wolf
|
|
2
|
+
|
|
3
|
+
**Статус:** действующая спецификация; этап наблюдения (утверждено владельцем
|
|
4
|
+
2026-11-04, решение mem_20261104_vnutrenniy_yazyk_wolf_etap_nablyudeniya_19ed1f;
|
|
5
|
+
рамка и обоснования — docs/dev/2026-11-04-agent-language/pre-requirements.md).
|
|
6
|
+
|
|
7
|
+
**Назначение:** уточняет термины и правила употребления внутреннего языка
|
|
8
|
+
агентов (агенты — ИИ-помощники, выполняющие задачи проекта через фиксированные
|
|
9
|
+
формы сообщений). Формы сообщений — обязательные поля (слоты) каждого типа
|
|
10
|
+
высказывания — нормативно определены в contracts.md (соседний файл) и здесь НЕ
|
|
11
|
+
дублируются: спецификация ссылается на него. Новых обязательных полей документ
|
|
12
|
+
не вводит — только существующие конструкции.
|
|
13
|
+
|
|
14
|
+
## Границы покрытия
|
|
15
|
+
|
|
16
|
+
Язык покрывает только высказывания, меняющие состояние работы: поручения,
|
|
17
|
+
отчёты, вердикты, передачи, жалобы, предложения, переходы статусов.
|
|
18
|
+
Описательная зона свободна: обсуждения, объяснения и рассуждения остаются
|
|
19
|
+
обычным текстом (двухслойность рамки). Ситуации, которые формы не выражают,
|
|
20
|
+
покрывает escape-высказывание (R6).
|
|
21
|
+
|
|
22
|
+
## Термины
|
|
23
|
+
|
|
24
|
+
Определения следуют действующим контрактам (contracts.md, complaints.md) и рамке
|
|
25
|
+
решения владельца; при первом употреблении термин сопровождается расшифровкой.
|
|
26
|
+
|
|
27
|
+
- **TASK** — поручение исполнителю: ядро (обязательные элементы поручения)
|
|
28
|
+
плюс поля применимого профиля (implement | review | research). Полный состав
|
|
29
|
+
слотов — contracts.md.
|
|
30
|
+
- **RESULT** — отчёт исполнителя по форме своей роли. Статусы implement-профиля:
|
|
31
|
+
DONE | DONE_WITH_CONCERNS | NEEDS_CONTEXT | BLOCKED. DONE — готовность к
|
|
32
|
+
ревью, не приёмка.
|
|
33
|
+
- **DONE ≠ ACCEPTED** — разные высказывания разных уровней: DONE сообщает
|
|
34
|
+
готовность к ревью; ACCEPTED — решение назначенного принимающего по
|
|
35
|
+
результатам приёмки (L1 принимает результат L2 в пределах полномочий;
|
|
36
|
+
владелец — там, где предусмотрено его решение).
|
|
37
|
+
- **EVIDENCE** — подтверждение утверждения/критерия: команда или процедура,
|
|
38
|
+
cwd, revision, exit/статус, результат. Состав — contracts.md.
|
|
39
|
+
- **ACCEPTANCE** — сверка каждого критерия приёмки с evidence и итоговый
|
|
40
|
+
вердикт принимающего: ACCEPTED | PARTIAL | REJECTED | INCONCLUSIVE.
|
|
41
|
+
Вердикт независимого ревью: APPROVED | CHANGES_REQUIRED | INCONCLUSIVE.
|
|
42
|
+
- **SCOPE** — граница допустимого: что входит в задачу и что запрещено;
|
|
43
|
+
для ревью SCOPE — покрытие проверки.
|
|
44
|
+
- **LIMITS/GAPS** — что не проверено, где нет данных или остался риск;
|
|
45
|
+
отсутствие данных не равно нулю или успеху.
|
|
46
|
+
- **BLOCKED** — статус: работа не может продолжаться без внешнего
|
|
47
|
+
входа/решения.
|
|
48
|
+
- **NEEDS_CONTEXT** — статус: недостаёт обязательного входа поручения;
|
|
49
|
+
запрашивается, не додумывается.
|
|
50
|
+
- **HANDOFF** — фиксация передачи работы (результата, ответственности,
|
|
51
|
+
открытых вопросов) между исполнителями/сессиями.
|
|
52
|
+
- **VERDICT** — итоговое решение проверки/приёмки одним из перечисленных
|
|
53
|
+
статусов, с evidence.
|
|
54
|
+
- **COMPLAINT** — жалоба на правило (методика/рамка/правило памяти), не на
|
|
55
|
+
разовый случай; подавается объектом памяти через wolf-feedback (поля
|
|
56
|
+
rule/evidence/proposal, класс дефекта — kind: technical|behavioral).
|
|
57
|
+
Предмет LANGUAGE — см. раздел жалоб wolf-feedback.
|
|
58
|
+
- **PROPOSAL** — предложение улучшения/изменения с основанием.
|
|
59
|
+
- **TRANSITION** — переход объекта работы в новый статус по допустимым
|
|
60
|
+
переходам.
|
|
61
|
+
|
|
62
|
+
## Правила употребления R1–R6
|
|
63
|
+
|
|
64
|
+
- **R1** — одно понятие — одно имя.
|
|
65
|
+
- **R2** — запрет анафоры (анафора — отсылки вроде «то же, что выше», «эта
|
|
66
|
+
задача»); ссылки — по идентификатору с версией, например T-42@v2.
|
|
67
|
+
- **R3** — полная поставка: документ языка приезжает со скиллами целиком;
|
|
68
|
+
частичная доставка не предусмотрена.
|
|
69
|
+
- **R4** — человек получает обычный язык; термины — с расшифровкой при первом
|
|
70
|
+
употреблении.
|
|
71
|
+
- **R5** — DONE ≠ ACCEPTED: исполнитель сообщает готовность к ревью; признание
|
|
72
|
+
результата — решение назначенного принимающего (см. определение
|
|
73
|
+
DONE ≠ ACCEPTED выше).
|
|
74
|
+
- **R6** — escape (выход): свободный текст с пометкой «вне контракта» для
|
|
75
|
+
ситуаций, которые форма не покрывает.
|
|
76
|
+
|
|
77
|
+
## Правило при недопонимании
|
|
78
|
+
|
|
79
|
+
Смысл понятен — продолжать. Недостающая информация влияет на действие —
|
|
80
|
+
уточнить, не угадывать. Несоблюдение языка оставляет текущий уровень — не хуже
|
|
81
|
+
сегодняшнего (соблюдение даёт лаконичность и точность, не штраф).
|
|
82
|
+
|
|
83
|
+
## Примеры (условные, для иллюстрации — не шаблоны)
|
|
84
|
+
|
|
85
|
+
1. Обмен TASK→RESULT:
|
|
86
|
+
TASK: «T-7@v1: обнови справочник команд в guides/cli.md — добавь раздел
|
|
87
|
+
про sync. Проверка: раздел виден в оглавлении. Лимит: 6 обращений».
|
|
88
|
+
RESULT: «T-7 DONE: раздел добавлен; проверка пройдена (оглавление содержит
|
|
89
|
+
sync); без отклонений».
|
|
90
|
+
2. Вердикт и приёмка:
|
|
91
|
+
VERDICT: «T-7 APPROVED: замечаний нет». ACCEPTANCE: «T-7 ACCEPTED: оба
|
|
92
|
+
критерия подтверждены evidence».
|
|
93
|
+
3. LANGUAGE-жалоба:
|
|
94
|
+
COMPLAINT (предмет LANGUAGE): rule: «LANGUAGE/ambiguous-definition —
|
|
95
|
+
определение DONE допускает чтение как окончательной приёмки»; evidence:
|
|
96
|
+
«в задаче X RESULT со статусом DONE принят без ревью, ревью не
|
|
97
|
+
состоялось»; proposal: «уточнить определение DONE примером».
|
|
@@ -100,3 +100,5 @@ EVIDENCE: claim/AC, command или процедура, cwd, revision, dirty-stat
|
|
|
100
100
|
ACCEPTANCE: по каждому AC подтверждение/не подтверждено, актуальные evidence, независимое ревью, ограничения; финальный verdict L0: ACCEPTED | PARTIAL | REJECTED | INCONCLUSIVE.
|
|
101
101
|
|
|
102
102
|
Контракты веди сообщениями и адресными note Wolf; файловый fallback — по правилам рабочей памяти выше. Не добавляй команды или типы Wolf без отдельной реализации. Следы жалоб и вердиктов сохраняй разрешённым каналом; при недоступной записи передай L1.
|
|
103
|
+
|
|
104
|
+
Термины и правила употребления внутреннего языка агентов — см. agent-language.md; формы сообщений (слоты) остаются нормативными здесь.
|
|
@@ -45,6 +45,34 @@
|
|
|
45
45
|
несогласие с триажем — эскалация (about=executor-lead), не новая
|
|
46
46
|
жалоба той же сути.
|
|
47
47
|
|
|
48
|
+
### Языковые жалобы (предмет LANGUAGE)
|
|
49
|
+
|
|
50
|
+
Языковая жалоба — предмет «что не так в терминах или формах внутреннего
|
|
51
|
+
языка» (термины и правила — using-skills/references/agent-language.md).
|
|
52
|
+
Класс дефекта остаётся в kind (technical|behavioral): LANGUAGE — предмет
|
|
53
|
+
жалобы, не новый kind и не новый маршрут.
|
|
54
|
+
|
|
55
|
+
Маркер в поле rule — `LANGUAGE/<причина>`, причины:
|
|
56
|
+
- `LANGUAGE/ambiguous-definition` — термин допускает разные толкования
|
|
57
|
+
(пример: «DONE поняли как окончательную приёмку»);
|
|
58
|
+
- `LANGUAGE/insufficient-form` — нужное сообщение нельзя выразить
|
|
59
|
+
существующими слотами (пример: «в RESULT нельзя понятно выразить
|
|
60
|
+
частично завершённый результат»);
|
|
61
|
+
- `LANGUAGE/excessive-requirement` — форма требует лишнего для простой
|
|
62
|
+
ситуации (пример: «для простой задачи пришлось повторить уже доступные
|
|
63
|
+
ограничения»).
|
|
64
|
+
|
|
65
|
+
Критерий подачи: конкретная помеха работе (переспрос, неверное действие,
|
|
66
|
+
лишний шаг), а не каждое формальное отклонение от формы.
|
|
67
|
+
|
|
68
|
+
Подача, триаж и мутация — как для обычных жалоб W1–W4 (разделы А и Б);
|
|
69
|
+
отдельного маршрута нет.
|
|
70
|
+
|
|
71
|
+
Примечание (открытый вопрос владельцу): на момент правки поле proposal
|
|
72
|
+
обязательно при записи жалобы (схема: `proposal: { required: true }` в
|
|
73
|
+
src/domain/memory-types.ts); до решения владельца, если решения не видно,
|
|
74
|
+
пиши в proposal: «решения не вижу; основание: …».
|
|
75
|
+
|
|
48
76
|
## Б. ТРИАЖ (диспетчер)
|
|
49
77
|
|
|
50
78
|
1. **Стоящее обязательство**: при приёмке КАЖДОГО отчёта до вердикта —
|
package/update-map.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
|
-
"version": "2.
|
|
3
|
-
"prev": "2.
|
|
2
|
+
"version": "2.29.0",
|
|
3
|
+
"prev": "2.28.0",
|
|
4
4
|
"files": [
|
|
5
5
|
{
|
|
6
6
|
"path": "base/agents/executor-lead.md",
|
|
@@ -25,7 +25,7 @@
|
|
|
25
25
|
{
|
|
26
26
|
"path": "base/agents/worker-researcher.md",
|
|
27
27
|
"kind": "agent",
|
|
28
|
-
"category": "
|
|
28
|
+
"category": "unchanged"
|
|
29
29
|
},
|
|
30
30
|
{
|
|
31
31
|
"path": "base/agents/worker-reviewer.md",
|
|
@@ -60,7 +60,7 @@
|
|
|
60
60
|
{
|
|
61
61
|
"path": "base/skills/requesting-code-review/SKILL.md",
|
|
62
62
|
"kind": "skill",
|
|
63
|
-
"category": "
|
|
63
|
+
"category": "unchanged"
|
|
64
64
|
},
|
|
65
65
|
{
|
|
66
66
|
"path": "base/skills/test-driven-development/references/test-quality.md",
|
|
@@ -77,6 +77,11 @@
|
|
|
77
77
|
"kind": "skill",
|
|
78
78
|
"category": "unchanged"
|
|
79
79
|
},
|
|
80
|
+
{
|
|
81
|
+
"path": "base/skills/using-skills/references/agent-language.md",
|
|
82
|
+
"kind": "skill",
|
|
83
|
+
"category": "new"
|
|
84
|
+
},
|
|
80
85
|
{
|
|
81
86
|
"path": "base/skills/using-skills/references/context-and-memory.md",
|
|
82
87
|
"kind": "skill",
|
|
@@ -85,7 +90,7 @@
|
|
|
85
90
|
{
|
|
86
91
|
"path": "base/skills/using-skills/references/contracts.md",
|
|
87
92
|
"kind": "skill",
|
|
88
|
-
"category": "
|
|
93
|
+
"category": "changed"
|
|
89
94
|
},
|
|
90
95
|
{
|
|
91
96
|
"path": "base/skills/using-skills/references/project-rules.md",
|
|
@@ -110,17 +115,17 @@
|
|
|
110
115
|
{
|
|
111
116
|
"path": "base/skills/using-skills/references/routes-execution.md",
|
|
112
117
|
"kind": "skill",
|
|
113
|
-
"category": "
|
|
118
|
+
"category": "unchanged"
|
|
114
119
|
},
|
|
115
120
|
{
|
|
116
121
|
"path": "base/skills/using-skills/references/routes-intent.md",
|
|
117
122
|
"kind": "skill",
|
|
118
|
-
"category": "
|
|
123
|
+
"category": "unchanged"
|
|
119
124
|
},
|
|
120
125
|
{
|
|
121
126
|
"path": "base/skills/using-skills/references/routes-quality.md",
|
|
122
127
|
"kind": "skill",
|
|
123
|
-
"category": "
|
|
128
|
+
"category": "unchanged"
|
|
124
129
|
},
|
|
125
130
|
{
|
|
126
131
|
"path": "base/skills/using-skills/references/routes-state.md",
|
|
@@ -145,12 +150,12 @@
|
|
|
145
150
|
{
|
|
146
151
|
"path": "base/skills/wolf-code-craft/SKILL.md",
|
|
147
152
|
"kind": "skill",
|
|
148
|
-
"category": "
|
|
153
|
+
"category": "unchanged"
|
|
149
154
|
},
|
|
150
155
|
{
|
|
151
156
|
"path": "base/skills/wolf-code-simplify/SKILL.md",
|
|
152
157
|
"kind": "skill",
|
|
153
|
-
"category": "
|
|
158
|
+
"category": "unchanged"
|
|
154
159
|
},
|
|
155
160
|
{
|
|
156
161
|
"path": "base/skills/wolf-debug/references/techniques.md",
|
|
@@ -165,7 +170,7 @@
|
|
|
165
170
|
{
|
|
166
171
|
"path": "base/skills/wolf-design/SKILL.md",
|
|
167
172
|
"kind": "skill",
|
|
168
|
-
"category": "
|
|
173
|
+
"category": "unchanged"
|
|
169
174
|
},
|
|
170
175
|
{
|
|
171
176
|
"path": "base/skills/wolf-execute/references/technical-helpers.md",
|
|
@@ -180,7 +185,7 @@
|
|
|
180
185
|
{
|
|
181
186
|
"path": "base/skills/wolf-execute/SKILL.md",
|
|
182
187
|
"kind": "skill",
|
|
183
|
-
"category": "
|
|
188
|
+
"category": "unchanged"
|
|
184
189
|
},
|
|
185
190
|
{
|
|
186
191
|
"path": "base/skills/wolf-explain/SKILL.md",
|
|
@@ -190,7 +195,7 @@
|
|
|
190
195
|
{
|
|
191
196
|
"path": "base/skills/wolf-feedback/references/complaints.md",
|
|
192
197
|
"kind": "skill",
|
|
193
|
-
"category": "
|
|
198
|
+
"category": "changed"
|
|
194
199
|
},
|
|
195
200
|
{
|
|
196
201
|
"path": "base/skills/wolf-feedback/references/session-diagnosis.md",
|
|
@@ -240,7 +245,7 @@
|
|
|
240
245
|
{
|
|
241
246
|
"path": "base/skills/wolf-sdd/SKILL.md",
|
|
242
247
|
"kind": "skill",
|
|
243
|
-
"category": "
|
|
248
|
+
"category": "unchanged"
|
|
244
249
|
},
|
|
245
250
|
{
|
|
246
251
|
"path": "base/skills/wolf-skill-intake/SKILL.md",
|
|
@@ -250,7 +255,7 @@
|
|
|
250
255
|
{
|
|
251
256
|
"path": "base/skills/wolf-software-design/SKILL.md",
|
|
252
257
|
"kind": "skill",
|
|
253
|
-
"category": "
|
|
258
|
+
"category": "unchanged"
|
|
254
259
|
},
|
|
255
260
|
{
|
|
256
261
|
"path": "base/skills/wolf-testplan/SKILL.md",
|