diff --git a/.agents/skills/unidesk-agentrun/SKILL.md b/.agents/skills/unidesk-agentrun/SKILL.md index 82755cec..9e5ee98e 100644 --- a/.agents/skills/unidesk-agentrun/SKILL.md +++ b/.agents/skills/unidesk-agentrun/SKILL.md @@ -32,22 +32,25 @@ bun scripts/cli.ts agentrun create task \ --prompt-stdin ``` -HWLAB Agent Observer 全量投影验收使用目标 node/lane HWLAB workspace 内的 typed CLI: +HWLAB Agent Observer 分页快照验收使用目标 node/lane HWLAB workspace 内的 typed CLI: ```bash export HWLAB_RUNTIME_WEB_URL= export HWLAB_RUNTIME_ENDPOINT_LOCKED=1 -bun tools/hwlab-cli/bin/hwlab-cli.ts client agent-observer list --limit 100 --timeout-ms 45000 +bun tools/hwlab-cli/bin/hwlab-cli.ts client agent-observer list --page 1 --page-size 25 --timeout-ms 30000 +bun tools/hwlab-cli/bin/hwlab-cli.ts client agent-observer list --page 2 --page-size 25 --search <中文任务标题> ``` - `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` 代替有界查询。 +- 列表 authority 固定为 `agentrun-manager-durable-store`: + - `page`、`pageSize`、`total`、`totalPages` 和 `hasNextPage` 必须可见; + - `items` 直接来自 AgentRun durable run、最新 command 和最新 runner job; + - `taskId`、中文标题、workspace、lane、Agent/Profile、attempt、runner 和错误字段不得依赖 Kafka 历史 envelope 猜测; +- Web 首屏先读取同一分页快照,再连接 `hwlab.event.v1` live 流; +- Kafka retention replay 只用于显式事件历史下钻,不得阻塞列表首屏; +- 验收 Artificer 时使用中文标题搜索,并确认对应 `sessionId` 使用 `sess_artificer_` 前缀; +- `--limit` 只保留为旧 `--page-size` 别名,不再表示 Kafka replay 扫描上限; +- 禁止用无限 SSE 的 `client request GET /v1/agent-observer/events` 代替有界分页查询。 资源命令的 Target 规则: