AC polling-best-practices
Лучшие практики автоматизации длительных асинхронных задач с помощью периодического опроса в стиле cron. Используйте, когда пользователь хочет отслеживать фоновую команду CLI или вызов API, которые не дают немедленного результата — например, ожидание генерации отчета, создания подкаста, завершения глубокого исследовательского задания или любой задачи с четким условием завершения. Триггеры на запросы типа "отслеживать X до завершения", "опрашивать Y", "ждать завершения Z в фоновом режиме", "запустить X в фоновом режиме и уведомить меня, когда будет готово", "автоматизация длительных задач", "мониторинг асинхронных задач". Этот навык НЕ предназначен для задач, требующих взаимодействия в реальном времени, сложной оценки LLM во время выполнения или потоковой передачи вывода. Это навык только для руководства — он не устанавливает скрипты или инструменты; агент применяет эти принципы вручную на основе приведенного здесь руководства. Шаблонный скрипт опроса предоставлен в каталоге scripts/ для удобства.
машинный переводПоказать оригиналСкрыть оригинал«Best practices for automating long-running, asynchronous tasks via cro…»
Best practices for automating long-running, asynchronous tasks via cron-style polling. Use when the user wants to monitor a background CLI command or API call that does not return an immediate result — such as waiting for a report to generate, a podcast to be created, a deep research job to complete, or any task with a clear completion condition. Triggers on requests like "monitor X until done", "poll for Y", "wait for Z to complete in the background", "run X in the background and notify me when ready", "long-running task automation", "async task monitor". This skill is NOT for tasks requiring real-time interaction, complex LLM judgment during execution, or streaming output. It is a guidance-only skill — it does not install scripts or tools; the agent applies these principles manually based on the guidance here. A template polling script is provided in the scripts/ directory for convenience.
Лучшие практики автоматизации длительных асинхронных задач с помощью периодического опроса в стиле cron.
Как процесс C 63/100 · Есть пробелы — слабые места: результат и критерий готовности, входы и предусловия, согласованность
Как улучшить
- Свои кейсы (evals/evals.json, 4–6 реальных запросов с ожидаемыми ответами): тогда полная проверка прогонит именно их, а не черновик от модели.
- spec.yaml с триггерными фразами и утверждениями — контракт поведения для CI; `skilltest init` создаст шаблон.
Находки guard · 1
✓ Критических и высоких находок нет
Средние и низкие: 1
-
низкая Опасные команды
cmd-background-processSKILL.md:312Запуск фонового / автозапускаемого процессаnohup bash poll.sh > /dev/null 2>&1 &
Просканировано файлов: 3. Улики замаскированы. Пометки в серых чипах объясняют, почему серьёзность понижена.
По спецификации Agent Skills
✓ По спецификации Agent Skills замечаний нет
Процессный рейтинг: все десять параметров 63/100
- 0Результат и критерий готовности. Не сказано, что считать результатом
- 0Входы и предусловия. Не сказано, что нужно иметь на входе
- 40Согласованность. Имя во frontmatter (polling-best-practices) не совпадает с папкой (jclaw-polling-best-practices)
- 60Инструменты и файлы. Используются инструменты (bash), но во frontmatter они не объявлены
- 100Шаги. Шагов: 40
- 100Когда включается. Сказано, когда применять и когда не применять
- 100Ошибки и развилки. Развилок: 6, есть раздел про ошибки
- 100Стоимость исполнения. Тело инструкции 3428 токенов
- 100Повторный запуск. Изменяющие операции проверяют текущее состояние
- 100Отчётность по ходу. Скилл сообщает о ходе работы
- medium Правила безопасности и запреты внутри скилла: их место в системном промпте, здесь они не защищают
Всё перечисленное измерено по тексту скилла, а не оценено моделью: цифры проверяемы. Вес параметра тем больше, чем чаще из-за него процесс встаёт.
Сигналы качества
- +3Длина description 904: рекомендуется 120–800 символов
- +3Формат ответа не описан: модель каждый раз решает сама
- +1Лицензия не указана
- +2Инструкции на одном языке
- +5В description 6 примера фраз-триггеров в кавычках
- +4Описание говорит, когда скилл НЕ применять
- +4Структура: 21 заголовков
- +3Пошаговые инструкции: 40 пунктов
- +4Есть примеры (7 блоков кода)
- +3Все 1 скриптов описаны в инструкциях
База качества 70; замечания lint вычитаются, сигналы прибавляют до 100. Итог: 93.