用途:本技能像新员工入职引导一样,为 AI 代理搭建 4 类 E2E 测试“测试基础设施(harness)”,让代理能自行编写和运行端到端测试。核心思路是将团队内隐知识显式化,避免代理每次会话重新发明错误做法。
主要能力与产出 4 项:1) AGENTS.md:代码库整体说明,涵盖服务构成、核心流程、认证与访问控制;2) E2E 运营与编写规则 SSOT(如 e2e/CONVENTIONS.md):执行环境、认证场景、测试范围及“为何不测”的决策记录;3) 共享 fixture/helper:如 storageState 认证状态 fixture、测试数据初始化等复用代码;4) MCP 服务器接线:让代理直接访问需求文档、设计、issue、PR 等既有上下文。
使用方式:按依赖顺序推进——步骤 0 先排查已有 AGENTS.md、CLAUDE.md、playwright.config.*、e2e/ 等,避免覆盖并沿用既有约定;步骤 1 代码库勘察生成 AGENTS.md;步骤 2 E2E 决策访谈生成 SSOT;步骤 3 构建共享 fixture,核心模式是在 setup 项目登录一次并保存 storageState,供所有测试加载,避免每个测试重复登录;步骤 4 接线 MCP。完成标准包括:新测试无需登录代码即可认证、4 类内隐知识(认证函数、过期码、baseURL、测试范围)已记录等。
适用场景:需要让 AI 代理在大型代码库(含单体仓库、按包区分认证/baseURL)中自主编写和维护 E2E 测试的团队。
限制与注意事项:不得覆盖既有规则文件,应做增量补充;storageState 含真实令牌,禁止提交,须加入 .gitignore 并在自动化结束后删除;无依据不得编造描述,不确定处需询问人工并标注推测;大型单体仓库可在单一 SSOT 内按包用表格分支。参考文件包括 agents-md-guide.md、conventions-ssot-guide.md、fixtures-helpers-guide.md、mcp-wiring-guide.md;相邻技能为 playwright-cli、mcp-setup、deepinit。具体命令与安装细节暂未提供。