BB cn-api-doc-writer
Генератор документации API с проверкой бэкенда API для китайских разработчиков (中文API文档生成器+接口验证API). Создавайте профессиональную китайскую документацию API из кода, спецификаций OpenAPI/Swagger или описаний конечных точек. Функции: (1) Бэкенд API для проверки документации и соответствия лучшим практикам, (2) Исполняемый скрипт validate.sh для проверки CLI, (3) Сопоставление китайско-английской терминологии (endpoint=接口, payload=请求体), (4) Примеры запросов/ответов с реалистичными китайскими данными, (5) Таблицы кодов ошибок, руководства по аутентификации, документация по ограничению скорости. ⚠️ ОБСЛУЖИВАНИЕ ПРИОСТАНОВЛЕНО — этот навык находится в режиме обслуживания. Для проверки соответствия используйте cn-seo-optimizer или cn-global-compliance вместо этого. Используйте при: написании документации API на китайском языке, преобразовании Swagger/OpenAPI в китайскую документацию, документировании REST API для китайских разработчиков, создании 接口文档, создании справочника API, документации REST API. Триггеры: генератор документации API, API文档, генератор документации интерфейсов, китайская документация API, Swagger на китайском, документация OpenAPI, справочник API на китайском, описание интерфейса, документация по разработке, техническая документация, документация REST API, генерация документации API, инструмент документации интерфейсов, китайская техническая документация, документация API 2026, проверка документации API, API документации.
машинный переводПоказать оригиналСкрыть оригинал«API documentation generator with API backend validation for Chinese de…»
API documentation generator with API backend validation for Chinese developers (中文API文档生成器+接口验证API). Generate professional Chinese API docs from code, OpenAPI/Swagger specs, or endpoint descriptions. Features: (1) API backend for doc validation and best practices checking, (2) Executable validate.sh script for CLI validation, (3) Chinese-English terminology mapping (endpoint=接口, payload=请求体), (4) Request/response examples with realistic Chinese data, (5) Error code tables, authentication guides, rate limiting docs. ⚠️ MAINTENANCE PAUSED — this skill is in maintenance mode. For compliance checking, use cn-seo-optimizer or cn-global-compliance instead. Use when: writing API docs in Chinese, converting Swagger/OpenAPI to Chinese docs, documenting REST APIs for Chinese developers, generating 接口文档, creating API reference, REST API documentation. Triggers: API documentation generator, API文档, 接口文档生成器, 中文API文档, Swagger中文, OpenAPI文档, API reference Chinese, 接口说明, 开发文档, 技术文档, REST API文档, API文档生成, 接口文档工具, 中文技术文档, 2026 API docs, API doc validation, documentation API.
Генератор документации API с проверкой бэкенда API для китайских разработчиков (中文API文档生成器+接口验证API).
Как процесс B 72/100 · Почти готов — слабые места: когда включается, повторный запуск, отчётность по ходу
Как улучшить
- Сократите description до 1024 символов.
- Свои кейсы (evals/evals.json, 4–6 реальных запросов с ожидаемыми ответами): тогда полная проверка прогонит именно их, а не черновик от модели.
- spec.yaml с триггерными фразами и утверждениями — контракт поведения для CI; `skilltest init` создаст шаблон.
Находки guard · 0
✓ Критических и высоких находок нет
Просканировано файлов: 3. Улики замаскированы. Пометки в серых чипах объясняют, почему серьёзность понижена.
По спецификации Agent Skills
- ошибка
description-longdescription 1070 символов, лимит 1024
Процессный рейтинг: все десять параметров 72/100
- 0Отчётность по ходу. Скилл ничего не сообщает по ходу работы
- 20Когда включается. Не сказано, при каком запросе скилл включается
- 30Повторный запуск. Изменяющих операций: 1, без проверки текущего состояния
- 50Ошибки и развилки. Развилок: 0, есть раздел про ошибки
- 60Результат и критерий готовности. Формат результата описан, критерия завершения нет
- 70Входы и предусловия. Входные данные и предусловия перечислены
- 100Инструменты и файлы. Внешние инструменты не нужны
- 100Шаги. Шагов: 29
- 100Согласованность. Имя и обязательные поля на месте
- 100Стоимость исполнения. Тело инструкции 1525 токенов
Всё перечисленное измерено по тексту скилла, а не оценено моделью: цифры проверяемы. Вес параметра тем больше, чем чаще из-за него процесс встаёт.
Сигналы качества
- +5В description нет примеров фраз, по которым скилл должен срабатывать
- +4Описание не говорит, когда скилл НЕ применять (ложные срабатывания)
- +3Длина description 1070: рекомендуется 120–800 символов
- +1Лицензия не указана
- +2Инструкции на одном языке
- +4Структура: 19 заголовков
- +3Пошаговые инструкции: 29 пунктов
- +3Формат ответа описан явно
- +4Есть примеры (8 блоков кода)
- +3Все 1 скриптов описаны в инструкциях
База качества 70; замечания lint вычитаются, сигналы прибавляют до 100. Итог: 62.