From def35a96c75ada36203f2fc73f27cb53d68e09e9 Mon Sep 17 00:00:00 2001
From: Codex <codex@local>
Date: Sun, 12 Jul 2026 03:46:00 +0200
Subject: [PATCH] =?UTF-8?q?docs(skill):=20=E5=9B=BA=E5=8C=96=20AgentRun=20?=
 =?UTF-8?q?=E4=BA=8B=E4=BB=B6=E6=B8=90=E8=BF=9B=E6=8A=AB=E9=9C=B2?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .agents/skills/unidesk-code-queue/SKILL.md                | 8 ++++----
 .agents/skills/unidesk-code-queue/references/resources.md | 8 ++++++++
 2 files changed, 12 insertions(+), 4 deletions(-)

diff --git a/.agents/skills/unidesk-code-queue/SKILL.md b/.agents/skills/unidesk-code-queue/SKILL.md
index 24edcdca..794db9c9 100644
--- a/.agents/skills/unidesk-code-queue/SKILL.md
+++ b/.agents/skills/unidesk-code-queue/SKILL.md
@@ -11,10 +11,10 @@ description: UniDesk AgentRun-backed Code Queue CLI — Skill(cli-spec)。legacy
 
 ```bash
 bun scripts/cli.ts agentrun get task --limit 20
-bun scripts/cli.ts agentrun describe task <task>
-bun scripts/cli.ts agentrun events <task> --limit 80
-bun scripts/cli.ts agentrun logs <task> --tail 120
-bun scripts/cli.ts agentrun result <task>
+bun scripts/cli.ts agentrun describe task/<taskId>
+bun scripts/cli.ts agentrun events run/<runId> --limit 20
+bun scripts/cli.ts agentrun logs session/<sessionId> --tail 120
+bun scripts/cli.ts agentrun result command/<commandId> --run <runId>
 bun scripts/cli.ts agentrun get attempts --task <taskId>
 bun scripts/cli.ts agentrun retry task/<taskId> --idempotency-key <key> --reason <text> --dry-run
 bun scripts/cli.ts agentrun send <session> --prompt-stdin
diff --git a/.agents/skills/unidesk-code-queue/references/resources.md b/.agents/skills/unidesk-code-queue/references/resources.md
index 38900add..7e1dfdd2 100644
--- a/.agents/skills/unidesk-code-queue/references/resources.md
+++ b/.agents/skills/unidesk-code-queue/references/resources.md
@@ -9,6 +9,14 @@
 - `agentrun retry task/<taskId> --idempotency-key <key> --reason <text> [--dry-run]`：对终态失败 task 创建下一次 attempt；
 - `agentrun dispatch|ack|cancel`：控制生命周期。
 
+`agentrun events` 是高频渐进披露入口：
+
+- 默认 human、`-o json` 和 `-o yaml` 最多返回 20 条同构事件摘要，并用一条 lookahead 披露 `hasMore` 与 `nextAfterSeq`；
+- tool call 只展示 identity、seq/type/status、commandId、工具、命令首行、exit/duration、output bytes/hash、truncation 与 `outputOmitted`；
+- 默认不得展开 stdout、stderr、skill 正文或完整 payload，也不得通过提高全局 stdout 阈值掩盖 dump；
+- 完整事件使用显式 `--full`、`--raw`，或按 `item.identity` 和 `afterSeq=item.seq-1 --limit 1 --full` 下钻；
+- 该 CLI 只渲染 AgentRun durable facts，不删除事件、不按正文去重，也不改变 Kafka/SSE 事件链。
+
 retry 必须遵守以下边界：
 
 - task identity 不变，每次执行使用新的 attempt、run、command 和 runner Job identity；