docs(skill): 固化 AgentRun 事件渐进披露
This commit is contained in:
@@ -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
|
||||
|
||||
@@ -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;
|
||||
|
||||
Reference in New Issue
Block a user