AgentSkillsCN

monolith-job-development

适用于创建或扩展异步后台任务时使用，包括生成器的使用、队列注册、负载处理，以及工作者生命周期的管理。

SKILL.md
--- frontmatter
name: monolith-job-development
description: Use when creating or extending asynchronous background jobs, including generator usage, queue registration, payload handling, and worker lifecycle.

Monolith Job Development

Use this skill when

  • •Adding new async work to app/jobs/.
  • •Updating queue handlers or job scheduling behavior.

Fast path

Run: make generator job <Name>

This typically:

  • •creates app/jobs/<name>_job.go
  • •creates matching test file
  • •adds job type constant in app/models/job.go
  • •registers handler in app/jobs/job_queue.go

Runtime architecture

  • •Queue initialized via jobs.InitJobQueue() in main.go.
  • •Worker count controlled by config.JOB_QUEUE_NUM_WORKERS.
  • •Jobs are typed via models.JobType* enums and payload bytes.

Implementation workflow

  1. •Define payload struct and marshal/unmarshal strategy.
  2. •Implement generated job handler body.
  3. •Register handler (generator usually does this).
  4. •Enqueue from controller/service as needed.
  5. •Add focused tests for decoding + handler behavior.

Reliability tips

  • •Keep handlers idempotent where possible.
  • •Log failures with useful context.
  • •Treat malformed payloads as explicit errors.