[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7BFVQFNPJDH19PW0BYZXEH3":3,"skill-same:01M7BFVQFNPJDH19PW0BYZXEH3":48},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":25,"commitSha":26,"skillDirectory":27,"forksCount":28,"repositoryHtmlUrl":29,"repositoryHomepageUrl":30,"ownerHtmlUrl":31,"ownerBlogUrl":6,"ownerDescription":32,"updatedAt":33,"install":34,"resources":47},"01M7BFVQFNPJDH19PW0BYZXEH3","django-celery",null,"Django + Celery async task patterns — configuration, task design, beat scheduling, retries, canvas workflows, monitoring, and testing. Use when adding background jobs, scheduled tasks, or async processing to a Django app.","YYC-Cube\u002FYYC3-Knowledge-Base","YYC-Cube","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F235006543?v=4","01M79J2PH4SWD2X0825X6PN748","yyc3","01M79J2PHVK3F6ZBYT8K2SCZCW",1,"MIT","https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base\u002Fblob\u002Fmain\u002FYYC3-AI-应用工具\u002FYYC3-AI-应用工具-Everything-claude-code\u002Fskills\u002Fdjango-celery\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: django-celery\ndescription: Django + Celery async task patterns — configuration, task design, beat scheduling, retries, canvas workflows, monitoring, and testing. Use when adding background jobs, scheduled tasks, or async processing to a Django app.\norigin: ECC\n---\n\n# Django + Celery Async Task Patterns\n\nProduction-grade patterns for background task processing in Django using Celery with Redis or RabbitMQ.\n\n## When to Activate\n\n- Adding background jobs or async processing to a Django app\n- Implementing periodic\u002Fscheduled tasks\n- Offloading slow operations (email, PDF generation, API calls) from request cycle\n- Setting up Celery Beat for cron-like scheduling\n- Debugging task failures, retries, or queue backlogs\n- Writing tests for Celery tasks\n\n## Project Setup\n\n### Installation\n\n```bash\npip install celery[redis] django-celery-results django-celery-beat\n```\n\n### `celery.py` — App Entrypoint\n\n```python\n# config\u002Fcelery.py\nimport os\nfrom celery import Celery\n\nos.environ.setdefault('DJANGO_SETTINGS_MODULE', 'config.settings.development')\n\napp = Celery('myproject')\napp.config_from_object('django.conf:settings', namespace='CELERY')\napp.autodiscover_tasks()  # Discovers tasks.py in each INSTALLED_APP\n\n@app.task(bind=True, ignore_result=True)\ndef debug_task(self):\n    print(f'Request: {self.request!r}')\n```\n\n```python\n# config\u002F__init__.py\nfrom .celery import app as celery_app\n\n__all__ = ('celery_app',)\n```\n\n### Django Settings\n\n```python\n# config\u002Fsettings\u002Fbase.py\n\n# Broker (Redis recommended for production)\nCELERY_BROKER_URL = env('CELERY_BROKER_URL', default='redis:\u002F\u002Flocalhost:6379\u002F0')\nCELERY_RESULT_BACKEND = env('CELERY_RESULT_BACKEND', default='django-db')\n\n# Serialization\nCELERY_ACCEPT_CONTENT = ['json']\nCELERY_TASK_SERIALIZER = 'json'\nCELERY_RESULT_SERIALIZER = 'json'\n\n# Task behavior\nCELERY_TASK_TRACK_STARTED = True\nCELERY_TASK_TIME_LIMIT = 30 * 60        # Hard limit: 30 min\nCELERY_TASK_SOFT_TIME_LIMIT = 25 * 60   # Soft limit: sends SoftTimeLimitExceeded\nCELERY_WORKER_PREFETCH_MULTIPLIER = 1   # Prevent worker hoarding long tasks\nCELERY_TASK_ACKS_LATE = True            # Re-queue on worker crash\n\n# Result persistence\nCELERY_RESULT_EXPIRES = 60 * 60 * 24   # Keep results 24 hours\n\n# Beat scheduler (for periodic tasks)\nCELERY_BEAT_SCHEDULER = 'django_celery_beat.schedulers:DatabaseScheduler'\n\n# Installed apps\nINSTALLED_APPS += [\n    'django_celery_results',\n    'django_celery_beat',\n]\n```\n\n### Running Workers\n\n```bash\n# Start worker (development)\ncelery -A config worker --loglevel=info\n\n# Start beat scheduler (periodic tasks)\ncelery -A config beat --loglevel=info --scheduler django_celery_beat.schedulers:DatabaseScheduler\n\n# Combined worker + beat (dev only, never production)\ncelery -A config worker --beat --loglevel=info\n\n# Production: multiple workers with concurrency\ncelery -A config worker --loglevel=warning --concurrency=4 -Q default,high_priority\n```\n\n## Task Design Patterns\n\n### Basic Task\n\n```python\n# apps\u002Fnotifications\u002Ftasks.py\nfrom celery import shared_task\nimport logging\n\nlogger = logging.getLogger(__name__)\n\n@shared_task(name='notifications.send_welcome_email')\ndef send_welcome_email(user_id: int) -> None:\n    \"\"\"Send welcome email to newly registered user.\"\"\"\n    from apps.users.models import User\n    from apps.notifications.services import EmailService\n\n    try:\n        user = User.objects.get(pk=user_id)\n    except User.DoesNotExist:\n        logger.warning('send_welcome_email: user %s not found', user_id)\n        return  # Idempotent — do not raise, task already impossible to complete\n\n    EmailService.send_welcome(user)\n    logger.info('Welcome email sent to user %s', user_id)\n```\n\n### Retryable Task\n\n```python\n@shared_task(\n    bind=True,\n    name='integrations.sync_to_crm',\n    max_retries=5,\n    default_retry_delay=60,       # seconds before first retry\n    autoretry_for=(ConnectionError, TimeoutError),\n    retry_backoff=True,           # exponential backoff\n    retry_backoff_max=600,        # cap at 10 minutes\n    retry_jitter=True,            # randomise to avoid thundering herd\n)\ndef sync_contact_to_crm(self, contact_id: int) -> dict:\n    \"\"\"Sync contact to external CRM with retry on transient failures.\"\"\"\n    from apps.crm.services import CRMClient\n\n    try:\n        result = CRMClient().sync(contact_id)\n        return result\n    except CRMClient.RateLimitError as exc:\n        # Specific retry delay from response header\n        raise self.retry(exc=exc, countdown=int(exc.retry_after))\n```\n\n### Idempotent Task Pattern\n\nDesign tasks so they can safely run multiple times with the same inputs:\n\n```python\n@shared_task(name='orders.mark_shipped')\ndef mark_order_shipped(order_id: int, tracking_number: str) -> None:\n    \"\"\"Mark order as shipped — safe to run multiple times.\"\"\"\n    from apps.orders.models import Order\n\n    updated = Order.objects.filter(\n        pk=order_id,\n        status=Order.Status.PROCESSING,    # Guard: only update if not already shipped\n    ).update(\n        status=Order.Status.SHIPPED,\n        tracking_number=tracking_number,\n    )\n\n    if not updated:\n        logger.info('mark_order_shipped: order %s already shipped or not found', order_id)\n```\n\n### Task with Soft Time Limit\n\n```python\nfrom celery.exceptions import SoftTimeLimitExceeded\n\n@shared_task(\n    bind=True,\n    name='reports.generate_pdf',\n    soft_time_limit=120,\n    time_limit=150,\n)\ndef generate_pdf_report(self, report_id: int) -> str:\n    \"\"\"Generate PDF report with graceful timeout handling.\"\"\"\n    from apps.reports.services import PDFGenerator\n\n    try:\n        path = PDFGenerator.build(report_id)\n        return path\n    except SoftTimeLimitExceeded:\n        # Clean up partial files before hard kill\n        PDFGenerator.cleanup(report_id)\n        raise\n```\n\n## Calling Tasks\n\n```python\nfrom datetime import timedelta\nfrom django.utils import timezone\n\n# Fire and forget (async)\nsend_welcome_email.delay(user.pk)\n\n# Schedule in the future\nsend_reminder.apply_async(args=[user.pk], countdown=3600)  # 1 hour from now\nsend_reminder.apply_async(args=[user.pk], eta=timezone.now() + timedelta(days=1))\n\n# Apply with queue routing\nsync_contact_to_crm.apply_async(args=[contact.pk], queue='high_priority')\n\n# Run synchronously (tests \u002F debugging only)\nresult = generate_pdf_report.apply(args=[report.pk])\n```\n\n## Beat Scheduling (Periodic Tasks)\n\n### Code-Defined Schedule\n\n```python\n# config\u002Fsettings\u002Fbase.py\nfrom celery.schedules import crontab\n\nCELERY_BEAT_SCHEDULE = {\n    'cleanup-expired-sessions': {\n        'task': 'users.cleanup_expired_sessions',\n        'schedule': crontab(hour=2, minute=0),   # 2am daily\n    },\n    'sync-inventory': {\n        'task': 'products.sync_inventory',\n        'schedule': 60.0,                         # every 60 seconds\n    },\n    'weekly-digest': {\n        'task': 'notifications.send_weekly_digest',\n        'schedule': crontab(day_of_week='monday', hour=8, minute=0),\n    },\n}\n```\n\n### Database-Defined Schedule (via django-celery-beat)\n\n```python\n# Manage periodic tasks from Django admin or code\nfrom django_celery_beat.models import PeriodicTask, CrontabSchedule\nimport json\n\nschedule, _ = CrontabSchedule.objects.get_or_create(\n    hour='*\u002F6', minute='0',\n    timezone='UTC',\n)\n\nPeriodicTask.objects.update_or_create(\n    name='Sync inventory every 6 hours',\n    defaults={\n        'crontab': schedule,\n        'task': 'products.sync_inventory',\n        'args': json.dumps([]),\n        'enabled': True,\n    }\n)\n```\n\n## Canvas: Chaining and Grouping Tasks\n\n```python\nfrom celery import chain, group, chord\n\n# Chain: run tasks sequentially, passing results\npipeline = chain(\n    fetch_data.s(source_id),\n    transform_data.s(),          # receives fetch_data result as first arg\n    load_to_warehouse.s(),\n)\npipeline.delay()\n\n# Group: run tasks in parallel\nparallel = group(\n    send_welcome_email.s(user_id)\n    for user_id in new_user_ids\n)\nparallel.delay()\n\n# Chord: parallel tasks + callback when all complete\nresult = chord(\n    group(process_chunk.s(chunk) for chunk in data_chunks),\n    aggregate_results.s(),       # called with list of chunk results\n)\nresult.delay()\n```\n\n## Error Handling and Dead Letter Queue\n\n```python\n# apps\u002Fcore\u002Ftasks.py\nfrom celery.signals import task_failure\n\n@task_failure.connect\ndef on_task_failure(sender, task_id, exception, args, kwargs, traceback, einfo, **kw):\n    \"\"\"Log all task failures to Sentry \u002F alerting.\"\"\"\n    import sentry_sdk\n    with sentry_sdk.new_scope() as scope:\n        scope.set_context('celery', {\n            'task': sender.name,\n            'task_id': task_id,\n            'args': args,\n            'kwargs': kwargs,\n        })\n        sentry_sdk.capture_exception(exception)\n```\n\n```python\n# Route failed tasks to dead-letter queue after max retries\n@shared_task(\n    bind=True,\n    max_retries=3,\n    name='payments.charge_card',\n)\ndef charge_card(self, order_id: int) -> None:\n    from apps.payments.models import Order, FailedCharge\n\n    try:\n        _do_charge(order_id)\n    except Exception as exc:\n        if self.request.retries >= self.max_retries:\n            # Persist to dead-letter table for manual review\n            FailedCharge.objects.create(\n                order_id=order_id,\n                error=str(exc),\n                task_id=self.request.id,\n            )\n            return  # Don't raise — task is permanently failed\n        raise self.retry(exc=exc)\n```\n\n## Testing Celery Tasks\n\n### Unit Testing (No Broker)\n\n```python\n# tests\u002Ftest_tasks.py\nimport pytest\nfrom unittest.mock import patch, MagicMock\nfrom apps.notifications.tasks import send_welcome_email\n\nclass TestSendWelcomeEmail:\n\n    @pytest.mark.django_db\n    def test_sends_email_to_existing_user(self, user):\n        with patch('apps.notifications.services.EmailService') as mock_email:\n            send_welcome_email(user.pk)\n            mock_email.send_welcome.assert_called_once_with(user)\n\n    @pytest.mark.django_db\n    def test_skips_missing_user_gracefully(self):\n        \"\"\"Should not raise when user is deleted between enqueue and execute.\"\"\"\n        send_welcome_email(99999)  # Non-existent user — must not raise\n```\n\n### Integration Testing with CELERY_TASK_ALWAYS_EAGER\n\n```python\n# config\u002Fsettings\u002Ftest.py\nCELERY_TASK_ALWAYS_EAGER = True      # Run tasks synchronously in tests\nCELERY_TASK_EAGER_PROPAGATES = True  # Re-raise exceptions from tasks\n\n# tests\u002Ftest_integration.py\n@pytest.mark.django_db\ndef test_registration_triggers_welcome_email(client):\n    with patch('apps.notifications.services.EmailService') as mock_email:\n        response = client.post('\u002Fapi\u002Fusers\u002F', {\n            'email': 'new@example.com',\n            'password': 'strongpass123',\n        })\n\n    assert response.status_code == 201\n    mock_email.send_welcome.assert_called_once()\n```\n\n### Testing Retries\n\n```python\n@pytest.mark.django_db\ndef test_task_retries_on_connection_error():\n    with patch('apps.crm.services.CRMClient.sync') as mock_sync:\n        mock_sync.side_effect = ConnectionError('timeout')\n\n        with pytest.raises(ConnectionError):\n            sync_contact_to_crm.apply(args=[1], throw=True)\n\n        assert mock_sync.call_count == 1  # First attempt only when eager\n```\n\n## Monitoring\n\n```bash\n# Inspect active workers and queues\ncelery -A config inspect active\ncelery -A config inspect stats\ncelery -A config inspect reserved\n\n# Check queue lengths (Redis)\nredis-cli llen celery\n\n# Flower: web-based real-time monitor\npip install flower\ncelery -A config flower --port=5555\n```\n\n## Anti-Patterns\n\n```python\n# BAD: Passing model instances — they may be stale by execution time\nsend_welcome_email.delay(user)        # Never pass ORM objects\nsend_welcome_email.delay(user.pk)     # Always pass PKs\n\n# BAD: Calling tasks synchronously in production views\nresult = generate_report.apply()      # Blocks the request thread\n\n# BAD: Non-idempotent task without guards\n@shared_task\ndef charge_and_fulfill(order_id):\n    order.charge()     # May charge twice if task retries!\n    order.fulfill()\n\n# GOOD: Idempotent with status guard\n@shared_task\ndef charge_and_fulfill(order_id):\n    order = Order.objects.select_for_update().get(pk=order_id)\n    if order.status != Order.Status.PENDING:\n        return  # Already processed\n    order.charge()\n    order.fulfill()\n```\n\n## Production Checklist\n\n| Check | Setting |\n|-------|---------|\n| Worker restarts on crash | `supervisord` or `systemd` unit |\n| `CELERY_TASK_ACKS_LATE = True` | Re-queue tasks on worker crash |\n| `CELERY_WORKER_PREFETCH_MULTIPLIER = 1` | Fair distribution of long tasks |\n| Separate queues per priority | `-Q default,high_priority,low_priority` |\n| `CELERY_TASK_SOFT_TIME_LIMIT` set | Graceful timeout before hard kill |\n| Sentry integration | Capture all `task_failure` signals |\n| Flower or other monitor | Visibility into queue depths |\n| Beat runs on single node only | Prevents duplicate scheduled task execution |\n\n## Related Skills\n\n- `django-patterns` — ORM, service layer, and project structure\n- `django-tdd` — Testing Django models, views, and services\n- `python-testing` — pytest configuration and fixtures\n","# Django + Celery Async Task Patterns\n\nProduction-grade patterns for background task processing in Django using Celery with Redis or RabbitMQ.\n\n## When to Activate\n\n- Adding background jobs or async processing to a Django app\n- Implementing periodic\u002Fscheduled tasks\n- Offloading slow operations (email, PDF generation, API calls) from request cycle\n- Setting up Celery Beat for cron-like scheduling\n- Debugging task failures, retries, or queue backlogs\n- Writing tests for Celery tasks\n\n## Project Setup\n\n### Installation\n\n```bash\npip install celery[redis] django-celery-results django-celery-beat\n```\n\n### `celery.py` — App Entrypoint\n\n```python\n# config\u002Fcelery.py\nimport os\nfrom celery import Celery\n\nos.environ.setdefault('DJANGO_SETTINGS_MODULE', 'config.settings.development')\n\napp = Celery('myproject')\napp.config_from_object('django.conf:settings', namespace='CELERY')\napp.autodiscover_tasks()  # Discovers tasks.py in each INSTALLED_APP\n\n@app.task(bind=True, ignore_result=True)\ndef debug_task(self):\n    print(f'Request: {self.request!r}')\n```\n\n```python\n# config\u002F__init__.py\nfrom .celery import app as celery_app\n\n__all__ = ('celery_app',)\n```\n\n### Django Settings\n\n```python\n# config\u002Fsettings\u002Fbase.py\n\n# Broker (Redis recommended for production)\nCELERY_BROKER_URL = env('CELERY_BROKER_URL', default='redis:\u002F\u002Flocalhost:6379\u002F0')\nCELERY_RESULT_BACKEND = env('CELERY_RESULT_BACKEND', default='django-db')\n\n# Serialization\nCELERY_ACCEPT_CONTENT = ['json']\nCELERY_TASK_SERIALIZER = 'json'\nCELERY_RESULT_SERIALIZER = 'json'\n\n# Task behavior\nCELERY_TASK_TRACK_STARTED = True\nCELERY_TASK_TIME_LIMIT = 30 * 60        # Hard limit: 30 min\nCELERY_TASK_SOFT_TIME_LIMIT = 25 * 60   # Soft limit: sends SoftTimeLimitExceeded\nCELERY_WORKER_PREFETCH_MULTIPLIER = 1   # Prevent worker hoarding long tasks\nCELERY_TASK_ACKS_LATE = True            # Re-queue on worker crash\n\n# Result persistence\nCELERY_RESULT_EXPIRES = 60 * 60 * 24   # Keep results 24 hours\n\n# Beat scheduler (for periodic tasks)\nCELERY_BEAT_SCHEDULER = 'django_celery_beat.schedulers:DatabaseScheduler'\n\n# Installed apps\nINSTALLED_APPS += [\n    'django_celery_results',\n    'django_celery_beat',\n]\n```\n\n### Running Workers\n\n```bash\n# Start worker (development)\ncelery -A config worker --loglevel=info\n\n# Start beat scheduler (periodic tasks)\ncelery -A config beat --loglevel=info --scheduler django_celery_beat.schedulers:DatabaseScheduler\n\n# Combined worker + beat (dev only, never production)\ncelery -A config worker --beat --loglevel=info\n\n# Production: multiple workers with concurrency\ncelery -A config worker --loglevel=warning --concurrency=4 -Q default,high_priority\n```\n\n## Task Design Patterns\n\n### Basic Task\n\n```python\n# apps\u002Fnotifications\u002Ftasks.py\nfrom celery import shared_task\nimport logging\n\nlogger = logging.getLogger(__name__)\n\n@shared_task(name='notifications.send_welcome_email')\ndef send_welcome_email(user_id: int) -> None:\n    \"\"\"Send welcome email to newly registered user.\"\"\"\n    from apps.users.models import User\n    from apps.notifications.services import EmailService\n\n    try:\n        user = User.objects.get(pk=user_id)\n    except User.DoesNotExist:\n        logger.warning('send_welcome_email: user %s not found', user_id)\n        return  # Idempotent — do not raise, task already impossible to complete\n\n    EmailService.send_welcome(user)\n    logger.info('Welcome email sent to user %s', user_id)\n```\n\n### Retryable Task\n\n```python\n@shared_task(\n    bind=True,\n    name='integrations.sync_to_crm',\n    max_retries=5,\n    default_retry_delay=60,       # seconds before first retry\n    autoretry_for=(ConnectionError, TimeoutError),\n    retry_backoff=True,           # exponential backoff\n    retry_backoff_max=600,        # cap at 10 minutes\n    retry_jitter=True,            # randomise to avoid thundering herd\n)\ndef sync_contact_to_crm(self, contact_id: int) -> dict:\n    \"\"\"Sync contact to external CRM with retry on transient failures.\"\"\"\n    from apps.crm.services import CRMClient\n\n    try:\n        result = CRMClient().sync(contact_id)\n        return result\n    except CRMClient.RateLimitError as exc:\n        # Specific retry delay from response header\n        raise self.retry(exc=exc, countdown=int(exc.retry_after))\n```\n\n### Idempotent Task Pattern\n\nDesign tasks so they can safely run multiple times with the same inputs:\n\n```python\n@shared_task(name='orders.mark_shipped')\ndef mark_order_shipped(order_id: int, tracking_number: str) -> None:\n    \"\"\"Mark order as shipped — safe to run multiple times.\"\"\"\n    from apps.orders.models import Order\n\n    updated = Order.objects.filter(\n        pk=order_id,\n        status=Order.Status.PROCESSING,    # Guard: only update if not already shipped\n    ).update(\n        status=Order.Status.SHIPPED,\n        tracking_number=tracking_number,\n    )\n\n    if not updated:\n        logger.info('mark_order_shipped: order %s already shipped or not found', order_id)\n```\n\n### Task with Soft Time Limit\n\n```python\nfrom celery.exceptions import SoftTimeLimitExceeded\n\n@shared_task(\n    bind=True,\n    name='reports.generate_pdf',\n    soft_time_limit=120,\n    time_limit=150,\n)\ndef generate_pdf_report(self, report_id: int) -> str:\n    \"\"\"Generate PDF report with graceful timeout handling.\"\"\"\n    from apps.reports.services import PDFGenerator\n\n    try:\n        path = PDFGenerator.build(report_id)\n        return path\n    except SoftTimeLimitExceeded:\n        # Clean up partial files before hard kill\n        PDFGenerator.cleanup(report_id)\n        raise\n```\n\n## Calling Tasks\n\n```python\nfrom datetime import timedelta\nfrom django.utils import timezone\n\n# Fire and forget (async)\nsend_welcome_email.delay(user.pk)\n\n# Schedule in the future\nsend_reminder.apply_async(args=[user.pk], countdown=3600)  # 1 hour from now\nsend_reminder.apply_async(args=[user.pk], eta=timezone.now() + timedelta(days=1))\n\n# Apply with queue routing\nsync_contact_to_crm.apply_async(args=[contact.pk], queue='high_priority')\n\n# Run synchronously (tests \u002F debugging only)\nresult = generate_pdf_report.apply(args=[report.pk])\n```\n\n## Beat Scheduling (Periodic Tasks)\n\n### Code-Defined Schedule\n\n```python\n# config\u002Fsettings\u002Fbase.py\nfrom celery.schedules import crontab\n\nCELERY_BEAT_SCHEDULE = {\n    'cleanup-expired-sessions': {\n        'task': 'users.cleanup_expired_sessions',\n        'schedule': crontab(hour=2, minute=0),   # 2am daily\n    },\n    'sync-inventory': {\n        'task': 'products.sync_inventory',\n        'schedule': 60.0,                         # every 60 seconds\n    },\n    'weekly-digest': {\n        'task': 'notifications.send_weekly_digest',\n        'schedule': crontab(day_of_week='monday', hour=8, minute=0),\n    },\n}\n```\n\n### Database-Defined Schedule (via django-celery-beat)\n\n```python\n# Manage periodic tasks from Django admin or code\nfrom django_celery_beat.models import PeriodicTask, CrontabSchedule\nimport json\n\nschedule, _ = CrontabSchedule.objects.get_or_create(\n    hour='*\u002F6', minute='0',\n    timezone='UTC',\n)\n\nPeriodicTask.objects.update_or_create(\n    name='Sync inventory every 6 hours',\n    defaults={\n        'crontab': schedule,\n        'task': 'products.sync_inventory',\n        'args': json.dumps([]),\n        'enabled': True,\n    }\n)\n```\n\n## Canvas: Chaining and Grouping Tasks\n\n```python\nfrom celery import chain, group, chord\n\n# Chain: run tasks sequentially, passing results\npipeline = chain(\n    fetch_data.s(source_id),\n    transform_data.s(),          # receives fetch_data result as first arg\n    load_to_warehouse.s(),\n)\npipeline.delay()\n\n# Group: run tasks in parallel\nparallel = group(\n    send_welcome_email.s(user_id)\n    for user_id in new_user_ids\n)\nparallel.delay()\n\n# Chord: parallel tasks + callback when all complete\nresult = chord(\n    group(process_chunk.s(chunk) for chunk in data_chunks),\n    aggregate_results.s(),       # called with list of chunk results\n)\nresult.delay()\n```\n\n## Error Handling and Dead Letter Queue\n\n```python\n# apps\u002Fcore\u002Ftasks.py\nfrom celery.signals import task_failure\n\n@task_failure.connect\ndef on_task_failure(sender, task_id, exception, args, kwargs, traceback, einfo, **kw):\n    \"\"\"Log all task failures to Sentry \u002F alerting.\"\"\"\n    import sentry_sdk\n    with sentry_sdk.new_scope() as scope:\n        scope.set_context('celery', {\n            'task': sender.name,\n            'task_id': task_id,\n            'args': args,\n            'kwargs': kwargs,\n        })\n        sentry_sdk.capture_exception(exception)\n```\n\n```python\n# Route failed tasks to dead-letter queue after max retries\n@shared_task(\n    bind=True,\n    max_retries=3,\n    name='payments.charge_card',\n)\ndef charge_card(self, order_id: int) -> None:\n    from apps.payments.models import Order, FailedCharge\n\n    try:\n        _do_charge(order_id)\n    except Exception as exc:\n        if self.request.retries >= self.max_retries:\n            # Persist to dead-letter table for manual review\n            FailedCharge.objects.create(\n                order_id=order_id,\n                error=str(exc),\n                task_id=self.request.id,\n            )\n            return  # Don't raise — task is permanently failed\n        raise self.retry(exc=exc)\n```\n\n## Testing Celery Tasks\n\n### Unit Testing (No Broker)\n\n```python\n# tests\u002Ftest_tasks.py\nimport pytest\nfrom unittest.mock import patch, MagicMock\nfrom apps.notifications.tasks import send_welcome_email\n\nclass TestSendWelcomeEmail:\n\n    @pytest.mark.django_db\n    def test_sends_email_to_existing_user(self, user):\n        with patch('apps.notifications.services.EmailService') as mock_email:\n            send_welcome_email(user.pk)\n            mock_email.send_welcome.assert_called_once_with(user)\n\n    @pytest.mark.django_db\n    def test_skips_missing_user_gracefully(self):\n        \"\"\"Should not raise when user is deleted between enqueue and execute.\"\"\"\n        send_welcome_email(99999)  # Non-existent user — must not raise\n```\n\n### Integration Testing with CELERY_TASK_ALWAYS_EAGER\n\n```python\n# config\u002Fsettings\u002Ftest.py\nCELERY_TASK_ALWAYS_EAGER = True      # Run tasks synchronously in tests\nCELERY_TASK_EAGER_PROPAGATES = True  # Re-raise exceptions from tasks\n\n# tests\u002Ftest_integration.py\n@pytest.mark.django_db\ndef test_registration_triggers_welcome_email(client):\n    with patch('apps.notifications.services.EmailService') as mock_email:\n        response = client.post('\u002Fapi\u002Fusers\u002F', {\n            'email': 'new@example.com',\n            'password': 'strongpass123',\n        })\n\n    assert response.status_code == 201\n    mock_email.send_welcome.assert_called_once()\n```\n\n### Testing Retries\n\n```python\n@pytest.mark.django_db\ndef test_task_retries_on_connection_error():\n    with patch('apps.crm.services.CRMClient.sync') as mock_sync:\n        mock_sync.side_effect = ConnectionError('timeout')\n\n        with pytest.raises(ConnectionError):\n            sync_contact_to_crm.apply(args=[1], throw=True)\n\n        assert mock_sync.call_count == 1  # First attempt only when eager\n```\n\n## Monitoring\n\n```bash\n# Inspect active workers and queues\ncelery -A config inspect active\ncelery -A config inspect stats\ncelery -A config inspect reserved\n\n# Check queue lengths (Redis)\nredis-cli llen celery\n\n# Flower: web-based real-time monitor\npip install flower\ncelery -A config flower --port=5555\n```\n\n## Anti-Patterns\n\n```python\n# BAD: Passing model instances — they may be stale by execution time\nsend_welcome_email.delay(user)        # Never pass ORM objects\nsend_welcome_email.delay(user.pk)     # Always pass PKs\n\n# BAD: Calling tasks synchronously in production views\nresult = generate_report.apply()      # Blocks the request thread\n\n# BAD: Non-idempotent task without guards\n@shared_task\ndef charge_and_fulfill(order_id):\n    order.charge()     # May charge twice if task retries!\n    order.fulfill()\n\n# GOOD: Idempotent with status guard\n@shared_task\ndef charge_and_fulfill(order_id):\n    order = Order.objects.select_for_update().get(pk=order_id)\n    if order.status != Order.Status.PENDING:\n        return  # Already processed\n    order.charge()\n    order.fulfill()\n```\n\n## Production Checklist\n\n| Check | Setting |\n|-------|---------|\n| Worker restarts on crash | `supervisord` or `systemd` unit |\n| `CELERY_TASK_ACKS_LATE = True` | Re-queue tasks on worker crash |\n| `CELERY_WORKER_PREFETCH_MULTIPLIER = 1` | Fair distribution of long tasks |\n| Separate queues per priority | `-Q default,high_priority,low_priority` |\n| `CELERY_TASK_SOFT_TIME_LIMIT` set | Graceful timeout before hard kill |\n| Sentry integration | Capture all `task_failure` signals |\n| Flower or other monitor | Visibility into queue depths |\n| Beat runs on single node only | Prevents duplicate scheduled task execution |\n\n## Related Skills\n\n- `django-patterns` — ORM, service layer, and project structure\n- `django-tdd` — Testing Django models, views, and services\n- `python-testing` — pytest configuration and fixtures\n",{"name":5,"origin":24,"description":7},"ECC","main","87afe6ce96220accf50a345dea46784c8c9f210e","YYC3-AI-应用工具\u002FYYC3-AI-应用工具-Everything-claude-code\u002Fskills\u002Fdjango-celery",0,"https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base","https:\u002F\u002Fkb.yyc3.top\u002F","https:\u002F\u002Fgithub.com\u002FYYC-Cube","万象归元于云枢 | 深栈智启新纪元","2026-11-10 10:37:32",{"source":8,"skillName":5,"commands":35,"prompt":45,"zipAvailable":46},[36,39,42],{"tool":37,"command":38},"npx","npx skills add YYC-Cube\u002FYYC3-Knowledge-Base --skill django-celery",{"tool":40,"command":41},"bunx","bunx skills add YYC-Cube\u002FYYC3-Knowledge-Base --skill django-celery",{"tool":43,"command":44},"pnpm","pnpm dlx skills add YYC-Cube\u002FYYC3-Knowledge-Base --skill django-celery","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base\u002Fblob\u002Fmain\u002FYYC3-AI-应用工具\u002FYYC3-AI-应用工具-Everything-claude-code\u002Fskills\u002Fdjango-celery\u002FSKILL.md",true,[],[49,56,63,70,77,84],{"skillNo":50,"name":51,"nameZh":6,"description":52,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":53,"categories":54,"keywords":55,"publishedAt":19},"01M7CTDWHERCXPQCP0K03A86AS","vercel-sandbox","Run agent-browser + Chrome inside Vercel Sandbox microVMs for browser automation from any Vercel-deployed app. Use when the user needs browser automation in a Vercel app (Next.js, SvelteKit, Nuxt, Remix, Astro, etc.), wants to run headless Chrome without binary size limits, needs persistent browser sessions across commands, or wants ephemeral isolated browser environments. Triggers include \"Vercel Sandbox browser\", \"microVM Chrome\", \"agent-browser in sandbox\", \"browser automation on Vercel\", or any task requiring Chrome in a Vercel Sandbox.","https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base\u002Fblob\u002Fmain\u002FYYC3-WebSpec-Web标准\u002FYYC3-WebSpec-Web标准-standards\u002Fbrowser-agent\u002Fskills\u002Fvercel-sandbox\u002FSKILL.md",[],[],{"skillNo":57,"name":58,"nameZh":6,"description":59,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":60,"categories":61,"keywords":62,"publishedAt":19},"01M7CTD8D2BNJY54S65M47HEJA","slack","Interact with Slack workspaces using browser automation. Use when the user needs to check unread channels, navigate Slack, send messages, extract data, find information, search conversations, or automate any Slack task. Triggers include \"check my Slack\", \"what channels have unreads\", \"send a message to\", \"search Slack for\", \"extract from Slack\", \"find who said\", or any task requiring programmatic Slack interaction.","https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base\u002Fblob\u002Fmain\u002FYYC3-WebSpec-Web标准\u002FYYC3-WebSpec-Web标准-standards\u002Fbrowser-agent\u002Fskills\u002Fslack\u002FSKILL.md",[],[],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":19},"01M7CTCSSB8ZP3Q58C3YZDZK1W","electron","Automate Electron desktop apps (VS Code, Slack, Discord, Figma, Notion, Spotify, etc.) using agent-browser via Chrome DevTools Protocol. Use when the user needs to interact with an Electron app, automate a desktop app, connect to a running app, control a native app, or test an Electron application. Triggers include \"automate Slack app\", \"control VS Code\", \"interact with Discord app\", \"test this Electron app\", \"connect to desktop app\", or any task requiring automation of a native Electron application.","https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base\u002Fblob\u002Fmain\u002FYYC3-WebSpec-Web标准\u002FYYC3-WebSpec-Web标准-standards\u002Fbrowser-agent\u002Fskills\u002Felectron\u002FSKILL.md",[],[],{"skillNo":71,"name":72,"nameZh":6,"description":73,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":19},"01M7CTCBJY76688V4DCZGWFHGQ","dogfood","Systematically explore and test a web application to find bugs, UX issues, and other problems. Use when asked to \"dogfood\", \"QA\", \"exploratory test\", \"find issues\", \"bug hunt\", \"test this app\u002Fsite\u002Fplatform\", or review the quality of a web application. Produces a structured report with full reproduction evidence -- step-by-step screenshots, repro videos, and detailed repro steps for every issue -- so findings can be handed directly to the responsible teams.","https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base\u002Fblob\u002Fmain\u002FYYC3-WebSpec-Web标准\u002FYYC3-WebSpec-Web标准-standards\u002Fbrowser-agent\u002Fskills\u002Fdogfood\u002FSKILL.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":19},"01M7CTC4H0FFGVEAQR9PA4GA1A","agent-browser","Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to \"open a website\", \"fill out a form\", \"click a button\", \"take a screenshot\", \"scrape data from a page\", \"test this web app\", \"login to a site\", \"automate browser actions\", or any task requiring programmatic web interaction.","https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base\u002Fblob\u002Fmain\u002FYYC3-WebSpec-Web标准\u002FYYC3-WebSpec-Web标准-standards\u002Fbrowser-agent\u002Fskills\u002Fagent-browser\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":19},"01M7CTBKVFYBG78FDSABSDJTTQ","shadcn","Manages shadcn components and projects — adding, searching, fixing, debugging, styling, and composing UI, including chat interfaces. Provides project context, component docs, and usage examples. Applies when working with shadcn\u002Fui, component registries, presets, --preset codes, or any project with a components.json file. Also triggers for \"shadcn init\", \"create an app with --preset\", \"switch to --preset\", and for building a design system or applying a DESIGN.md or brand spec to shadcn\u002Fui.","https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base\u002Fblob\u002Fmain\u002FYYC3-UI-界面组件\u002FYYC3-UI-界面组件-ui\u002Fskills\u002Fshadcn\u002FSKILL.md",[],[]]