AB build-docs-creator
Создает полный, стандартизированный пакет документации для разработчиков на основе накопленной проектной работы — обзор продукта (в стиле BRD), спецификация требований (в стиле SRS), документ технического проектирования (в стиле DD) и исходный код интерфейса с руководством по ссылкам, все упаковано вместе. Используйте, когда пользователь просит «создать документацию для сборки», «сгенерировать пакет документации», «превратить этот проект в документацию для разработчиков», «создать пакет SRS/BRD/DD» или хочет передать разработчикам информацию как о том, что строить, так и почему. Работает на основе истории разговоров и артефактов проекта Claude (включая интерфейсы Claude Design/HTML) и может включать частичные документы, принесенные из других источников (например, требования, созданные ChatGPT), наряду с собственным контентом проекта. НЕ используйте для одного узкого запроса на документацию — вывод по умолчанию этого навыка — полный пакет. Не для текущей документации SDLC (планы тестирования, руководства, артефакты спринта) — только предварительная документация.
машинный переводПоказать оригиналСкрыть оригинал«Produces a complete, standardized build-documentation package for deve…»
Produces a complete, standardized build-documentation package for developers from a project's accumulated design work — a product overview (BRD-style), requirements spec (SRS-style), technical design doc (DD-style), and interface source code with a reference guide, all zipped together. Use when the user asks to 'create build docs,' 'generate the doc package,' 'turn this project into docs for devs,' 'produce an SRS/BRD/DD package,' or wants a developer handoff covering both what to build and why. Works from a Claude Project's conversation history and artifacts (including Claude Design/HTML interfaces), and can incorporate partial docs brought in from elsewhere (e.g. ChatGPT-authored requirements) alongside the project's own content. Do NOT use for a single narrow doc request — this skill's default output is the full package. Not for ongoing SDLC docs (test plans, runbooks, sprint artifacts) — pre-build documentation only.
Создает полный, стандартизированный пакет документации для разработчиков на основе накопленной проектной работы — обзор продукта (в стиле BRD), спецификация…
Как процесс B 71/100 · Почти готов — слабые места: результат и критерий готовности, входы и предусловия, повторный запуск
Как улучшить
- Свои кейсы (evals/evals.json, 4–6 реальных запросов с ожидаемыми ответами): тогда полная проверка прогонит именно их, а не черновик от модели.
- spec.yaml с триггерными фразами и утверждениями — контракт поведения для CI; `skilltest init` создаст шаблон.
Находки guard · 0
✓ Критических и высоких находок нет
Просканировано файлов: 7. Улики замаскированы. Пометки в серых чипах объясняют, почему серьёзность понижена.
По спецификации Agent Skills
✓ По спецификации Agent Skills замечаний нет
Процессный рейтинг: все десять параметров 71/100
- 0Входы и предусловия. Не сказано, что нужно иметь на входе
- 0Отчётность по ходу. Скилл ничего не сообщает по ходу работы
- 30Повторный запуск. Изменяющих операций: 1, без проверки текущего состояния
- 40Результат и критерий готовности. Не сказано, что считать результатом
- 55Ошибки и развилки. Развилок: 1
- 100Инструменты и файлы. Внешние инструменты не нужны
- 100Шаги. Шагов: 38
- 100Когда включается. Сказано, когда применять и когда не применять
- 100Согласованность. Имя и обязательные поля на месте
- 100Стоимость исполнения. Тело инструкции 2395 токенов
Всё перечисленное измерено по тексту скилла, а не оценено моделью: цифры проверяемы. Вес параметра тем больше, чем чаще из-за него процесс встаёт.
Сигналы качества
- +5В description нет примеров фраз, по которым скилл должен срабатывать
- +3Длина description 934: рекомендуется 120–800 символов
- +3Формат ответа не описан: модель каждый раз решает сама
- +1Лицензия не указана
- +2Инструкции на одном языке
- +4Описание говорит, когда скилл НЕ применять
- +4Структура: 12 заголовков
- +3Пошаговые инструкции: 38 пунктов
- +4Есть примеры (3 блоков кода)
- +4Справочные файлы упоминаются в инструкциях (5 из 5)
База качества 70; замечания lint вычитаются, сигналы прибавляют до 100. Итог: 89.