B agent-loop-engineering
Use when an AI coding agent needs bounded development loops, persistent project-local Docs/ state, context budgeting, environment escalation rules, safe stop gates, and Done / Done with Risk / Blocked completion decisions across Codex, Claude Code, OpenCode, Cline, Qoder, CodeBuddy, Trae, Gemini CLI, Aider, GitHub Actions, or other AI coding agents.
- Безопасность 60%
- Качество 40%
- Тесты бонус
Чем это грозит
Находки средней серьёзности: скорее всего скилл честный, но прочитайте, что именно насторожило сканер.
Ниже описан худший случай для этой категории. Здесь находка средней серьёзности: guard увидел признак, но не доказательство.
Скилл содержит команды, которые удаляют файлы, переписывают диски или исполняют код, скачанный из сети. Агент может выполнить их без вопроса, если считает, что так требует инструкция.
Замените разрушительные команды на безопасные аналоги с подтверждением, ограничьте область действия конкретной папкой и не тяните код через curl | bash: укажите версию и контрольную сумму.
Как улучшить
- Тело SKILL.md длиннее 5 000 токенов: вынесите справочные детали в references/ и подключайте по необходимости.
- В тексте есть ссылки на отсутствующие файлы: добавьте файлы или уберите ссылки.
- Добавьте evals/evals.json с 4–6 реальными запросами и ожидаемыми ответами: тогда полная проверка использует ваши кейсы, а не черновик модели.
- Добавьте spec.yaml с триггерами и утверждениями (skilltest init): это контракт поведения для CI.
Находки guard · 3
✓ Критических и высоких находок нет
Средние и низкие: 3
-
средняя Опасные команды
cmd-execpolicy-bypassreferences/checker-and-evidence.md:56Запуск PowerShell с обходом execution policypowershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\agen…ps1 -WorkspacePath "D:\path\to\project" -Strict
-
средняя Опасные команды
cmd-execpolicy-bypassreferences/checker-and-evidence.md:74Запуск PowerShell с обходом execution policypowershell -NoProfile -ExecutionPolicy Bypass -File "D:\Codex\clawhub-skills\ClawSkills\skills\agent-loop-engineering\scripts\agen…ps1" -WorkspacePath "D:\Development\SomeProject" -Strict
-
низкая Опасные команды
cmd-execpolicy-bypassscripts/agent-loop-runner.ps1:117Запуск PowerShell с обходом execution policy (определение детектора / чёрного списка; строковый литерал в коде, не выполняется)$psi.Arguments = "-NoProfile -ExecutionPolicy Bypass -Command $command"
детекторстрока в коде
Просканировано файлов: 25. Улики замаскированы. Пометки в серых чипах объясняют, почему серьёзность понижена.
Lint
- предупреждение
body-longтело SKILL.md ≈ 5404 токенов (рекомендуется < 5000); вынесите детали в references/ - предупреждение
missing-refссылка на отсутствующий файл: templates/LOOP_LOG.example.jsonl
Процессная зрелость 43/100
- 0Инструменты и файлы. Не хватает 1 файла(ов): templates/LOOP_LOG.example.jsonl
- 0Входы и предусловия. Не сказано, что нужно иметь на входе
- 20Когда включается. Не сказано, при каком запросе скилл включается
- 30Повторный запуск. Изменяющих операций: 12, без проверки текущего состояния
- 40Результат и критерий готовности. Не сказано, что считать результатом
- 70Ошибки и развилки. Развилок: 12
- 70Стоимость исполнения. Тело инструкции 5404 токенов
- 85Шаги. Шагов: 93, расплывчатых формулировок: 1
- 100Согласованность. Имя и обязательные поля на месте
- 100Отчётность по ходу. Скилл сообщает о ходе работы
- medium Правила безопасности и запреты внутри скилла: их место в системном промпте, здесь они не защищают
- low Разделов верхнего уровня: 16. Похоже на несколько доменов в одном скилле
Всё перечисленное измерено по тексту скилла, а не оценено моделью: цифры проверяемы. Вес параметра тем больше, чем чаще из-за него процесс встаёт.
Сигналы качества
- +5В description нет примеров фраз, по которым скилл должен срабатывать
- +4Описание не говорит, когда скилл НЕ применять (ложные срабатывания)
- +3Формат ответа не описан: модель каждый раз решает сама
- -31 из 3 скриптов не упомянуты в SKILL.md
- +1Лицензия не указана
- +2Инструкции на одном языке
- +3Длина description 351 символов: достаточно сигнала, не съедает бюджет
- +4Структура: 17 заголовков
- +3Пошаговые инструкции: 93 пунктов
- +4Есть примеры (7 блоков кода)
- +4Справочные файлы упоминаются в инструкциях (12 из 13)
База качества 70; замечания lint вычитаются, сигналы прибавляют до 100. Итог: 69.