From 540a8edfb6c55d020a57eedc489cfc6d4948e03e Mon Sep 17 00:00:00 2001
From: Codex <codex@local>
Date: Thu, 16 Jul 2026 06:11:05 +0200
Subject: [PATCH] =?UTF-8?q?docs:=20=E5=9B=BA=E5=8C=96=20AgentRun=20?=
 =?UTF-8?q?=E8=A7=82=E5=AF=9F=E9=AA=8C=E6=94=B6=E5=85=A5=E5=8F=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .agents/skills/unidesk-code-queue/SKILL.md | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/.agents/skills/unidesk-code-queue/SKILL.md b/.agents/skills/unidesk-code-queue/SKILL.md
index 584a4a23..c3a23ae6 100644
--- a/.agents/skills/unidesk-code-queue/SKILL.md
+++ b/.agents/skills/unidesk-code-queue/SKILL.md
@@ -32,6 +32,23 @@ bun scripts/cli.ts agentrun create task \
   --prompt-stdin
 ```
 
+HWLAB Agent Observer 全量投影验收使用目标 node/lane HWLAB workspace 内的 typed CLI：
+
+```bash
+export HWLAB_RUNTIME_WEB_URL=<selected-public-origin>
+export HWLAB_RUNTIME_ENDPOINT_LOCKED=1
+bun tools/hwlab-cli/bin/hwlab-cli.ts client agent-observer list --limit 100 --timeout-ms 45000
+```
+
+- `HWLAB_API_KEY` 必须从选中 node/lane 的受控 sourceRef 加载；
+- 成功输出必须同时满足：
+  - `phase=live`；
+  - replay authority 为 `hwlab.event.v1`；
+  - `runCount > 0`；
+  - 验收 Artificer 时至少一个 `sessionId` 使用 `sess_artificer_` 前缀；
+- 该入口会在 retention-to-live handoff 后自动结束；
+- 禁止用无限 SSE 的 `client request GET /v1/agent-observer/events` 代替有界查询。
+
 资源命令的 Target 规则：
 
 - 未传 `--target`、`--node` 或 `--lane` 时，使用 `config/agentrun.yaml#controlPlane.default`；