BB ad-spec
Создайте спецификацию на уровне функции в doc/specs/NNNN-<slug>.md, следуя шестиуровневому стеку артефактов (Конституция → Домен → Продукт → Спецификация → План/Решения → Код). Адаптирует обязательные разделы GitHub Spec Kit (Сценарии пользователя, Требования, Критерии успеха) к дисциплине документирования комплекта. Используйте, когда пользователь хочет написать, разработать, подготовить каркас или открыть спецификацию функции, бриф функции, пользовательские истории или критерии успеха для одной функции. Определение области на уровне продукта (PRD, дорожная карта нескольких функций, целевой пользователь, метрики успеха продукта) относится к `ad-prd` (Уровень 3). Статус начинается с draft.
машинный переводПоказать оригиналСкрыть оригинал«Draft a feature-level specification at doc/specs/NNNN-<slug>.md follow…»
Draft a feature-level specification at doc/specs/NNNN-<slug>.md following the six-layer artifact stack (Constitution → Domain → Product → Spec → Plan/Decisions → Code). Adapts GitHub Spec Kit's mandatory sections (User Scenarios, Requirements, Success Criteria) to the kit's documentation discipline. Use when the user wants to write, draft, scaffold, or open a feature spec, feature brief, user stories, or success criteria for one feature. Product-level scoping (PRD, multi-feature roadmap, target user, product success metrics) belongs to `ad-prd` (Layer 3). Status starts at draft.
Создайте спецификацию на уровне функции в doc/specs/NNNN-<slug>.md, следуя шестиуровневому стеку артефактов (Конституция → Домен → Продукт → Спецификация →…
Как процесс B 76/100 · Почти готов — слабые места: результат и критерий готовности, повторный запуск, отчётность по ходу
Как улучшить
- Свои кейсы (evals/evals.json, 4–6 реальных запросов с ожидаемыми ответами): тогда полная проверка прогонит именно их, а не черновик от модели.
- spec.yaml с триггерными фразами и утверждениями — контракт поведения для CI; `skilltest init` создаст шаблон.
Находки guard · 0
✓ Критических и высоких находок нет
Просканировано файлов: 2. Улики замаскированы. Пометки в серых чипах объясняют, почему серьёзность понижена.
По спецификации Agent Skills
- заметка
frontmatter-keyнеизвестное поле фронтматтера "summary"
Процессный рейтинг: все десять параметров 76/100
- 0Отчётность по ходу. Скилл ничего не сообщает по ходу работы
- 30Повторный запуск. Изменяющих операций: 10, без проверки текущего состояния
- 40Результат и критерий готовности. Не сказано, что считать результатом
- 60Инструменты и файлы. Используются инструменты (write), но во frontmatter они не объявлены
- 70Входы и предусловия. Входные данные и предусловия перечислены
- 100Шаги. Шагов: 33
- 100Когда включается. Сказано, когда применять и когда не применять
- 100Ошибки и развилки. Развилок: 2, есть раздел про ошибки
- 100Согласованность. Имя и обязательные поля на месте
- 100Стоимость исполнения. Тело инструкции 1566 токенов
- low Ответ описан самодельной разметкой (27 тегов): типизированный вызов надёжнее
Всё перечисленное измерено по тексту скилла, а не оценено моделью: цифры проверяемы. Вес параметра тем больше, чем чаще из-за него процесс встаёт.
Сигналы качества
- +5В description нет примеров фраз, по которым скилл должен срабатывать
- +4Описание не говорит, когда скилл НЕ применять (ложные срабатывания)
- +3Формат ответа не описан: модель каждый раз решает сама
- +4Нет примеров входа/выхода
- -5В тексте остались TODO / заглушки
- +1Лицензия не указана
- +2Инструкции на одном языке
- +3Длина description 585 символов: достаточно сигнала, не съедает бюджет
- +4Структура: 12 заголовков
- +3Пошаговые инструкции: 33 пунктов
База качества 70; замечания lint вычитаются, сигналы прибавляют до 100. Итог: 74.