菜单
把需求用例目录路径/目录名（features/【v...】）、MD 用例、PRD、Lanhu、Playwright 脚本或运行失败结果，转为或修复为可真实跑通的 UI 自动化。仅发送一个需求功能目录路径或目录名即可直接触发（目录→自动化；用例产物文件→case-edit）。仅手动操作浏览器、仅写非 UI 用例请转至 case-draft；仅做静态扫描请转至 defect-analyze。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
收到异常堆栈/控制台报错/HTTP 失败、带合并冲突标记的文本，或代码 diff/分支对，做根因分诊、冲突解决或静态缺陷扫描。已登记的 ZenTao bug URL/ID 改用 case-hotfix。
拿到 bug ID、ZenTao bug URL（zenpms.dtstack.cn/zentao/bug-view-NNN.html）、缺陷描述或修复说明，产出聚焦修复路径、可直接执行的单条 hotfix 回归用例（archive.md）。仅发送 bug-view-NNN URL 或 bug ID 即可直接触发，无需附带文字说明。要基于失败证据写通用 bug 报告请转至 defect-analyze；依完整 PRD 产用例请转至 case-draft。
拿到既有用例产物文件(.xmind/.csv/archive.md)路径，编辑、同步、归档、标准化或在 Archive·XMind·CSV 间转换，语义不变是底线。依 PRD/需求源产新用例改用 case-draft；只给需求功能目录路径/目录名改用 playwright-automation。
依 Lanhu/Axure 链接(lanhuapp.com，含 axure/产品设计 URL)、Markdown PRD、设计稿、截图、fixture 或功能描述等需求源，生成、扩写或复核 QA 测试用例，产出 archive.md + cases.xmind。仅发送一条 Lanhu/Axure 链接即可直接触发，无需附带文字说明。仅做 Archive/XMind/CSV 格式转换请转至 case-edit；基于已有用例做自动化请转至 playwright-automation；单条 bug 记录（bug ID / ZenTao bug URL bug-view-NNN）请转至 case-hotfix。
出现数据源/数据库/服务器连通性报错(如 JDBC No route to host、连接超时或被拒)，SSH 登录只读排查并修复，并记录凭据与排查知识。纯前端运行时报错且无需 SSH 登录改用 defect-analyze；只查改业务知识改用 knowledge-curate。
查询、记录或维护项目业务知识、规则、术语、模块事实，或问「XX 是什么」(项目业务概念)，统一记录于 _shared/knowledge/。触发短语如「记一下这个规则」「XX 术语什么意思」「更新模块知识」。只问源码实现细节，或需要编写用例、扫描 diff、做 UI 自动化，请转至对应 case-*/defect-analyze/playwright-automation。
| name | playwright-automation |
| description | 把需求用例目录路径/目录名（features/【v...】）、MD 用例、PRD、Lanhu、Playwright 脚本或运行失败结果，转为或修复为可真实跑通的 UI 自动化。仅发送一个需求功能目录路径或目录名即可直接触发（目录→自动化；用例产物文件→case-edit）。仅手动操作浏览器、仅写非 UI 用例请转至 case-draft；仅做静态扫描请转至 defect-analyze。 |
| argument-hint | <需求目录路径/目录名 | MD 用例 | 脚本 | 失败结果> |
| user-invocable | true |
| model | sonnet |
| effort | high |
| allowed-tools | Bash(kata *) |
将用例目录转为可跑通的 Playwright 脚本，覆盖真实页面探测、生成、运行和修复。
以下场景不属本 skill 范围，请转至对应 skill：
按以下分支处理，确认环境前保持静默：
ltqc-local.yaml 置顶并附理由。请确认执行环境。）。flowchart TD
CN[§1 case-normalize] --> EP[§2 env-preflight]
EP -->|blocked 或缺基线| HO[§11 handoff]
EP --> UP[§3 ui-plan]
UP --> PB[§4 ui-probe]
PB --> RC[§5 plan-reconcile]
RC --> GE[§6 playwright-generate]
GE --> SR[§7 self-run]
SR --> RT[§8 run-triage]
RT -->|通过| QG[§10 quality-gate]
RT -->|失败| RL[§9 repair-loop]
RL -->|重试，每 spec ≤3 次| SR
RL -->|修复耗尽| HO
QG --> HO
HO -.可选.-> CF[§12 case-feedback]
| Phase | 文件 | 简介 |
|---|---|---|
| §1 case-normalize | phases/§1-case-normalize.md | MD/Archive/PRD/Lanhu/脚本/失败结果 → UiAutomationIntent |
| §2 env-preflight | phases/§2-env-preflight.md | base URL、登录态、项目、数据源、权限、浏览器依赖校验 |
| §3 ui-plan | phases/§3-ui-plan.md | 覆盖范围、可见断言、fixture、选择器策略与风险 |
| §4 ui-probe | phases/§4-ui-probe.md | 真实浏览器收集页面/可访问性/截图/网络/locator 证据 |
| §5 plan-reconcile | phases/§5-plan-reconcile.md | 书面用例核对真实 UI：继续/调整/提问/阻塞 |
| §6 playwright-generate | phases/§6-playwright-generate.md | 据核对后的计划与 UI 证据生成或修复脚本 |
| §7 self-run | phases/§7-self-run.md | 跑目标 spec，记录命令/退出码/输出/报告路径 |
| §8 run-triage | phases/§8-run-triage.md | 失败归类：产品/脚本/数据/权限/环境/未知/需决策 |
| §9 repair-loop | phases/§9-repair-loop.md | 有限修复循环，保留每次修复证据 |
| §10 quality-gate | phases/§10-quality-gate.md | 脚本结构、断言、session、handoff 等检查项，跑 kata cases lint 闸门 |
| §11 handoff | phases/§11-handoff.md | 通过/阻塞/部分/修复耗尽的最终交付报告 |
| §12 case-feedback | phases/§12-case-feedback.md | 生成 case-corrections（8 类/3 级/跨轮去重）；高置信已核实项经 case-edit 回写源用例 |
| 文件 | 何时读 | 作用 |
|---|---|---|
| references/cli-essentials.md | ui-probe/generate/repair 阶段需要 API 速查时 | 原生 Playwright API：探测/属性/断言/mock/trace/下载；含 @playwright/cli 可选探索边界 |
| references/db-runtime-sql.md | 用例需运行时建表/删表/改数据或核对期望度量时 | lib/db 多数据源(starrocks/doris/hive/sparkthrift)运行时 SQL 工具的使用时机与方式 |
| references/execution-protocol.md | env 确认且无 blocker 后的重阶段 | per-case 任务编排与公开进度、子代理派发、汇总集中评审 |
| prompts/agent-precondition.md | 前置条件处理阶段（env-preflight 通过后） | 前置 opus 子代理模板：ui-probe 探测 + 共享层 + 用例清单校正 |
| prompts/agent-worker.md | 用例 generate/self-run/repair 派子代理时 | 执行子代理模板与 Status/BlockedEnvelope |
| prompts/agent-spec-reviewer.md | 汇总 & 质量闸门阶段 | spec 合规机械检查 |
| prompts/agent-quality-reviewer.md | 汇总 & 质量闸门阶段（spec 通过后） | 脚本质量（选择器、断言、复用度） |
workspace/<project>/_shared/knowledge/_index.md → modules/<module>.md + sites/<host>/dom-*.md | ui-probe / generate / 用例清单校正前（必读） | 真实菜单·字段·统计函数文案 + 规则语义事实，校正用例与脚本；存疑查 source-repo-map.md 指向的 .kata/repos 源码枚举 |
metadata.yaml / cases/archive.md / prd.md 中精确定位唯一目标目录，再读取其状态文件；禁止枚举 features/ 下的候选目录。blocked_by_case_draft_required 只在一种情况下触发：目标目录既缺少 case-draft 的自动化基线（ready 状态的 AutomationIntent、cases/archive.md、cases/test-point-checklist.md），又缺少 prd.md 或 inputs/lanhu-snapshots/。触发后直接进入 handoff，不再读取需求源。references/execution-protocol.md 编排任务列表：
前置条件处理 分配 opus 子代理；plan-reconcile / generate / self-run / repair 按用例分配 sonnet 子代理（任务标题 = 用例标题）。no_permission / tool_permission_denied 模板，严格遵循 phases/§2-env-preflight.md。workspace/{project}/.kata/repos/**。full.spec.ts 通过、run 目录产出 Allure 结果、平台产生该用例核心业务流程的记录数据。只读合同脚本只有在用户明确要求只读覆盖时才可作为完成范围；否则必须阻塞或排除，不得声称自动化完成。expected_visible_result 须断言为真实的业务结果；禁止用「导航 + 可见性断言」代替业务动作。handoff.excluded_cases（含 reason_category）。try-catch、test.skip 或宽泛条件来掩盖。workspace/<project>/_shared/env/*.yaml profile；新建前先检查是否已有匹配的 base_url + tenant，不得为交付新建 .env.local。smoke.spec.ts + full.spec.ts 存放于 automation/tests/runners/，case 存放于 automation/tests/cases/，共享页面对象/helper 存放于 _shared/。full.spec.ts 全量通过为准，仅 smoke 通过不算完成。