CD release-readiness-check
Проверка перед релизом: за пять минут до запуска, проверка перед публикацией, проверка перед релизом, готовность к релизу. Одна команда выполняет пять проверок: Dockerfile / K8s манифесты / SQL миграции / совместимость OpenAPI / конфигурация .env и формирует отчет. Используется, когда пользователь говорит «Можно запускать?», «Проверь перед запуском», «Техосмотр перед релизом», «Посмотри, есть ли риски при этом запуске», «Запусти чек-лист для релиза», «Добавь проверку перед релизом в CI». Прилагается скрипт на стандартной библиотеке `scripts/release_check.py`, который автоматически находит в целевом каталоге файлы Dockerfile, YAML-файлы K8s с `kind`, SQL миграции, спецификации OpenAPI, файлы `.env`. Поочередно вызывает пять независимых проверок через подпроцессы, обобщая результаты в Markdown-отчет (общая сводка → основные проблемы по каждому пункту → заключение по проверке). Статус проверки: при наличии `high` — «не рекомендуется к запуску»; при отсутствии `high`, но наличии пунктов, по которым не удалось получить данные (сбой подскрипта, старая спецификация пуста/без путей, только Helm-шаблон, отсутствует пример `.env`) — «невозможно определить, не хватает N доказательств», выпуск также не разрешается; если по всем пунктам есть результаты и нет `high` — «можно запускать». Если в каталоге нет таких файлов, считается «неприменимо», что не влияет на разрешение выпуска. Поддерживает `--json`, `--strict` для CI-проверок (выход с кодом 1 при `high` или невозможности определить); `--skip` для явного исключения пункта; `--openapi-base` для сравнения со старой спецификацией.
машинный переводПоказать оригиналСкрыть оригинал«上线前五分钟体检、发布前检查、上线卡点、release readiness、一条命令跑完 Dockerfile / K8s 清单 / SQL…»
上线前五分钟体检、发布前检查、上线卡点、release readiness、一条命令跑完 Dockerfile / K8s 清单 / SQL 迁移 / OpenAPI 兼容 / .env 配置五项检查并汇总成一份报告。当用户说「能不能上线」「上线前检查一下」「发布前体检」「帮我看看这次上线有没有风险」「上线 checklist 跑一遍」「CI 加个上线门禁」时使用。附纯标准库脚本 scripts/release_check.py,自动发现目标目录里的 Dockerfile、含 kind 的 K8s YAML、*.sql 迁移、openapi 规范、.env 文件,逐项用子进程调用内置的五个独立检查器,汇总为 Markdown 报告(总览表 → 各项 top 问题 → 门禁结论)。门禁三态:有 high 判「不建议上线」;无 high 但有项拿不到证据(子脚本崩溃、旧规范为空/无 paths、只有 Helm 模板、缺 .env 示例)判「无法判断,缺 N 项证据」并同样不放行;全部项都有结论且无 high 才是「可以上线」。目录里没有这类文件算「不适用」,不影响放行。支持 --json、--strict 做 CI 门禁(有 high 或有无法判断项则退出码 1)、--skip 显式豁免某项、--openapi-base 比对旧规范。
Проверка перед релизом: за пять минут до запуска, проверка перед публикацией, проверка перед релизом, готовность к релизу.
Как процесс D 43/100 · Процесс не доведён — слабые места: результат и критерий готовности, когда включается, входы и предусловия
Как улучшить
- Скажите в description, КОГДА применять скилл («используй, когда…», примеры запросов): это главный сигнал для агента.
- Свои кейсы (evals/evals.json, 4–6 реальных запросов с ожидаемыми ответами): тогда полная проверка прогонит именно их, а не черновик от модели.
- spec.yaml с триггерными фразами и утверждениями — контракт поведения для CI; `skilltest init` создаст шаблон.
Находки guard · 2
✓ Критических и высоких находок нет
Средние и низкие: 2
-
низкая Опасные команды
cmd-privilegescripts/checks/dockerfile_check.py:87Повышение привилегий / права на запись для всех (строковый литерал в коде, не выполняется)if "chmod 777" in low or "chmod -r 777" in low:
строка в коде -
низкая Опасные команды
cmd-privilegescripts/checks/dockerfile_check.py:88Повышение привилегий / права на запись для всех (строковый литерал в коде, не выполняется)add("DF016", "warn", line, "chmod 777", "按需给最小权限,如 755 / 644")строка в коде
Просканировано файлов: 8. Улики замаскированы. Пометки в серых чипах объясняют, почему серьёзность понижена.
По спецификации Agent Skills
- предупреждение
description-no-whendescription не говорит, КОГДА применять скилл (нет "use when / используй когда") - заметка
frontmatter-keyнеизвестное поле фронтматтера "display_name" - заметка
frontmatter-keyнеизвестное поле фронтматтера "display_name_en" - заметка
frontmatter-keyнеизвестное поле фронтматтера "description_zh" - заметка
frontmatter-keyнеизвестное поле фронтматтера "description_en" - заметка
frontmatter-keyнеизвестное поле фронтматтера "examples_zh" - заметка
frontmatter-keyнеизвестное поле фронтматтера "examples_en"
Процессный рейтинг: все десять параметров 43/100
- 0Результат и критерий готовности. Не сказано, что считать результатом
- 0Входы и предусловия. Не сказано, что нужно иметь на входе
- 0Ошибки и развилки. Линейный процесс без обработки сбоев
- 0Отчётность по ходу. Скилл ничего не сообщает по ходу работы
- 20Когда включается. Не сказано, при каком запросе скилл включается
- 30Повторный запуск. Изменяющих операций: 4, без проверки текущего состояния
- 60Инструменты и файлы. Используются инструменты (python), но во frontmatter они не объявлены
- 100Шаги. Шагов: 29
- 100Согласованность. Имя и обязательные поля на месте
- 100Стоимость исполнения. Тело инструкции 1193 токенов
Всё перечисленное измерено по тексту скилла, а не оценено моделью: цифры проверяемы. Вес параметра тем больше, чем чаще из-за него процесс встаёт.
Сигналы качества
- +5В description нет примеров фраз, по которым скилл должен срабатывать
- +4Описание не говорит, когда скилл НЕ применять (ложные срабатывания)
- +3Формат ответа не описан: модель каждый раз решает сама
- +1Лицензия не указана
- +2Инструкции на одном языке
- +3Длина description 574 символов: достаточно сигнала, не съедает бюджет
- +4Структура: 7 заголовков
- +3Пошаговые инструкции: 29 пунктов
- +4Есть примеры (2 блоков кода)
- +3Все 1 скриптов описаны в инструкциях
База качества 70; замечания lint вычитаются, сигналы прибавляют до 100. Итог: 72.