docs: Queue 输入优先使用 stdin heredoc

docs/reference/spec-v01-queue.md

@@ -77,14 +77,14 @@ Queue task 详情必须返回 session 引用，而不是代理输出或 trace：
 AgentRun CLI 必须提供 Queue 和 Session 两组命令。Queue 命令只操作队列资源：
 
 ```bash
-./scripts/agentrun queue submit --json-file <task.json> [--dry-run]
+./scripts/agentrun queue submit --json-stdin|--json-file <task.json> [--dry-run]
 ./scripts/agentrun queue list [--queue <queue>] [--state <state>] [--cursor <cursor>] [--limit <limit>] [--full|--raw]
 ./scripts/agentrun queue show <taskId> [--full|--raw]
 ./scripts/agentrun queue stats [--queue <queue>]
 ./scripts/agentrun queue commander [--queue <queue>] [--reader-id <reader>] [--limit <display-limit>] [--full|--raw]
 ./scripts/agentrun queue read <taskId> [--reader-id <reader>] [--dry-run] [--full|--raw]
 ./scripts/agentrun queue cancel <taskId> [--reason <text>] [--dry-run] [--full|--raw]
-./scripts/agentrun queue dispatch <taskId> [--json-file <dispatch.json>] [--dry-run] [--full|--raw]
+./scripts/agentrun queue dispatch <taskId> [--json-stdin|--json-file <dispatch.json>] [--dry-run] [--full|--raw]
 ./scripts/agentrun queue refresh <taskId> [--dry-run] [--full|--raw]
 ```
 
@@ -93,15 +93,37 @@ Session 命令负责输出、trace 和会话控制：
 ```bash
 ./scripts/agentrun sessions ps [--state default|running|unread|terminal|idle|all] [--profile codex|deepseek|minimax-m3|M3] [--reader-id <reader>]
 ./scripts/agentrun sessions show <sessionId> [--reader-id <reader>]
-./scripts/agentrun sessions turn [sessionId] --json-file <run-base.json> --prompt-file <file> [--profile codex|deepseek|minimax-m3|M3]
-./scripts/agentrun sessions steer <sessionId> --prompt-file <file>
+./scripts/agentrun sessions turn [sessionId] [--json-stdin|--json-file <run-base.json>] [--prompt-stdin|--prompt-file <file>|--prompt <text>] [--profile codex|deepseek|minimax-m3|M3]
+./scripts/agentrun sessions steer <sessionId> [--prompt-stdin|--prompt-file <file>|--prompt <text>]
 ./scripts/agentrun sessions cancel <sessionId> [--reason <text>]
 ./scripts/agentrun sessions output <sessionId> [--after-seq <seq>] [--limit <limit>]
 ./scripts/agentrun sessions trace <sessionId> [--after-seq <seq>] [--limit <limit>]
 ./scripts/agentrun sessions read <sessionId> [--reader-id <reader>]
 ```
 
-不得新增 `queue output`、`queue trace` 或 `queue session/*` 这类子路径代理。`queue list/show/commander` 默认输出低噪声 summary，最多打印 task/attempt/session ids、状态、统计、`sessionPath`、compact supervisor 和下一步 `sessions ...` 命令；supervisor 只允许披露 phase、last activity source seq/id、timeout budget 和恢复动作摘要，不得展开完整 payload、trace、tool command、stdout/stderr 或 runnerTrace。完整 payload/resource bundle/metadata 只能通过显式 `--full|--raw` 展开；trace/output 细节继续按 `sessionId` + `sourceSeq/eventId/itemId` 走 Session CLI 渐进披露。Queue mutation 命令带 `--dry-run` 时必须只返回 `mutation=false` 的计划，不得写 Queue、Core run/command 或 runner job。
+不得新增 `queue output`、`queue trace` 或 `queue session/*` 这类子路径代理。`queue list/show/commander` 默认输出低噪声 summary，最多打印 task/attempt/session ids、状态、统计、`sessionPath`、compact supervisor 和下一步 `sessions ...` 命令；supervisor 只允许披露 phase、last activity source seq/id、timeout budget 和恢复动作摘要，不得展开完整 payload、trace、tool command、stdout/stderr 或 runnerTrace。完整 payload/resource bundle/metadata 只能通过显式 `--full|--raw` 展开；trace/output 细节继续按 `sessionId` + `sourceSeq/eventId/itemId` 走 Session CLI 渐进披露。Queue mutation 命令带 `--dry-run` 时必须只返回 `mutation=false` 的计划，不得写 Queue、Core run/command 或 runner job。一次性 Queue task、dispatch body、run base 或 command payload 必须优先用 `--json-stdin` 接 quoted heredoc；禁止为了把 heredoc/stdin 内容交给 CLI 而先写临时 JSON dump 文件再传 `--json-file`。`--json-file` 只用于可复用、已受控的输入文件。
+
+推荐 Queue task 提交形态：
+
+```bash
+./scripts/agentrun queue submit --json-stdin <<'JSON'
+{
+  "tenantId": "unidesk",
+  "projectId": "pikasTech/agentrun",
+  "queue": "dev",
+  "title": "短标题",
+  "payload": { "prompt": "任务正文" }
+}
+JSON
+```
+
+推荐 dispatch dry-run/确认形态：
+
+```bash
+./scripts/agentrun queue dispatch <taskId> --json-stdin --dry-run <<'JSON'
+{ "attemptId": "attempt_manual" }
+JSON
+```
 
 Queue task 的 `resourceBundleRef` 在 dispatch 时原样进入 Core run。若其中声明 `requiredSkills`，Queue 只展示声明和终态摘要，不能自行判定可用；runner 必须在 gitbundle materialization 后、backend 启动前校验 `.agents/skills/<name>/SKILL.md`，缺失时以 `required-skill-unavailable` 写入 command/run result 和 events。