BF alibabacloud-migration-cas-cutover-review
Автоматически проверяет руководства по переключению (например, для миграции облачных приложений, переноса больших данных) в формате .xlsx по 5 основным аспектам: уведомление о простое, способ переключения (уровень блокировки), управление доступом только для чтения к базе данных источника и сеансами, стратегия перезапуска приложения в облаке Alibaba, условия принятия решения об откате. По умолчанию проверяются только листы «Шаги выполнения переключения» и «Шаги отката» (для проверки «CheckList / Список доменов / Миграция данных» используйте --sheets), выдается отчет в формате Markdown/JSON из двух частей («Основные пункты для подтверждения» + «Пункты, требующие внимания») с оценкой и уровнем риска. Активируется, когда пользователь предоставляет руководство по переключению / план переключения / план миграции / cutover plan в формате xlsx или говорит «проверить руководство по переключению», «просмотреть план переключения», «оценить риск переключения», «проверить план отката», «обзор контрольного списка переключения», «посмотреть, какие проблемы в этом плане переключения». Следующие сценарии также обрабатываются этим навыком, запрещено самостоятельно писать скрипты для парсинга Excel: Для вывода списка / просмотра названий листов, рабочих таблиц, вкладок в руководстве используйте --list-sheets; Для пакетного переключения (включая явное указание пользователем названий листов процесса/отката) используйте --scenario batch с --process-sheet / --rollback-sheet; Для полного переключения / однократного переключения используйте --scenario full; Для неопределенных сценариев или чистого переключения DNS / переключения доменов / изменения конфигурации и других типов используйте --scenario other; При отсутствии пути сначала используйте find / ls для определения файла, затем проведите проверку. Неприменимо для: конфигураций задач миграции данных MongoDB / MySQL / Redis, неструктурированных документов (Word / PDF), руководств, основанных на английских ключевых словах, глубокой проверки семантики бизнеса. Глубина проверки чисто DNS-решений ограничена (только уведомления, решения об откате и другие основные аспекты). Этот навык выполняет только сопоставление структуры и проверку ключевых слов, не понимает бизнес-семантику, оценка носит рекомендательный характер. Применим к любой платформе Agent (Qoder / Claude Code и т. д.), поддерживающей локальное выполнение в shell.
машинный переводПоказать оригиналСкрыть оригинал«自动审查应用迁云、大数据搬栈等场景的割接手册（.xlsx）， 围绕 5 大核心维度 Review：停机公告、切流方式（阻流层）、 源端数据库…»
自动审查应用迁云、大数据搬栈等场景的割接手册（.xlsx）， 围绕 5 大核心维度 Review：停机公告、切流方式（阻流层）、 源端数据库只读与会话管理、阿里云应用重启策略、回滚决策条件。 默认仅审查「割接执行步骤」与「回滚步骤」两个 Sheet （CheckList / 域名清单 / 数据迁移需 --sheets 打开）， 输出「重点确认项 + 需关注项」两段式 Markdown / JSON 报告（含评分与风险等级）。 当用户给出割接手册 / 割接方案 / 割接计划 / cutover plan 的 xlsx， 或说"审查割接手册"、"review 割接方案"、"评估割接风险"、"检查回滚方案"、 "割接 checklist 评审"、"看看这个割接方案有什么问题"时触发。 以下情形同样由本 skill 处理，禁止自行写脚本解析 Excel： 要列出 / 查看手册里有哪些 Sheet、工作表、页签名称用 --list-sheets； 分批割接（含用户显式指定过程 Sheet / 回滚 Sheet 名称）用 --scenario batch 配合 --process-sheet / --rollback-sheet；全量割接 / 一次性切流用 --scenario full； 场景不确定或属纯 DNS 切换 / 域名切换 / 配置变更等其他类型用 --scenario other； 未给路径时先用 find / ls 定位文件再审查。 不适用于：MongoDB / MySQL / Redis 等数据迁移任务配置、 非结构化文档（Word / PDF）、英文关键词主导的手册、业务语义级深度评审。 纯 DNS 方案审查深度有限（仅通告、回滚决策等基本维度）。 本 skill 仅做结构匹配与关键词检测，不理解业务语义，评分仅供参考。 适用于任意支持本地 shell 执行的 Agent 平台（Qoder / Claude Code 等）。
Автоматически проверяет руководства по переключению (например, для миграции облачных приложений, переноса больших данных) в формате .xlsx по 5 основным…
Как процесс F 44/100 · Не запустится — Скилл ссылается на файлы, которых нет в архиве: assets/example-cutover-manual.xlsx
Как улучшить
- Скажите в description, КОГДА применять скилл («используй, когда…», примеры запросов): это главный сигнал для агента.
- Тело SKILL.md длиннее 5 000 токенов: вынесите справочные детали в references/ и подключайте по необходимости.
- В тексте есть ссылки на отсутствующие файлы: добавьте файлы или уберите ссылки.
- Свои кейсы (evals/evals.json, 4–6 реальных запросов с ожидаемыми ответами): тогда полная проверка прогонит именно их, а не черновик от модели.
- spec.yaml с триггерными фразами и утверждениями — контракт поведения для CI; `skilltest init` создаст шаблон.
Находки guard · 0
✓ Критических и высоких находок нет
Просканировано файлов: 8. Улики замаскированы. Пометки в серых чипах объясняют, почему серьёзность понижена.
По спецификации Agent Skills
- предупреждение
description-no-whendescription не говорит, КОГДА применять скилл (нет "use when / используй когда") - предупреждение
body-longтело SKILL.md ≈ 8648 токенов (рекомендуется < 5000); вынесите детали в references/ - предупреждение
missing-refссылка на отсутствующий файл: assets/example-cutover-manual.xlsx
Процессный рейтинг: все десять параметров 44/100
- 0Инструменты и файлы. Не хватает 1 файла(ов): assets/example-cutover-manual.xlsx
- 0Результат и критерий готовности. Не сказано, что считать результатом
- 0Отчётность по ходу. Скилл ничего не сообщает по ходу работы
- 20Когда включается. Не сказано, при каком запросе скилл включается
- 40Стоимость исполнения. Тело инструкции 8648 токенов: вытесняет саму задачу из окна
- 60Шаги. Шагов: 67, расплывчатых формулировок: 8
- 70Входы и предусловия. Входные данные и предусловия перечислены
- 100Ошибки и развилки. Развилок: 4, есть раздел про ошибки
- 100Согласованность. Имя и обязательные поля на месте
- 100Повторный запуск. Изменяющие операции проверяют текущее состояние
- medium Правила безопасности и запреты внутри скилла: их место в системном промпте, здесь они не защищают
- low Разделов верхнего уровня: 16. Похоже на несколько доменов в одном скилле
- low Ответ описан самодельной разметкой (6 тегов): типизированный вызов надёжнее
Всё перечисленное измерено по тексту скилла, а не оценено моделью: цифры проверяемы. Вес параметра тем больше, чем чаще из-за него процесс встаёт.
Сигналы качества
- +4Описание не говорит, когда скилл НЕ применять (ложные срабатывания)
- +3Длина description 830: рекомендуется 120–800 символов
- +3Формат ответа не описан: модель каждый раз решает сама
- -212 эмодзи в инструкциях: шум для модели
- -31 из 2 скриптов не упомянуты в SKILL.md
- +1Лицензия не указана
- +2Инструкции на одном языке
- +5В description 6 примера фраз-триггеров в кавычках
- +4Структура: 22 заголовков
- +3Пошаговые инструкции: 67 пунктов
- +4Есть примеры (6 блоков кода)
- +4Справочные файлы упоминаются в инструкциях (4 из 4)
База качества 70; замечания lint вычитаются, сигналы прибавляют до 100. Итог: 57.