用途:为 Elixir/Phoenix 项目新增或加固 Oban(或类似)后台 worker 提供结构化开发手册,以硬性门禁(HARD-GATE)和范围检查约束实现流程。
主要能力:按阶段推进——设计(记录队列、仅含 ID 的 args、幂等键、瞬时与永久错误分类)、RED(先写会失败的 worker 测试,覆盖成功/取消/错误路径)、实现(perform/1 作为薄边缘:取 ID → 纯核心 → 返回 tagged tuple,从 context 而非 LiveView 入队)、失败路径(not_found 返回 {:cancel, _}、瞬时错误重试、永久错误丢弃、重复任务用 unique 或幂等键处理)、监控(生产环境附加 telemetry/日志)。
使用方式:该手册会加载 oban-essentials、testing-essentials、elixir-essentials、telemetry-essentials 等原子技能。提交 PR 前需通过 mix format --check-formatted、mix credo --strict 和完整 mix test 套件。输出为 Background Job Report,含设计、测试命令、各门禁 PASS/FAIL 与 APPROVE/REQUEST_CHANGES 结论。
适用场景:新增或加固 Oban 后台 worker,需要幂等设计、错误分类与失败路径测试的 Elixir/Phoenix 项目。
限制:资料未提供具体安装命令、版本要求、收费信息或平台细节;门禁未通过时需回到设计或测试阶段修正,不得在契约不清晰时编写 perform/1。