@tea-agent/loop-agent 0.39.0-next.30 → 0.39.0-next.32

package/skills/fe-test-ui-scout/SKILL.md

@@ -0,0 +1,65 @@
+---
+name: fe-test-ui-scout
+description: 在写 frontend-test Wave PRD/回归目录之前，对真实运行的被测页面做只读锚点侦察，产出并维护 {testRoot}/rag/ui-anchors.md 锚点台账（默认 testcase/frontend/rag/ui-anchors.md）。用 playwright-cli snapshot/find 逐字面验证命中数与唯一性，防止 PRD 验收标准引用不存在或不唯一的文案。触发词：frontend-test、锚点、台账、ui-anchors、侦察、写 PRD 前、snapshot/find 校准、Wave PRD。
+references:
+  - path: references/ledger-schema.md
+    required: true
+  - path: references/recon-protocol.md
+    required: true
+---
+
+# FE-Test UI Scout（锚点侦察）
+
+## 定位
+
+写 Wave PRD / 校准回归目录 AC **之前**的前置侦察。产出锚点台账
+`{testRoot}/rag/ui-anchors.md`（默认 `testcase/frontend/rag/ui-anchors.md`）：每个「页面 × 状态」下真实可见、
+`find` 可命中的字面清单。PRD 的每条 `find "..."` 断言必须能在台账找到对应行；
+台账没有的字面禁止写进验收标准。
+
+本 skill **不生成用例、不执行用例、不点任何写控件**。生成由
+`playwright-cli-case-generator`（DAG generate 节点）负责，执行由
+`playwright-cli`（DAG execute 节点）负责；本 skill 只在 DAG 之外的主会话使用。
+
+## 输入
+
+- 被测 baseUrl（来自 `{testRoot}/rag/context.md` 的 `environmentProbe=reachable` URL；默认 `testcase/frontend/rag/context.md`）
+- 目标 Wave 的 AC 清单（回归目录中本 Wave 范围的行）
+- 既有台账（增量更新，不整表重写）
+
+## 流程
+
+1. **读取范围**：从回归目录取本 Wave AC 的「页面 + 测试点 + 验收标准」，
+   提取所有候选字面（引号内文案、aria-label、控件名）。
+2. **逐状态侦察**：对每个涉及页面/状态组合：
+   `playwright-cli open --browser=chrome <baseUrl>/#/<route>` → `snapshot` →
+   逐候选 `find "<字面>"`，记录命中数与命中位置。
+3. **记录陷阱**：拆节点（`<kbd>`+`<span>`、文本+`<code>`）、同名多控件、
+   aria-label 与可见文本不一致、状态前置（no-session / has-session / empty、
+   setup-required）都要写进备注列。
+4. **增量写台账**：按 [references/ledger-schema.md](references/ledger-schema.md)
+   的表结构与分节规则追加/修订行，保留既有行历史（用备注标注失效原因，
+   不删行）。
+5. **报告**：侦察完成后输出小结（新增/修订/失效行数、命中率、给 PRD 的
+   可用锚点清单与禁用清单）。
+
+## 硬规则
+
+- 只读：不点提交/保存/发送类控件、不创建会话以外的任何状态（「新建空白
+  对话」CTA 允许点击一次以进入 has-session 状态，属于台账明确的状态夹具）。
+- 命中 0 或命中数 >1 且无法用状态/作用域区分的字面，标记 `不可断言`，
+  禁止进入 PRD `find` 断言。
+- 台账每行必须带验证时间与当时 baseUrl；页面改版后旧行标 `失效` 而非删除。
+- 不猜测：没跑过 `find` 的字面不进台账。
+- PRD 正文（含背景/夹具段）不得出现会被需求 id 扫描捕获的形态：大写或小写的 REQ/BR/AC 前缀 + 连字符 + hash/序号（如夹具任务 id 里的 req 段、或自示范用的「req 加连字符 hash」字面）。夹具引用只写日期 + 短 hash（如 f03535aa），规则说明文字用中文描述或代码块包裹仍可能被扫——一律避免连写。
+- PRD 验收标准只用**目录 AC id**（如 AC-FE-INS-005）作条目 id；不要写本地序号前缀（如 AC-003 加粗目录 id 的双 id 形态）——双 id 会被同时提取，生成器只引用其一，另一个落入 acceptanceCoverage.missing。
+
+## 输出
+
+- `{testRoot}/rag/ui-anchors.md`（增量更新；默认 `testcase/frontend/rag/ui-anchors.md`）
+- 侦察小结（对话内输出，不落盘；结论回写 PRD 草稿的锚点引用）
+
+## References
+
+- [references/ledger-schema.md](references/ledger-schema.md) — 台账表结构与分节规则
+- [references/recon-protocol.md](references/recon-protocol.md) — 逐状态侦察操作协议与陷阱清单

package/skills/fe-test-ui-scout/references/ledger-schema.md

@@ -0,0 +1,62 @@
+# 台账（ui-anchors.md）表结构与分节规则
+
+## 文件位置与命名
+
+- 路径：`{testRoot}/rag/ui-anchors.md`（默认 `testcase/frontend/rag/ui-anchors.md`）
+- 编码：UTF-8，LF；表格用 GitHub Flavored Markdown。
+- 台账是**增量账本**：修订不删除历史行；失效行改状态列并注明原因。
+
+## 顶层结构
+
+```markdown
+# UI 锚点台账（frontend-test）
+
+- baseUrl：<验证时的绝对 URL>
+- 更新时间：<YYYY-MM-DD HH:mm（本地时区）>
+- 维护：fe-test-ui-scout skill
+
+## <页面路由> · <状态>
+
+| 字面（find 原文） | 命中 | 唯一 | 控件/位置 | 状态 | 备注 | 验证时间 |
+| --- | --- | --- | --- | --- | --- | --- |
+| 后端研发（默认 DAG） | 1 | 是 | workflow-kind-select option | 有效 | 括号必须带全 | 2026-08-22 15:00 |
+```
+
+## 分节规则
+
+- 一节 = 一个「页面路由 × 状态」组合。路由用 hash 形式（`#/tasks`、
+  `#/chat`、`/inspect/#/dags`）；状态至少区分：
+  - `no-session`（无会话 landing）
+  - `has-session`（已存在会话，composer 可见）
+  - `empty-session`（新建空会话，无消息）
+  - 页面特有态（如 `#/night · 无计划`、`#/recovery · 无候选`、
+    setup-required）随需追加，节名写清楚。
+- 同一页面多个状态各自成节；不要把跨状态结果合并进一行。
+
+## 列语义
+
+| 列 | 说明 |
+| --- | --- |
+| 字面（find 原文） | `playwright-cli find "<字面>"` 的唯一入参原文，逐字节照抄（含括号、空格、中点） |
+| 命中 | 侦察时 `find` 实际返回的匹配数（0/1/N） |
+| 唯一 | 是/否/不适用；命中=1 且作用于目标控件才算「是」 |
+| 控件/位置 | 命中元素的角色与位置（如 `h2`、`oc-suggestion strong`、`aria-label`） |
+| 状态 | `有效` / `失效` / `待复核`；失效须在备注注明原因与替代字面 |
+| 备注 | 陷阱与前置：拆节点（kbd+span、text+code）、同名多控件、aria-label≠可见文本、状态前置、setup 门 |
+| 验证时间 | YYYY-MM-DD HH:mm |
+
+## 有效 / 失效判定
+
+- **有效**：命中=1、目标控件、字面在当前 build 下可复现。
+- **不可断言**：命中 0（字面不存在或被拆节点）、命中 >1 且状态/作用域
+  无法区分（如「发送」同时命中 tips 与按钮）。这类行保留在台账里，
+  状态列写 `不可断言`，备注写原因——它们正是 PRD 的「禁用清单」。
+- **失效**：页面改版后不再命中。不删行，改状态 + 备注（替代字面是什么）。
+
+## 与 PRD / 目录的关系
+
+- PRD 每条 `find "..."` 断言的字面必须出自台账某行且该行状态为
+  `有效`（或备注给出拆节点断言替代方案，如 `find "taskKind="` 与
+  `find "frontend-test"` 二选一）。
+- 目录 AC 的 live 校准注记引用台账行（日期 + 路由+状态），保持
+  「AC ↔ 台账」双向可追溯。

package/skills/fe-test-ui-scout/references/recon-protocol.md

@@ -0,0 +1,54 @@
+# 逐状态侦察操作协议与陷阱清单
+
+## 前置检查
+
+1. 确认 SUT 健康：`curl -s -o /dev/null -w '%{http_code}' <baseUrl>/api/health`
+   返回 200；非 200 先解决环境，不侦察。
+2. 确认 SUT 跑的是当前 build（改过 `src/**` 后必须 `npm run build` 并重启
+   SUT，否则台账记录的是旧页面）。
+3. 准备隔离 app-data（SUT 启动参数已带 `/tmp` 隔离目录时无需额外动作）；
+   侦察结束把 no-session 状态还原（关闭页面即可；若点了「新建空白对话」
+   产生空会话，记录在案即可，不必清理 app-data）。
+
+## 每个页面 × 状态的标准动作序列
+
+```text
+playwright-cli open --browser=chrome <baseUrl>/#/<route>
+playwright-cli snapshot
+playwright-cli find "<候选字面 1>"
+playwright-cli find "<候选字面 2>"
+...
+playwright-cli close
+```
+
+- `snapshot` 先行：从 snapshot 里核对候选字面的真实渲染形态（是否拆节点、
+  是否 aria-label、是否在折叠组内需先展开）。
+- 每个候选字面必须真实 `find` 一次；snapshot 里「看起来有」不算数。
+- 折叠组（如「工程边界（可选，人类确认）」）：先记录折叠态的组标题字面，
+  再展开后侦察组内字段；两种形态分两行记。
+- 需要状态夹具的节（has-session）：点一次「新建空白对话」CTA 进入；
+  这是协议允许的唯一写动作。
+
+## 陷阱清单（出现即写进备注列）
+
+| 陷阱 | 症状 | 台账记法 |
+| --- | --- | --- |
+| 拆节点 | `find "Enter 发送"` 0 命中；DOM 是 `<kbd>Enter</kbd><span>发送</span>` | 字面行记完整原文 + 命中 0 + 状态 `不可断言`；备注给出替代（`find "发送"` 或 `find "Enter"`）并说明拆法 |
+| text+code 拆分 | `taskKind=frontend-test` 渲染为 `taskKind=` + `<code>frontend-test</code>` | 同上 |
+| 同名多控件 | 「发送」同时命中 tips span 与发送按钮 aria-label | 命中 N>1，唯一=否；备注指明各自位置，PRD 需换更独特字面或限定状态 |
+| 同名多行按钮（列表态） | 「重命名会话」在 3 行会话各自命中 1，全局命中 3；单会话态侦察时命中 1 | 备注标「会话数依赖」；断言法降级为 hover 目标行 → snapshot 解析该行真实 ref（存在即通过），禁止声明 find 命中数=1；或确保夹具为单行态（清 app-data） |
+| aria-label ≠ 可见文本 | 控件可访问名是 aria-label，渲染文本不同 | 字面列记 aria-label 值，备注「aria-label；可见文本为 X」 |
+| 无名 flex 子项 | flex 匿名文本无 name-from-content，find 不到 | 记录控件缺 aria-label → 这是**产品可修问题**，报告给修复决策树（页面象限），台账暂记 `不可断言` |
+| 括号/全半角 | 「后端研发（默认 DAG）」少括号 0 命中 | 字面逐字节照抄；备注提醒 |
+| 状态前置 | 控件只在 has-session / setup-required 等状态下存在 | 分节记录；PRD 引用时必须声明状态夹具 |
+| 折叠组 | 字面在 `<details>` 内，未展开时 find 0 | 两种形态分行记录（折叠标题/展开后字段） |
+| 瞬态文案 | 「正在加载…」类短暂存在 | 备注标「瞬态」，PRD 不引用 |
+
+## 输出纪律
+
+- find 命中数以工具返回为准，不目测。
+- 每节侦察完立即写台账（不攒到最后凭记忆写）。
+- 侦察小结按 SKILL.md 第 5 步输出：新增/修订/失效行数、命中率、
+  PRD 可用锚点清单与禁用清单。
+- 发现疑似产品缺陷（白屏、文案缺失、aria 错误）：记入小结的「移交修复」
+  段，不在台账内修，不因缺陷跳过其余候选字面的侦察。

package/skills/playwright-cli/SKILL.md

@@ -25,6 +25,7 @@ close
 goto
 snapshot
 find
+find-unique
 click
 dblclick
 fill
@@ -54,7 +55,7 @@ request
 
 ## 推荐执行流程
 
-使用 `testcase/frontend/rag/context.md` 中已由 environment shell 标记为 `reachable` 的非生产 `baseUrl` 和默认浏览器 session；不得创建 named session。交互前先获取 snapshot，并只使用 snapshot 中可见的 ref 或已知安全 locator。
+使用 `{testRoot}/rag/context.md`（默认 `testcase/frontend/rag/context.md`）中已由 environment shell 标记为 `reachable` 的非生产 `baseUrl` 和默认浏览器 session；不得创建 named session。交互前先获取 snapshot，并只使用 snapshot 中可见的 ref 或已知安全 locator。截图写入当前 case 的 `{evidenceDir}/<caseId>/`，canonical 文件名仍是 `final.png`。
 
 ```text
 playwright-cli open --browser=chrome http://localhost:5173
@@ -71,6 +72,16 @@ playwright-cli close
 普通交互和控制台输出均不能单独取得 passed authority。通过的 case 还需要同一 child 的有序
 controller receipts：successful `open` → successful `find` → successful post-execution cleanup。
 
+### 唯一性断言优先用 find-unique
+
+当语义要求「全页恰好一个」时，用 `playwright-cli find-unique "字面"` 代替人工数命中数：它内部
+执行 find 并在解析命中数 ≠ 1 时以非零退出码失败（零命中/多命中/输出不可解析均 fail），错误
+信息直接给出 `expected exactly 1 match, got N`。它只接受一个文本字面量、不接受 `--regex` 等
+flag。台账中标注 `==1` 的锚点、以及「唯一命中」类 AC 应优先用它；`>=N` 存在性断言仍用
+`find`（find-unique 会拒绝多命中）。controller 会解析两类命令的命中数写入 receipt，finalize
+时用 case 文档声明的 `find "字面" >=N / ==N` 对照 receipt 复核，缺失或不满足会把 passed
+降级为 blocked（assertion-not-receipt-backed），因此声明的断言必须真的执行。
+
 ## 受限证据采集
 
 - UI 状态：先 `snapshot`，完成交互后以成功 `find` 证明用户可见结果。
@@ -91,3 +102,14 @@ controller receipts：successful `open` → successful `find` → successful pos
 当环境、数据、权限、时序、异常路径或响应内容无法用 RAG、已验证 context URL 和 runtime allowlist 证明时，
 写入 `blocked` evidence，并提供具体 `blockedReason`。不要引入替代执行路径，也不要把隐藏状态或
 未观察到的网络结果当作通过证据。
+
+### 唯一控件早停（unique-control-unavailable）
+
+- 适用：AC 点名的具体控件在到达目标状态后的**首个 post-navigation snapshot** 中缺失，且页面没有
+  setup-required 门（如「需先完成 Pi setup」）。
+- 判定：用 case 给出的字面做**单次** `find`；返回 0 命中即为充分证据，直接写
+  `status=blocked`、`blockedReason=unique-control-unavailable`，在 execution.md 中引用该次 find 结果。
+- 禁止：换字面重试、反复 snapshot、绕路导航、多轮探索或请求 rerun。这些都产生无放大的 token
+  成本且不改变结论（Wave 3 教训：反复探测不存在控件耗掉约 717k input tokens）。
+- 若 snapshot 显示存在 setup-required 门或状态前置未满足，按其对应 blockedReason 记录
+  （环境/状态类），不属于本早停。

package/skills/playwright-cli-case-generator/SKILL.md

@@ -13,12 +13,24 @@ description: 根据 FE-test RAG 知识包生成可由受限 playwright_cli runti
 
 ## 输入与边界
 
-- 只读取 `testcase/frontend/rag/context.md`、`coverage-map.md` 与已有 `testcase/frontend/cases/`。
-- 只写 `testcase/frontend/cases/**`；不得回读 PRD、读取 `.harness/`，或写
-  `testcase/frontend/evidence/**`。
+默认产物根是 `testcase/frontend/`。若任务配置了 `frontendTest.testRoot`，把下列路径中的 `testcase/frontend/` 整段替换为该根（不要只替换 `testcase/`）。
+
+- 只读取 `{testRoot}/rag/context.md`、`coverage-map.md` 与已有 `{testRoot}/cases/`。
+- 若存在 `{testRoot}/rag/ui-anchors.md` 锚点台账，必须一并读取并作为 UI 断言的唯一事实源；台账缺失时按 RAG 知识包生成，但不得引用台账外的具体控件字面（缺失信息标 `blocked`）。
+- 只写 `{testRoot}/cases/**`；不得回读 PRD、读取 `.harness/`，或写
+  `{testRoot}/evidence/**`。
 - 所有 API、字段限制、状态流转、数据来源、SLA、URL 与账号要求必须能在 RAG 知识包中追溯。
   缺失信息标记 `blocked` 或“需人工确认”，不得猜测。
 
+### 锚点台账规则（存在 ui-anchors.md 时）
+
+- case 中每条拟通过的 `find "<字面>"` 断言必须能在台账对应「页面 × 状态」节找到
+  状态为 `有效` 的行；台账 `不可断言` / `失效` 行的字面**禁止**作为通过断言。
+- AC 点名的控件在台账对应状态节缺失（0 命中或无行）时，该 AC 的 case 生成
+  `blocked` 语义说明（或从本批剔除该 AC），`blockedReason` 用
+  `unique-control-unavailable`，不得生成探测性步骤反复 find。
+- 台账行备注中的替代断言方案（如拆节点后的短字面二选一）按备注执行。
+
 ## 输出
 
 - 写 `index.md`、`manifest.draft.json`（生成阶段；materialize 会写成 `manifest.json`）与独立 case 文件
@@ -28,10 +40,10 @@ description: 根据 FE-test RAG 知识包生成可由受限 playwright_cli runti
     （例：`FE-LOGIN-001-core`）。禁止把验收标准写成 caseId。
   - `acIds` = **验收标准 ID 列表**，形态 `AC-FE-*` / `AC-*`
     （例：`["AC-FE-001"]`）。禁止把用例 ID 放进 acIds。
-  - `casePath` 必须等于 `testcase/frontend/cases/<caseId>.md`；
-    `evidenceDir` 必须等于 `testcase/frontend/evidence/<caseId>/`。
+  - `casePath` 必须等于 `{casesDir}/<caseId>.md`（默认 `testcase/frontend/cases/<caseId>.md`）；
+    `evidenceDir` 必须等于 `{evidenceDir}/<caseId>/`（默认 `testcase/frontend/evidence/<caseId>/`）。
 - `manifest` 使用 `schemaVersion: 1`，每项只含 `caseId`、`casePath`、`dimension`、`acIds`、
-  `evidenceDir`。所有 ID、路径和 evidenceDir 必须唯一，并位于 `testcase/frontend/` 内。
+  `evidenceDir`。所有 ID、路径和 evidenceDir 必须唯一，并位于 `{testRoot}/` 内。
 - `index.md` 按功能点列出 case、维度、AC、数据依赖、API 映射和预期执行状态。
 
 每个 case 必须包含：
@@ -51,10 +63,19 @@ description: 根据 FE-test RAG 知识包生成可由受限 playwright_cli runti
    占位符仅表示从紧邻其前、最新一次 `snapshot` 输出解析出的真实 `eNN` ref。生成的 case 必须在每次
    引用元素前写明 fresh snapshot；`eX`/`eY` 不是可传给 structured tool 的 literal ref，新的 snapshot
    会使旧 ref 失效，不得复用 stale ref。
-5. 明确的 UI/API 预期与数据清理结果；无法满足的环境或数据依赖必须写为 `blocked`。
+5. **期望命中数不得内联进命令行（硬约束）**：如需声明 find 期望命中数，写在「预期结果」区或
+   列表项的说明文字中（如 “预期唯一命中”）；命令行只写纯命令 `playwright-cli find "<字面>"`。
+   禁止 `find "<字面>">=N`、`≥N`、`（≥N）` 等计数后缀内联进命令 token。
+6. **唯一性断言优先 find-unique**：台账或 AC 标注 `==1`/「唯一命中」的锚点，生成
+   `playwright-cli find-unique "<字面>"`（仅一个文本字面量，无 flag；多命中/零命中即命令失败）；
+   `>=N` 存在性断言仍用 `find`。finalize 会用 case 文档中 `find "字面" >=N / ==N` 声明对照
+   controller receipt 的解析命中数复核，声明的断言未真正执行或命中数不满足会把 passed 降级为
+   blocked（assertion-not-receipt-backed）——因此「测试点」里声明的每个 find 断言都必须在步骤中
+   真实执行且字面完全一致。
+7. 明确的 UI/API 预期与数据清理结果；无法满足的环境或数据依赖必须写为 `blocked`。
 
 所有文件型输出均由 controller 绑定到执行节点提供的
-`testcase/frontend/evidence/<case-id>/` 工作目录。截图一律使用 canonical 语法
+`{evidenceDir}/<case-id>/` 工作目录（默认 `testcase/frontend/evidence/<case-id>/`）。截图一律使用 canonical 语法
 `playwright-cli screenshot --filename final.png`；如确有从最新 snapshot 解析出的真实元素 ref，写为
 `playwright-cli screenshot e5 --filename final.png`。`pdf` 必须写为
 `playwright-cli pdf --filename final.pdf`。`snapshot` 无 filename 时仅返回响应；需要文件时使用

package/dist/worker/console/static/assets/channel-DMvu1nmi.js

@@ -1 +0,0 @@
-import{ag as o,ah as n}from"./mermaid.core-C1cSavOy.js";const t=(a,r)=>o.lang.round(n.parse(a)[r]);export{t as c};

package/dist/worker/console/static/assets/classDiagram-JCYQIIEL-DVzM-02m.js

@@ -1 +0,0 @@
-import{s as a,c as s,a as e,C as t}from"./chunk-GF5L2VYU-DklNc7dm.js";import{_ as i}from"./mermaid.core-C1cSavOy.js";import"./chunk-5VM5RSS4-BF57lhXj.js";import"./chunk-XXDRQBXY-B0JK51NT.js";import"./chunk-KBJHAD2P-BBgLqV4h.js";import"./chunk-2GRJ4B5K-DbYr-Cxy.js";import"./index-C2jmYBfu.js";var n={parser:e,get db(){return new t},renderer:s,styles:a,init:i(r=>{r.class||(r.class={}),r.class.arrowMarkerAbsolute=r.arrowMarkerAbsolute},"init")};export{n as diagram};

package/dist/worker/console/static/assets/classDiagram-v2-OCEON4UE-DVzM-02m.js

@@ -1 +0,0 @@
-import{s as a,c as s,a as e,C as t}from"./chunk-GF5L2VYU-DklNc7dm.js";import{_ as i}from"./mermaid.core-C1cSavOy.js";import"./chunk-5VM5RSS4-BF57lhXj.js";import"./chunk-XXDRQBXY-B0JK51NT.js";import"./chunk-KBJHAD2P-BBgLqV4h.js";import"./chunk-2GRJ4B5K-DbYr-Cxy.js";import"./index-C2jmYBfu.js";var n={parser:e,get db(){return new t},renderer:s,styles:a,init:i(r=>{r.class||(r.class={}),r.class.arrowMarkerAbsolute=r.arrowMarkerAbsolute},"init")};export{n as diagram};