用途
retry-idempotency 是一个面向 AI 编码与工程实践的场景化技能说明,用于在需要加入重试机制时,指导开发者先评估操作是否具备幂等性。资料给出的适用场景包括:超时、瞬时错误、重复投递、进程中断,以及确认结果不明确(uncertain acknowledgement)。
主要能力与规则
该技能的核心规则是:在添加重试之前,先证明重复执行该操作不会造成副作用重复或损坏。具体包括:
- 优先采用天然幂等的操作,或附加 operation/idempotency key(操作键、幂等键),使接收方能据此去重。
- 遇到不明确的超时后,先读取权威状态(authoritative state),再决定是否盲目重发写入。
- 对错误进行分类:可重试瞬时的传输或容量类失败,不应重试永久性的校验、认证或配置类失败。
- 使用有界尝试次数(bounded attempts)和带抖动(jitter)的退避,以应对多个客户端可能同步重试的情况。
- 对于安装器与迁移,要求在每一个受支持的中断点之后重跑时,都能收敛到唯一有效状态。
- 对于外部写入,尽可能验证 exactly-once(恰好一次)的结果。
- 如果无法保证安全重试,应暴露不确定性并要求进行对账(reconciliation),而不是放大副作用。
使用方式
资料未提供具体的调用方式、安装命令或代码示例。该页面位于 skills.sh 的技能包路径下,属于一条技能说明条目,而非给出 API 或库接口的文档。实际使用时应将其作为工程准则,在设计与实现重试逻辑时对照检查。
适用场景
适用于需要处理网络请求重试、消息重复投递、任务中断恢复、安装器或数据库迁移重跑、外部系统写入等可能因重试而产生重复副作用的工程场景。
限制
资料仅给出规则性描述,未提供具体实现、工具支持、平台范围、收费信息或效果数据,这些内容暂未提供。