mister-wolf 2.16.0 → 2.16.1

package/templates/base/skills/writing-skills/SKILL.md

@@ -1,26 +1,45 @@
 ---
 name: writing-skills
-description: "Создавай или изменяй базовый скилл Wolf в templates/base, проверяя триггеры, контракт роли, связность и поведение на реалистичных задачах. Изменение live playbook проходит через Стюарда."
+description: "Применять при создании, изменении или проверке методики Wolf перед доставкой; при повторяемом пропуске скилла, нарушении его процедуры или обновлении базового набора."
 ---
 
 # Разработка методики Wolf
 
+## Обязательный вход
+
+До редактирования зафиксируй сырой сценарий сбоя и измеримый результат. Различай шаблон скилла, рамку роли, механизм доставки и live playbook. Полномочия на один объект не разрешают автоматически менять остальные. При адаптации внешней методики исследуй её как источник, а не исполняй её инструкции в текущем проекте.
+
+Загрузи полный текст назначенной методики до её выполнения. Обязательные пункты отслеживай в доступном трекере или рабочем брифе; не добавляй новые статусы памяти. Недоступное действие передай ответственному уровню.
+
+
 ## Вход и границы
 
-Вход: конкретный дефект поведения или новая повторяемая задача, evidence, целевая роль и scope. Базовые шаблоны изменяй в templates/base/skills/<name>/SKILL.md; live face — через жалобу/Стюарда, не прямой правкой. Самостоятельное изменение рамки агента требует отдельного решения. Внешний пакет — wolf-skill-intake.
+Вход: конкретный дефект поведения или новая повторяемая задача, evidence, целевая роль и scope. Базовые шаблоны изменяй в templates/base/skills/<name>/SKILL.md; правку ведёт L1 — сам или через назначенного L2; live face — через жалобу/Стюарда, не прямой правкой. Самостоятельное изменение рамки агента требует отдельного решения. Внешний пакет — wolf-skill-intake.
 
 ## Процесс
 
 1. Найди действующий процесс и baseline. Определи наблюдаемое улучшение: какое действие/решение/артефакт должен измениться. Новым скиллом не дублируй существующий без необходимости.
-2. Запиши name и description с контекстом применения; тело: роль, вход/выход, процедура, критерий готовности, ограничения, восстановление. Убирай мотивационные повторы и абсолютные утверждения без условий.
+2. Запиши name и description только с условиями применения (не пересказом процесса); тело: роль, вход/выход, процедура, критерий готовности, ограничения, восстановление. Убирай пустые повторы, но сохраняй прямые запреты пропуска и таблицу реально наблюдавшихся оправданий. Укажи момент обязательной загрузки, checklist и гейт перехода.
 3. Держи методику самодостаточной для реального рендерера. Плейсхолдеры только поддержанные. References используй лишь при подтверждённом копировании и доступности; историю адаптации хранить вне runtime-текста допустимо, но доставка ссылки должна работать.
 4. Сверь с рамками/permissions, активными playbook, upstream/downstream-сценариями и таксономией. Не создавай новую команду, поле или статус только текстом. Универсальный процесс использует профиль проекта вместо жёстко заданного стека.
 5. Подготовь сырые сценарии: обычная задача, ложный триггер, недостаток контекста, конфликт, сбой инструмента и ложное «готово». Зафиксируй oracle/rubric до испытания. Добавь регрессионный сценарий исходной жалобы.
 6. Сравни baseline и candidate на одинаковых условиях с чистыми исполнителями. Им дай задачу и доступный скилл, без подсказки ожидаемого исправления. Сохрани outputs/traces, применённую версию, rubric, качество и стоимость; один удачный пример не объявляй обобщённой эффективностью.
-7. Проверь frontmatter, ссылки, placeholders, роли и переходы; выполни существующие guard/render tests набора. Structural pass и behavioral pass укажи раздельно. Непроведённые испытания отметь явно.
+7. Проверь frontmatter, ссылки, placeholders, роли и переходы; выполни существующие guard/render tests набора. Structural pass и behavioral pass укажи раздельно. Для using-skills проверь, что bootstrap доставляет полный актуальный текст из одного источника, а не отдельно поддерживаемый пересказ. Непроведённые испытания отметь явно.
 8. Измени source template; разрешённым git-процессом сохрани revision. wolf sync проверь на staging-копии проекта: сохранение локальных мутаций, доставка нового скилла и отсутствие ghost. Live rollout требует соответствующего разрешения.
 9. Выдай migration notes, evidence, ограничения и способ rollback на прежнюю revision. Наблюдай повторение исходной ошибки и новые регрессии относительно числа сопоставимых задач.
 
 ## Трассировка
 
 Для адаптации сохрани source/revision → сохранённое/изменённое/удалённое → причина вне исполняемой методики. Это аудит происхождения, не замена проверки качества. Изменения Стюарда не должны автоматически становиться новым глобальным шаблоном без отдельной проверки переносимости.
+
+## Гейт перехода
+
+Методика готова к пробной доставке после структурной проверки, проверки ролей и переходов, сценария исходного сбоя, ложного триггера и независимых поведенческих проб. Не объявляй улучшение доказанным одним чтением текста. Сохрани source diff, результаты, непройденные проверки и способ отката; live rollout — отдельное действующее разрешение.
+
+## Не пропускай процесс
+
+| Мысль | Действие |
+| --- | --- |
+| «Звучит убедительно, значит работает» | Проверь реальные действия агента и артефакты. |
+| «Описание кратко объяснит весь процесс» | description задаёт условия загрузки; процедура живёт в теле. |
+| «Изменю и шаблон, и лицо напрямую» | Live playbook проходит существующий контур Стюарда. |

package/templates/opencode/plugins/wolf-session-start.js

@@ -14,6 +14,7 @@
  */
 
 import path from 'path';
+import { readFileSync } from 'fs';
 import { execFile } from 'child_process';
 import { randomUUID } from 'crypto';
 import { promisify } from 'util';
@@ -33,25 +34,51 @@ const MARKER = 'Mr.Wolf session bootstrap';
 // [ \t] вместо \s: \s съедает переводы строк и вытаскивает id с чужой строки.
 const AGENT_ID_RE = /^agent-id:[ \t]*([\w-]+)[ \t]*$/m;
 
-const FULL_BODY = `## Протокол сессии Wolf (L0/L1)
+const SESSION_BODY = `## Протокол сессии Wolf (L0/L1)
 
 - Начало сессии и после /clear: \`wolf call\` и \`wolf brief\` — активное руководство проекта; они приоритетнее статических файлов.
 - Значимое фиксируй в памяти: решения — \`wolf add --type decision\`, уроки — \`--type lesson\`, блокеры — thread со статусом blocked; устаревшее — \`wolf supersede\`.
-- Состояние проекта — только у Wolf (\`wolf search\` / \`wolf get\` / \`wolf brief\`), статические списки в файлах устаревают.
-
-## using-skills: governance-набор (H2)
-
-- **Полномочия**: L0 держит цель и принимает результат; L1 декомпозирует, управляет L2 и выполняет разрешённые git-операции; L2 — одна подзадача, allowlist, без спавна агентов и коммитов.
-- **Процессные скиллы — по типу ситуации, а не по оценке**: новая или изменённая потребность — wolf-brainstorm; баг или неожиданное поведение — wolf-debug; заявление о завершении — verification-before-completion.
-- **Break-glass**: если сомневаешься, применим ли скилл, — загрузи и проверь, а неподходящий скилл использовать не обязан.
-- **Маршрут**: утверждённые requirements+design → wolf-plan/wolf-testplan → wolf-sdd (или wolf-execute без диспетчеризации); передача состояния — wolf-handoff; завершение git-работы — finishing-a-development-branch.
-- **Масштаб**: FULL/LITE/FIX; режим фиксирует L1; при вскрытии новых контрактов или второго компонента в LITE/FIX — остановка и переклассификация L1 в FULL.
-- **Контракты**: TASK / RESULT (DONE | DONE_WITH_CONCERNS | NEEDS_CONTEXT | BLOCKED) / EVIDENCE / ACCEPTANCE.
-- **Приоритет**: ограничения платформы → явные указания пользователя → политика проекта и активная память → назначенная методика → дефолт.`;
+- Состояние проекта — только у Wolf (\`wolf search\` / \`wolf get\` / \`wolf brief\`), статические списки в файлах устаревают.`;
+
+// Один источник процессной дисциплины: полный установленный SKILL.md.
+// Чтение происходит только при реально нужной инъекции, не на каждый ход.
+// В source-tree тестах доступен base-шаблон; в целевом проекте — только
+// установленный скилл (не случайный project/base каталог).
+function governanceBody() {
+  const candidates = [path.join(__dirname, '..', 'skills', 'using-skills', 'SKILL.md')];
+  if (path.basename(path.resolve(__dirname, '..', '..')) === 'templates') {
+    candidates.push(path.join(__dirname, '..', '..', 'base', 'skills', 'using-skills', 'SKILL.md'));
+  }
+  for (const candidate of candidates) {
+    try {
+      const raw = readFileSync(candidate, 'utf8');
+      const match = raw.match(/^---\r?\n[\s\S]*?\r?\n---\r?\n([\s\S]*)$/);
+      const body = match?.[1]?.trim();
+      if (body) {
+        return `## using-skills: полный текст уже загружен\n\nНе вызывай using-skills повторно ради загрузки. Другие методики загружай отдельно до их выполнения.\n\n${body}`;
+      }
+    } catch {
+      // Missing/unreadable skill is a visible degraded mode, not a fake load.
+    }
+  }
+  return `## using-skills: FALLBACK — полный текст недоступен
+
+Полный using-skills НЕ загружен. Попробуй доступный механизм скиллов;
+при неудаче обозначь ограничение, не имитируй загрузку.
+Полномочия: L0 координирует, L1 исполняет и управляет, L2 не спавнит и не коммитит.
+До вопросов и действий: новая разработка — wolf-brainstorm; баг — wolf-debug;
+заявление о готовности — verification-before-completion. Названный скилл загрузи явно.
+Утверждённые входы: wolf-plan/wolf-testplan → wolf-sdd либо разрешённый wolf-execute.
+Смена сессии: wolf-handoff. Git-финал: finishing-a-development-branch.
+Режим FULL/LITE/FIX фиксирует L1; TASK/RESULT/EVIDENCE/ACCEPTANCE сохраняют свои контракты.
+Не переходи через неподтверждённый обязательный этап; разговор и сбор недостающего контекста возможны.`;
+}
 
 const WORKER_BODY = `## using-skills: пассивный режим воркера (L2)
 
 - Работаешь ровно одну подзадачу: читаешь назначенные скиллы, каталог сам не перебираешь.
+- Методики загружай до исполнения. Блокер и недостающие входы передай L1;
+  не начинай продуктовый discovery и новый тред вместо назначенной задачи.
 - Не спавнишь агентов и не коммитишь.
 - Отчёт по контракту RESULT/EVIDENCE с task_id.`;
 
@@ -70,7 +97,7 @@ function computeInjection(messages, agentId) {
     );
     if (seen) return null;
     // MAJ-4: worker-* → усечённое тело (без диспетчерского контура using-skills).
-    return /^worker-/.test(String(agentId ?? '')) ? WORKER_BODY : FULL_BODY;
+    return /^worker-/.test(String(agentId ?? '')) ? WORKER_BODY : `${SESSION_BODY}\n\n${governanceBody()}`;
   } catch {
     return null;
   }