Claude Skill

bitrix-background-jobs

CAgent, addBackgroundJob, Messenger brokers/queues. Use for deferred and async processing.

LLM Mart · 0 points · 15 views 100 listing impressions 0 install-command copies
Download bxmaximum-bitrix-framework-skills-skills_bitrix-background-jobs-0c65452.zip · 10 KB

Install

skills CLI npx skills add https://github.com/bxmaximum/bitrix-framework-skills/tree/main/skills/bitrix-background-jobs
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install bxmaximum-bitrix-framework-skills@llmmart
Git git clone https://github.com/bxmaximum/bitrix-framework-skills.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole bxmaximum/bitrix-framework-skills collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

Фоновые задания

Baseline: main 23.0+ · Verified: main 26.1000.0

Перед PHP-кодом прочитай bitrix-framework, если ещё не читал его в этой задаче. В таблице выбери только нужный rules/*.md; пути относительны каталогу скилла.

Задача Читать
Периодическое или отложенное задание, агенты на cron, долгие агенты rules/agents.md
Короткая работа после ответа rules/background-job.md
Очередь: сообщение, получатель, отправка, повторы rules/messenger.md
Настройки очередей, брокеры, messenger:consume, очереди ядра rules/messenger-config.md

Выбор: расписание → агент на cron; несколько секунд после ответа → addBackgroundJob; повторы, объём, параллельные исполнители → Messenger (Since main 25.100.300, альфа); разовая долгая миграция → консольная команда (bitrix-console-commands).

Обязательные правила

  • Фоновый код не имеет контекста пользователя: агенты и получатели устанавливают global $USER = null; не используй $_SESSION/cookies. Передавай ID пользователя/сайта явно.
  • На хитах агенты, Messenger в режиме web и addBackgroundJob() выполняются после отправки ответа, OnAfterEpilog и session_write_close(), с пулом БД, переключённым на master.
  • Код задания только получает сервис через ServiceLocator::getInstance()->get() и вызывает его (DI конструктора агента недоступен — bitrix-framework).
  • Задания должны быть идемпотентными: агент может запуститься параллельно дважды, сообщение может прийти повторно.
  • Ошибки записывай через PSR-3 (bitrix-logger); свои агенты удаляй при удалении модуля.
Files (bitrix-framework-skills)
  • rules
    • agents.md 7.2 KB
      Loading…
    • background-job.md 1.9 KB
      Loading…
    • messenger-config.md 5.6 KB
      Loading…
    • messenger.md 4.9 KB
      Loading…
  • SKILL.md 2.7 KB
    ---
    name: bitrix-background-jobs
    description: 'Используй для отложенной работы Битрикса: агенты CAgent, cron, Application::addBackgroundJob после ответа и очереди Messenger (messenger:consume). Выбор механизма, повторы и ошибки.'
    ---
    
    # Фоновые задания
    
    Baseline: main 23.0+ · Verified: main 26.1000.0
    
    Перед PHP-кодом прочитай `bitrix-framework`, если ещё не читал его в этой задаче.
    В таблице выбери только нужный `rules/*.md`; пути относительны каталогу скилла.
    
    | Задача | Читать |
    | --- | --- |
    | Периодическое или отложенное задание, агенты на cron, долгие агенты | `rules/agents.md` |
    | Короткая работа после ответа | `rules/background-job.md` |
    | Очередь: сообщение, получатель, отправка, повторы | `rules/messenger.md` |
    | Настройки очередей, брокеры, `messenger:consume`, очереди ядра | `rules/messenger-config.md` |
    
    Выбор: расписание → агент на cron; несколько секунд после ответа → `addBackgroundJob`; повторы, объём, параллельные исполнители → Messenger (**Since main 25.100.300**, альфа); разовая долгая миграция → консольная команда (`bitrix-console-commands`).
    
    ## Обязательные правила
    
    - Фоновый код не имеет контекста пользователя: агенты и получатели устанавливают `global $USER = null`; не используй `$_SESSION`/cookies. Передавай ID пользователя/сайта явно.
    - На хитах агенты, Messenger в режиме `web` и `addBackgroundJob()` выполняются после отправки ответа, `OnAfterEpilog` и `session_write_close()`, с пулом БД, переключённым на master.
    - Код задания только получает сервис через `ServiceLocator::getInstance()->get()` и вызывает его (DI конструктора агента недоступен — `bitrix-framework`).
    - Задания должны быть идемпотентными: агент может запуститься параллельно дважды, сообщение может прийти повторно.
    - Ошибки записывай через PSR-3 (`bitrix-logger`); свои агенты удаляй при удалении модуля.
    

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.