一句话解释
幂等是同一个操作执行一次和执行多次，最终效果一样。
小白比喻
按电梯上行键，按一次和按十次都只会让电梯来一次。
第一性原理
网络会失败、用户会连点、系统会重试，所以副作用操作必须能识别重复。
为什么 AI Coding 时代必须懂
AI 写接口时常忽略重试，商业系统里重复扣款、重复发货、重复通知都是大事故。
商业项目事故
支付回调超时后平台重试，系统没有幂等键，给用户充值两次。
指挥 Codex 时应该怎么问
请为这个写操作设计幂等策略，包括 idempotencyKey、唯一约束和重复请求返回。任务卡里应该怎么写
说明哪些操作必须幂等、幂等键来源、保存多久、重复时返回什么。
验收标准怎么写
同一幂等键重复请求不会产生第二次副作用，并返回可解释结果。
错误指令
失败就重试，成功就返回。
合格指令
创建退款请求必须带 idempotencyKey，重复调用返回原退款记录。