用途:该工具用于加载 Shiplight E2E 测试项目的指南与上下文,适合在创建测试、更新测试、修复测试失败时使用。
主要能力:提供项目布局说明,包括 specs/tests/(每个可执行测试对应一个 Markdown 规格)、tests/(Shiplight YAML 测试)、environments/(名称到 base URL 的环境文件)、auth/、templates/、functions/、files/、test-results/、shiplight-report/ 和 .shiplight/。它还给出编辑契约:代理可编辑 specs/tests//*.md、tests//.test.yaml、environments/**/.env.yaml、auth//*.auth.ts、templates//.tmpl.yaml、functions/**/.func.ts、files/,仅当更改项目级运行时行为时编辑 playwright.config.ts,仅当更改命令或依赖时编辑 package.json;不得编辑 /*.yaml.spec.ts、test-results/、shiplight-report/、.shiplight/、node_modules/、.env,除非依赖变更需要否则不动 package-lock.json。
使用方式:运行 npm test 执行全部测试,或 npm run test:headed 以有头模式运行;调试特定测试时应使用最窄的相关命令。存在冲突时按优先级处理:用户明确指令、specs/tests/ 中的测试规格、现有测试目标与步骤意图及 VERIFY 断言、当前应用行为、项目内代理文档、代理推断。若当前应用行为与测试规格或目标冲突,应报告不匹配,而不要静默改写测试。每次调用时读取 references/knowledge.md,并检查当前工作目录的 knowledge/ 中此前代理留下的运行时知识笔记。按任务读取对应指南:写新测试读 references/creating-tests.md、references/test-design-guide.md、references/test-implementation-guide.md;更新或修复测试读 references/updating-tests.md 及两份设计/实现指南;认证 fixture 与登录读 references/auth.md。阅读后向用户确认已加载的指南。
限制:资料未提供该工具的收费、价格、平台或效果信息。