From f88914e82ddb63fe1ebd4e0610fa7892a9f59da9 Mon Sep 17 00:00:00 2001 From: Codex Date: Wed, 1 Jul 2026 08:29:30 +0000 Subject: [PATCH] docs: clarify web-probe smoke closeout rules --- .agents/skills/unidesk-cicd/SKILL.md | 1 + .agents/skills/unidesk-webdev/SKILL.md | 1 + 2 files changed, 2 insertions(+) diff --git a/.agents/skills/unidesk-cicd/SKILL.md b/.agents/skills/unidesk-cicd/SKILL.md index eb7fe3a3..95b204b7 100644 --- a/.agents/skills/unidesk-cicd/SKILL.md +++ b/.agents/skills/unidesk-cicd/SKILL.md @@ -28,6 +28,7 @@ bun scripts/cli.ts agentrun control-plane status - CI/CD 一键交付的端到端 wall-clock 目标是低于 2 分钟；计时从操作者触发受控命令开始，到 runtime ready 且 `/health` 端点验证完成为止。具体 wait/timeout/budget 字段必须从 YAML/source-of-truth 读取并配置到满足该目标。 - CI/CD validation 阶段只能验证部署对象的 `/health` 端点和必要 provenance；禁止在 CI/CD gate 中运行 web-probe、Playwright、远程浏览器截图、用户路径 E2E 或等价重型业务探针。业务/用户入口验证只能作为发布后的独立 post-deploy validation 证据，不得阻塞 CI/CD 一键交付。 - 任一 CI/CD 阶段或总耗时超过 2 分钟时，不要继续死等或把超长等待视为正常；先输出阶段耗时分解，并优先从 env reuse、git mirror、BuildKit/cache、GitOps/Argo watch 和 runtime readiness 探测方向优化后再继续交付。 +- `trigger-current --wait` 超过 2 分钟后，先用受控 `control-plane status --full` / `git-mirror status` 区分构建、GitOps flush、Argo sync 和 runtime readiness；若 PipelineRun 已成功但 `git-mirror pending=true`，按 CLI 提示走受控 `git-mirror flush --confirm --wait`，再 `control-plane refresh/status` 复查收敛。不要为了推进发布改应用源码或绕过 GitOps/Argo。 - 触发或验收 rollout 时必须绑定 lane、source commit、PipelineRun/GitOps revision、runtime ready 和 `/health` 端点验证结果；web-probe/Playwright 结果只能作为单独的 post-deploy 证据。 - Secret 只通过 YAML sourceRef/targetKey 和受控 CLI 下发；输出只披露 presence/fingerprint。 - 长命令用异步 job 或短轮询；不要长时间挂住 trans/ssh。 diff --git a/.agents/skills/unidesk-webdev/SKILL.md b/.agents/skills/unidesk-webdev/SKILL.md index ead5f7ca..d28d252f 100644 --- a/.agents/skills/unidesk-webdev/SKILL.md +++ b/.agents/skills/unidesk-webdev/SKILL.md @@ -31,6 +31,7 @@ description: UniDesk Web 开发与浏览器验证技能。用户处理 UniDesk/H ## web-probe 证据规则 +- 用户要求“web-probe smoke”或“基本 web-probe smoke”时，默认验收对象是 web-probe 基础设施本身：至少覆盖 `web-probe screenshot` 远程截图下载与 SHA 校验、`web-probe script` 的受管登录/报告/artifact 生成、`web-probe observe start/status/collect/stop` 的启动采样和清理闭环。不要用 `opencode-smoke`、Workbench 对话、MDTODO 业务流或其他应用专用探针替代基础 smoke，除非用户或 issue 明确要求验证该业务链路。 - 交互式线上验收优先使用 `web-probe observe start`、`observe command`、`observe collect` 和 `observe analyze`；`web-probe script` 只作为一次性探测逃生口。重复出现的高频动作（折叠侧栏、关闭报告、切换全屏、导出低码率截图、采集布局指标）必须沉淀为 observe command 或 analyzer 能力。 - 截图取证必须优先配合页面的 RESTful 深链：截图命令应直接打开能恢复目标 source/file/task/report/session/run 和聚焦区域的 URL，再等待稳定 DOM 合约后截图。若目标页面缺少必要深链能力，不要先用脆弱点击/滚动流程硬截；应先增强前端深链与刷新恢复能力，再把截图能力接回 web-probe/observe/sentinel 命令。 - Issue closeout 引用 observer id、command id、stateDir/report SHA、screenshot SHA 和关键字段摘要；不要粘贴截图二进制、完整 JSON、Secret、cookie 或无界日志。