BF agents-debug
Используйте, когда ваш агент или среда сломаны — неправильные ответы, ошибки, тайм-ауты, сбои инструментов или проблемы с CLI. Читает трассировки и журналы для диагностики первопричин. Также проверяет предварительные условия, когда сам CLI не работает. Триггеры: "агент не работает", "неправильный ответ", "ошибка агента", "сбой вызова инструмента", "отладить агент", "проверить журналы", "читать трассировки", "сломано", "ошибка 500", "ошибка 424", "отказано в доступе к модели", "команда не найдена", "застрял в DELETING", "превышено maxVms", "диагностика холодного старта", "холодный старт медленный", "ошибка agentcore create", "создание не удалось", "код выхода 7", "отказ в соединении локальная разработка". Не для сбоев развертывания — используйте agents-deploy. Не для оптимизации производительности без ошибок — используйте agents-optimize. Не для настройки VPC — используйте agents-build. Не для настройки наблюдаемости или отсутствующих журналов — используйте agents-optimize.
машинный переводПоказать оригиналСкрыть оригинал«Use when your agent or environment is broken — wrong answers, errors,…»
Use when your agent or environment is broken — wrong answers, errors, timeouts, tool failures, or CLI issues. Reads traces and logs to diagnose root causes. Also checks prerequisites when the CLI itself isn't working. Triggers on: "agent not working", "wrong answer", "agent error", "tool call failing", "debug agent", "check logs", "read traces", "broken", "500 error", "424 error", "model access denied", "command not found", "stuck in DELETING", "maxVms exceeded", "cold start diagnosis", "cold start slow", "agentcore create error", "create failed", "exit code 7", "connection refused local dev". Not for deploy failures — use agents-deploy. Not for performance tuning without errors — use agents-optimize. Not for VPC configuration — use agents-build. Not for observability setup or missing logs — use agents-optimize.
Читает трассировки и журналы для диагностики первопричин.
Как процесс F 71/100 · Не запустится — Скилл ссылается на файлы, которых нет в архиве: references/doctor.md, ../agents-build/references/vpc.md, ../agents-harden/references/limits.md
Чем это грозит
Находки средней серьёзности: скорее всего скилл честный, но прочитайте, что именно насторожило сканер.
Ниже описан худший случай для этой категории. Здесь находка средней серьёзности: guard увидел признак, но не доказательство.
Скилл просит больше прав, чем нужно для задачи: широкий доступ к инструментам, секретные переменные окружения, бинарные файлы. Каждое лишнее право расширяет ущерб при ошибке или взломе.
Сузьте allowed-tools и список переменных до минимума, замените бинарники на исходники или скрипты, которые можно прочитать.
Как улучшить
- Тело SKILL.md длиннее 5 000 токенов: вынесите справочные детали в references/ и подключайте по необходимости.
- В тексте есть ссылки на отсутствующие файлы: добавьте файлы или уберите ссылки.
- Свои кейсы (evals/evals.json, 4–6 реальных запросов с ожидаемыми ответами): тогда полная проверка прогонит именно их, а не черновик от модели.
- spec.yaml с триггерными фразами и утверждениями — контракт поведения для CI; `skilltest init` создаст шаблон.
Находки guard · 1
✓ Критических и высоких находок нет
Средние и низкие: 1
-
средняя Широкие права
meta-broad-allowed-toolsSKILL.md:1Заранее разрешены широкие инструменты: Bashallowed-tools: Read Grep Glob Bash
Просканировано файлов: 1. Улики замаскированы. Пометки в серых чипах объясняют, почему серьёзность понижена.
По спецификации Agent Skills
- предупреждение
body-longтело SKILL.md ≈ 7477 токенов (рекомендуется < 5000); вынесите детали в references/ - предупреждение
missing-refссылка на отсутствующий файл: references/doctor.md - предупреждение
missing-refссылка на отсутствующий файл: ../agents-build/references/vpc.md - предупреждение
missing-refссылка на отсутствующий файл: ../agents-harden/references/limits.md - предупреждение
missing-refссылка на отсутствующий файл: ../agents-build/references/memory.md - предупреждение
missing-refссылка на отсутствующий файл: ../agents-build/references/integrate.md - предупреждение
missing-refссылка на отсутствующий файл: ../agents-build/references/multi-agent.md - предупреждение
missing-refссылка на отсутствующий файл: ../agents-build/references/request-headers.md - предупреждение
missing-refссылка на отсутствующий файл: ../agents-connect/references/policy.md - предупреждение
missing-refссылка на отсутствующий файл: ../agents-optimize/references/observability.md - предупреждение
missing-refссылка на отсутствующий файл: references/vpc.md - предупреждение
missing-refссылка на отсутствующий файл: references/limits.md - предупреждение
missing-refссылка на отсутствующий файл: references/memory.md - предупреждение
missing-refссылка на отсутствующий файл: references/integrate.md - предупреждение
missing-refссылка на отсутствующий файл: references/multi-agent.md - предупреждение
missing-refссылка на отсутствующий файл: references/request-headers.md - предупреждение
missing-refссылка на отсутствующий файл: references/policy.md - предупреждение
missing-refссылка на отсутствующий файл: references/observability.md
Процессный рейтинг: все десять параметров 71/100
- 0Инструменты и файлы. Не хватает 17 файла(ов): references/doctor.md, ../agents-build/references/vpc.md, ../agents-harden/references/limits.md
- 60Результат и критерий готовности. Формат результата описан, критерия завершения нет
- 70Входы и предусловия. Входные данные и предусловия перечислены
- 70Стоимость исполнения. Тело инструкции 7477 токенов
- 100Шаги. Шагов: 61
- 100Когда включается. Сказано, когда применять и когда не применять
- 100Ошибки и развилки. Развилок: 1, есть раздел про ошибки
- 100Согласованность. Имя и обязательные поля на месте
- 100Повторный запуск. Изменяющие операции проверяют текущее состояние
- 100Отчётность по ходу. Скилл сообщает о ходе работы
- low Разделов верхнего уровня: 21. Похоже на несколько доменов в одном скилле
- high Скилл велит модели самой совершать необратимое действие, без подтверждения человеком
Всё перечисленное измерено по тексту скилла, а не оценено моделью: цифры проверяемы. Вес параметра тем больше, чем чаще из-за него процесс встаёт.
Сигналы качества
- +3Длина description 823: рекомендуется 120–800 символов
- +1Лицензия не указана
- +2Инструкции на одном языке
- +5В description 20 примера фраз-триггеров в кавычках
- +4Описание говорит, когда скилл НЕ применять
- +4Структура: 29 заголовков
- +3Пошаговые инструкции: 61 пунктов
- +3Формат ответа описан явно
- +4Есть примеры (35 блоков кода)
База качества 70; замечания lint вычитаются, сигналы прибавляют до 100. Итог: 71.