用途:按仓库既有任务系统(队列/定时/worker)实现后台工作,覆盖显式幂等保证、有界重试与退避、持久状态与可重入安全,以及足以运维的日志/指标/追踪。适用于异步、定时、长时运行或需跨重启存活的任务。
主要能力:定义任务契约(载荷结构、执行保证、预期副作用);建立幂等机制(幂等键加去重存储,或记录安全的近似一次策略);实现薄编排处理器,调用领域模块与适配器;设定有界重试与退避并区分可重试与永久错误;在仓库支持时加入死信或隔离路径;补充可观测性(起止日志、关键字段、指标、关联 ID);编写单元与集成测试。
使用方式:先识别任务框架与约定(优先读取 REPO_PROFILE.json);定义载荷模式与执行保证;确定幂等键与去重边界;实现处理器并保持其薄;定义重试策略与错误分类;加入死信行为;添加可观测性与测试;运行仓库校验。若任务引入多步分支、重试、轮询状态或退避,建议配合 system/state-machine-mapper。
限制:不在处理器内实现领域规则(用 backend/domain-logic-module);不处理外部 API 集成细节(用 backend/integration-adapter);除幂等追踪所需外不做模式变更(用 backend/persistence-layer-change)。幂等不明确时应阻塞直至定义;任务框架未知时查阅仓库文档或建议 personalize-repo;重试策略不安全时默认不重试并记录原因。