ui-automationlisted
Install: claude install-skill koco-co/kata
# Outcome
将 YAML 用例实现为目标 Web 环境中真实执行的 Playwright 脚本,并用运行结果、Allure 和平台业务记录证明完成状态。
## Routing
- Web 已落地:依次执行 prepare、implement、deliver。
- Electron 未落地:先说明没有已验证交付链,取得用户是否探索的决定;未经决定不套用 Web 完成声明。
- 原生 App、小程序和非 Playwright 平台:超出当前能力,说明边界。
- 只写非 UI ��例:转 `test-case`;只做静态扫描:转 `defect-analyze`。
## Steps
1. 查明事实
- 读取 feature YAML、环境清单;无环境名时先运行 `kata env list`,根据当前任务证据选择并记录明确环境名;同时读取 [workflows/prepare.md](workflows/prepare.md)、[workflows/implement.md](workflows/implement.md) 和 [workflows/deliver.md](workflows/deliver.md)。
- 不向用户询问可以从 `kata env list`、CLI、源码或当前 run 自行查明的事实;Cookie 只确认配置状态,不读取或回显值。
- 完成条件:feature 路径、目标 Web 环境和待自动化 YAML 用例清单唯一,已有脚本与共享依赖已盘点。
2. 确认关键决策
- 只询问环境选择、业务写入、Electron 探索或缺失业务证据等会改变结果且无法从环境确定的决策。
- Web 交付依次执行 prepare、implement、deliver;Electron 未落地时不套用 Web 完成声明。
- 完成条件:实现范围、真实业务动作、环境权限和交付证据标准明确。
3. 执行
- 按阶段完整执行 prepare、implement、deliver;正式运行只经 `kata runs exec` 或已分配 run,业务动作通过真实页面完成。
- 完成条件:目标用例均已处理,脚本、runner、共享依赖和 YAML 映射无遗漏,未使用 skip、mock 或弱占位绕过。
4. 验证
- 运行 `kata automation lint`、项目级共享 lint、`automation/tests/runners/full.spec.ts`、Allure 和 `kata runs verify`,核对同一 run 的平台核心业务记录。
- 完成条件:full 结果、Allure 结果和业务记录三项证据均来自同一环境与 `runs/<run-id>/`;缺项明确交付未完成。
## Delivery
- 返回重跑 full 的命令、通过与未完成清单、Allure 与截图位置、平台业务记录名称或 ID。
- 分开报告脚本问题、产品 Bug、数据问题、权限问题和环境问题。
- 只读导航只有用户明确要求只读覆盖时才算覆盖;只跑 smoke、仅语法检查或仅有 runner exit 0 均不算完成。
## Guardrails
- 创建、编辑、保存、删除、运行和导入等业务动作通过真实页面完成;后端接口只用于经授权的前置数据或诊断,不替代被测 UI 行为。
- 不用弱断言、吞错、`test.skip` 或 mock 被测业务接口换取通过。
- 菜单、字