fix: tidy opencode smoke post-task guidance

.agents/skills/unidesk-otel/references/full.md

@@ -88,12 +88,12 @@ OTel trace 内常见业务关联属性：
 
 OpenCode 对话长时间显示 `Thinking`、用户发消息后无 assistant 文本、或怀疑 iframe/live state 没吃到事件时，先分别证明 provider、Cloud Web 代理和浏览器事件流三层状态。provider span 可能已经 200，但 UI 仍可能因 `/global/event` 目录、ticket 或 live state 不一致而不收敛。
 
-优先用明确 service 的 TraceQL 查询 provider，避免普通 grep 漏掉新 span 名或属性：
+优先用增强后的 `--grep` 查询 provider/service 线索；当前 grep 会先推断合适的 TraceQL 候选查询，再在扫描到的 trace 内匹配 raw body、span name、route、status message 和 full span attributes：
 
 ```bash
 bun scripts/cli.ts platform-infra observability search \
   --target <node> \
-  --query '{ resource.service.name = "opencode-provider-proxy" }' \
+  --grep opencode-provider-proxy \
   --lookback-minutes 30 \
   --candidate-limit 100 \
   --limit 20
@@ -106,7 +106,18 @@ Cloud Web 侧查 `/global/event` 长连接的 start span；长连接可能在调
 ```bash
 bun scripts/cli.ts platform-infra observability search \
   --target <node> \
-  --query '{ resource.service.name = "hwlab-cloud-web" && span.http.route = "/global/event" }' \
+  --grep opencode.proxy.stream.start \
+  --lookback-minutes 30 \
+  --candidate-limit 300 \
+  --limit 20
+```
+
+属性 drill-down 可直接查 key/value；例如：
+
+```bash
+bun scripts/cli.ts platform-infra observability search \
+  --target <node> \
+  --grep opencode.proxy.sse.directory_rewrite_enabled=true \
   --lookback-minutes 30 \
   --candidate-limit 300 \
   --limit 20
@@ -114,7 +125,7 @@ bun scripts/cli.ts platform-infra observability search \
 
 期望看到 `opencode.proxy.stream.start`，并检查 `opencode.proxy.sse.directory_rewrite_enabled`、`opencode.proxy.sse.directory_rewrite_from`、`opencode.proxy.sse.directory_rewrite_to`、`opencode.proxy.ticket_accepted`、`span.http.route=/global/event` 和 streaming 标记。`from=/workspace`、`to=/` 代表 HWLAB iframe/public route 与 OpenCode server workspace route 已对齐；如果该 rewrite 不存在或 ticket 未接受，provider 正常也不能说明 UI 正常。
 
-关闭 OpenCode UI 卡住类 issue 时，OTel 只能证明链路状态；最终还要用 web-probe DOM/事件证据确认浏览器看到 assistant 文本、没有残留 `Thinking`，并且 EventSource 收到 `message.part.updated`、`step-finish`、`session.idle` 等事件。若 `--grep` 没搜到新属性或 span 名，改用上述 TraceQL query，再只对小范围 trace 使用 `trace --raw` 做 bounded attr drill-down。
+关闭 OpenCode UI 卡住类 issue 时，OTel 只能证明链路状态；最终还要用 `web-probe opencode-smoke` 或等价 DOM/事件证据确认浏览器看到 assistant 文本、没有残留 `Thinking`，并且 EventSource 收到 `message.part.updated`、`step-finish`、`session.idle` 等事件。若 `--grep` 没搜到新属性或 span 名，先阅读输出中的 `grepCoverage`、`grepQueryInference` 和 no-match Next；必要时再改用显式 TraceQL，例如 `{ resource.service.name = "hwlab-cloud-web" && .http.route = "/global/event" }`，并只对小范围 trace 使用 `trace --full|--raw` 做 bounded attr drill-down。
 
 ## Code Agent / AgentRun 排障
 

.agents/skills/unidesk-webdev/references/full.md

@@ -170,7 +170,8 @@ MDTODO 或 Project Management 的 Web 重写/布局 closeout 不能只引用组
 - issue closeout 优先引用 `web-probe script` 输出的顶层 `issueEvidence` 或 `summary.issueEvidence`；只有需要展开调查时才粘贴 `probe.script.result`、`probe.steps` 或完整 `reportPath`，避免 stdout、summary 和 report 多层重复同一证据。
 - stdin heredoc 与 `--script-file` 都按 ES module 加载，脚本必须导出 `export default async ({ page, gotoStable, recordStep, ... }) => { ... }`；不要在模块顶层直接写 `return`。失败为 `Illegal return statement`、`does not provide an export named default` 或 finalUrl 仍是 `about:blank` 且 stepCount=0 时，先按 probe 脚本入口误用处理，不要归因成 Cloud Web 行为失败。
 - 自定义脚本需要主动失败时，优先返回 `{ ok: false, failedCondition: "..." }` 或抛出错误；兼容返回 `{ pass: false }`、`{ success: false }`，且 `{ ok: true, pass: false }` 仍按失败处理。`failedCondition`、`errorMessage`、`message`、`error`、`reason` 或 `summary` 会进入失败摘要；不要只把失败埋在普通业务字段里。
-- OpenCode iframe 或 direct-host smoke 必须等到 OpenCode frame/direct origin 可用后再操作 composer；填入 prompt 后优先点击可见的 `[data-action='prompt-submit']`，不要把 Enter-only 当成稳定提交路径。关闭 OpenCode 对话类 issue 时，`web-probe script` 顶层 `ok` 不能只是“脚本没抛错”；必须断言 DOM body 出现最终 assistant 文本、没有残留 `Thinking`，并记录 EventSource 或等价事件探针看到 `message.part.updated`、`step-finish`、`session.idle`。手工 EventSource 探针可以证明 `/global/event` 消息到达，但不能替代 UI DOM 终态证据。
+- OpenCode iframe 或 direct-host smoke 优先使用 typed `web-probe opencode-smoke --node <node> --lane <lane>`，不要重复手写一次性 Playwright 片段。该命令负责登录 HWLAB public origin、打开 `/opencode`、定位 iframe/direct origin、打开 project/composer、点击可见 `[data-action='prompt-submit']`、采集 EventSource，并断言 DOM assistant 文本与 update/finish/idle 终态。只有 typed 命令覆盖不到的额外 API 或 UI 细节才退回 `web-probe script`。
+- 自定义 OpenCode smoke 必须等到 OpenCode frame/direct origin 可用后再操作 composer；填入 prompt 后优先点击可见的 `[data-action='prompt-submit']`，不要把 Enter-only 当成稳定提交路径。关闭 OpenCode 对话类 issue 时，`web-probe script` 顶层 `ok` 不能只是“脚本没抛错”；必须断言 DOM body 出现最终 assistant 文本、没有残留 `Thinking`，并记录 EventSource 或等价事件探针看到 `message.part.updated`、`step-finish`、`session.idle`。手工 EventSource 探针可以证明 `/global/event` 消息到达，但不能替代 UI DOM 终态证据。
 - web-probe 由 UniDesk CLI 从 YAML 声明的 bootstrap admin sourceRef 读取凭据并建立同源 `hwlab_session`；脚本不得自行读取、打印或复制 Web 登录凭据、cookie、token 或完整 API key。
 - 需要禁用 `EventSource`、mock `Date`/clock、注入 preload hook 或修改浏览器启动前全局对象时，`page.addInitScript()` 必须在目标页面整页加载前注册，并用 `page.goto(new URL(path, origin).toString(), { waitUntil: "domcontentloaded" })` 进入目标 deep link；不要依赖 `gotoStable()` 复用当前 SPA 页面后再期待 init script 生效。若只在已加载页面上 route/block 请求，既有 SSE 或 store 状态可能继续更新，不能作为“无后端刷新依赖”的验收。
 - 脚本构造 URL 时使用 `new URL(path, baseUrl).toString()`；不要拼出 `//v1/...`。