BF doc-governance
Устанавливает архитектуру управления документацией в проекте и диагностирует, чего в ней не хватает. Три действия: audit (аудит) диагностирует текущее состояние по семи компонентам (слоистость единственного источника правды / записи о решениях / дисциплина каскадирования / система планирования / контрольные точки, связанные с действиями / ворота / отслеживаемость инцидентов); init (инициализация) устанавливает недостающие компоненты (конфигурацию, копию скрипта, ворота pre-commit, два хука Claude Code, шаблоны решений и планов); check (проверка) продолжает проверять, соответствует ли документация действительности (зависшие TODO на слишком долгий срок, невыполненные каскадные уведомления, статус плана, не соответствующий реальности, битые ссылки, битые ссылки, ссылки на разделы §, указывающие не туда, отсутствующие записи в индексе, битые таблицы, конечные точки, заявленные в документации, но отсутствующие в коде). Фреймворк был основан на системе документации крупного протокольного проекта, и каждая проверка связана с реальным инцидентом. ⚠️ init изменяет репозиторий и устанавливает хуки, которые продолжают работать после окончания сессии (ворота git pre-commit и два хука Claude Code, которые могут блокировать коммиты и новые файлы планов); без --yes он только перечисляет запланированные изменения. audit и check являются только для чтения. Используйте только тогда, когда пользователь явно спрашивает об управлении документацией в текущем репозитории: «doc governance», «audit the docs against the code», «set up a documentation system for this project», «audit before I write a plan», «is the spec the single source of truth», или когда коммит или запись файла были заблокированы выводом собственных ворот этого навыка.
машинный переводПоказать оригиналСкрыть оригинал«Installs a documentation governance architecture in a project and diag…»
Installs a documentation governance architecture in a project and diagnoses what it is missing. Three actions: audit diagnoses the current state against seven components (source-of-truth layering / decision records / cascade discipline / planning system / checkpoints bound to actions / gates / incident traceability); init installs what is missing (config, a script copy, a pre-commit gate, two Claude Code hooks, decision and plan templates); check keeps verifying that what the docs claim about reality still holds (TODOs left hanging too long, cascade memos never carried out, plan status that doesn't match reality, broken references, broken links, § section references pointing to the wrong place, missing index entries, broken tables, endpoints the docs declare but the code doesn't have). The framework was distilled from the documentation system of a large protocol project, and every check is tied to a real incident. ⚠️ init modifies the repository and installs hooks that keep running after the session ends (a git pre-commit gate and two Claude Code hooks that can block commits and new plan files); without --yes it only lists the planned changes. audit and check are read-only. Use only when the user explicitly asks about documentation governance in the current repository: "doc governance", "audit the docs against the code", "set up a documentation system for this project", "audit before I write a plan", "is the spec the single source of truth", or when a commit or file write was blocked by this skill's own gate output.
Устанавливает архитектуру управления документацией в проекте и диагностирует, чего в ней не хватает.
Как процесс F 35/100 · Не запустится — Скилл ссылается на файлы, которых нет в архиве: scripts/governance.py
Как улучшить
- Сократите description до 1024 символов.
- В тексте есть ссылки на отсутствующие файлы: добавьте файлы или уберите ссылки.
- Свои кейсы (evals/evals.json, 4–6 реальных запросов с ожидаемыми ответами): тогда полная проверка прогонит именно их, а не черновик от модели.
- spec.yaml с триггерными фразами и утверждениями — контракт поведения для CI; `skilltest init` создаст шаблон.
Находки guard · 0
✓ Критических и высоких находок нет
Просканировано файлов: 10. Улики замаскированы. Пометки в серых чипах объясняют, почему серьёзность понижена.
По спецификации Agent Skills
- ошибка
description-longdescription 1541 символов, лимит 1024 - предупреждение
missing-refссылка на отсутствующий файл: scripts/governance.py - заметка
description-budgetdescription занимает 1541 из общего бюджета ~15000 символов на все скиллы - заметка
edit-residueв тексте есть пометки об устаревшем (строки 25): проверьте, не остались ли старые правила рядом с новыми — полная проверка читает текст на противоречия
Процессный рейтинг: все десять параметров 35/100
- 0Инструменты и файлы. Не хватает 1 файла(ов): scripts/governance.py
- 0Результат и критерий готовности. Не сказано, что считать результатом
- 0Входы и предусловия. Не сказано, что нужно иметь на входе
- 25Шаги. Шагов: 1
- 30Повторный запуск. Изменяющих операций: 20, без проверки текущего состояния
- 60Ошибки и развилки. Развилок: 2
- 70Когда включается. Сказано, когда применять, но не сказано, когда не стоит
- 100Согласованность. Имя и обязательные поля на месте
- 100Стоимость исполнения. Тело инструкции 3239 токенов
- 100Отчётность по ходу. Скилл сообщает о ходе работы
- medium Правила безопасности и запреты внутри скилла: их место в системном промпте, здесь они не защищают
Всё перечисленное измерено по тексту скилла, а не оценено моделью: цифры проверяемы. Вес параметра тем больше, чем чаще из-за него процесс встаёт.
Сигналы качества
- +4Описание не говорит, когда скилл НЕ применять (ложные срабатывания)
- +3Длина description 1541: рекомендуется 120–800 символов
- +3Нет пошаговых инструкций или чек-листа
- +3Формат ответа не описан: модель каждый раз решает сама
- -5В тексте остались TODO / заглушки
- +1Лицензия не указана
- +2Инструкции на одном языке
- +5В description 5 примера фраз-триггеров в кавычках
- +4Структура: 9 заголовков
- +4Есть примеры (1 блоков кода)
База качества 70; замечания lint вычитаются, сигналы прибавляют до 100. Итог: 44.