docs(agentrun): 收口重试与资源包可靠性

.agents/skills/unidesk-code-queue/references/resources.md

@@ -1,10 +1,21 @@
-# AgentRun Resources
+# AgentRun 资源原语
 
-New Code Queue work uses AgentRun resource primitives:
+新 Code Queue 工作统一使用 AgentRun 资源原语：
 
-- `agentrun create|apply` for task/AipodSpec manifests.
-- `agentrun get|describe` for bounded list/detail reads.
-- `agentrun events|logs|result` for progressive disclosure.
-- `agentrun dispatch|ack|cancel` for lifecycle control.
+- `agentrun create|apply`：创建 task 或应用 AipodSpec manifest；
+- `agentrun get|describe`：有界读取列表和详情；
+- `agentrun events|logs|result`：渐进披露运行证据；
+- `agentrun get attempts --task <taskId>`：读取同一 task 的不可变 attempt 历史；
+- `agentrun retry task/<taskId> --idempotency-key <key> --reason <text> [--dry-run]`：对终态失败 task 创建下一次 attempt；
+- `agentrun dispatch|ack|cancel`：控制生命周期。
 
-Do not add new mutation paths under legacy `codex`.
+retry 必须遵守以下边界：
+
+- task identity 不变，每次执行使用新的 attempt、run、command 和 runner Job identity；
+- 同一幂等键返回同一 retry 结果，不重复创建 attempt；
+- 只允许 Queue 已处于 `failed` 或 `blocked`，其他终态与非终态 fail closed；
+- `--dry-run` 由服务端完成与真实 retry 相同的校验，但零写入；
+- retry 不主动刷新 Core 终态。若 Queue 摘要仍是非终态，先通过正式 `get task` 或 `get attempts` 刷新权威状态，再重试；
+- 禁止复制或重置 task，禁止在 UniDesk 增加 scheduler、backoff、judge、projector 或直接 runner 编排。
+
+不要在 legacy `codex` 下增加新的 mutation 路径。