BC clarify-docs
ЗАПУСКАТЬСЯ, когда: запрашивается уточнение или улучшение объяснения в существующей локальной человеческой документации или черновике описания PR, включая URL PR или вставленный текст. Обосновывает правки требованиями и источником, сохраняя технический смысл. Не для кода, конфигурации, общей краткости ответа или инструкций агента. Явные инструкции или цели SKILL.md получают предложение /kk:implement без правок или автоматической передачи.
машинный переводПоказать оригиналСкрыть оригинал«TRIGGER when: asked to clarify or improve the explanation in existing…»
TRIGGER when: asked to clarify or improve the explanation in existing local human documentation or a PR-description draft, including a PR URL or pasted body. Grounds edits in requirements and source while preserving technical meaning. Not for code, config, generic response brevity, or agent instructions. Explicit instruction or SKILL.md targets receive a /kk:implement suggestion without edits or automatic handoff.
ЗАПУСКАТЬСЯ, когда: запрашивается уточнение или улучшение объяснения в существующей локальной человеческой документации или черновике описания PR, включая URL…
Как процесс C 63/100 · Есть пробелы — слабые места: результат и критерий готовности, ошибки и развилки, согласованность
Такой же скилл встречается ещё в 3 местах: claude-toolbox, claude-toolbox, claude-toolbox
Как улучшить
- Свои кейсы (evals/evals.json, 4–6 реальных запросов с ожидаемыми ответами): тогда полная проверка прогонит именно их, а не черновик от модели.
- spec.yaml с триггерными фразами и утверждениями — контракт поведения для CI; `skilltest init` создаст шаблон.
Находки guard · 0
✓ Критических и высоких находок нет
Просканировано файлов: 2. Улики замаскированы. Пометки в серых чипах объясняют, почему серьёзность понижена.
По спецификации Agent Skills
✓ По спецификации Agent Skills замечаний нет
Процессный рейтинг: все десять параметров 63/100
- 0Результат и критерий готовности. Не сказано, что считать результатом
- 0Ошибки и развилки. Линейный процесс без обработки сбоев
- 0Отчётность по ходу. Скилл ничего не сообщает по ходу работы
- 30Повторный запуск. Изменяющих операций: 3, без проверки текущего состояния
- 40Согласованность. Имя во frontmatter (clarify-docs) не совпадает с папкой (instructions)
- 70Входы и предусловия. Входные данные и предусловия перечислены
- 100Инструменты и файлы. Внешние инструменты не нужны
- 100Шаги. Шагов: 8
- 100Когда включается. Сказано, когда применять и когда не применять
- 100Стоимость исполнения. Тело инструкции 792 токенов
Всё перечисленное измерено по тексту скилла, а не оценено моделью: цифры проверяемы. Вес параметра тем больше, чем чаще из-за него процесс встаёт.
Сигналы качества
- +5В description нет примеров фраз, по которым скилл должен срабатывать
- +3Формат ответа не описан: модель каждый раз решает сама
- +4Нет примеров входа/выхода
- +1Лицензия не указана
- +2Инструкции на одном языке
- +4Описание говорит, когда скилл НЕ применять
- +3Длина description 417 символов: достаточно сигнала, не съедает бюджет
- +4Структура: 3 заголовков
- +3Пошаговые инструкции: 8 пунктов
База качества 70; замечания lint вычитаются, сигналы прибавляют до 100. Итог: 84.