关于 replica-test
replica-test 是用于规划和验证应用克隆测试的技能,按流程组织测试计划、Playwright 自动化、手动检查、缺陷报告与修复,并禁止对原应用进行压力或模糊测试。
主要功能
- 01按用户流程编写测试计划
- 02边界与负面用例清单
- 03Playwright 端到端测试
- 04手动测试检查清单
- 05按严重级别编写缺陷报告
- 06先写测试再修复
适用场景
- 01为每个已梳理的用户流程规划测试
- 02在本地服务器上自动测试克隆应用
- 03记录并排序已复现的缺陷
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ jakeschincariol/ replica-skill --skill replica-test安装后在 Claude Code 中输入/replica-test确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
bug-report.mde2e.example.spec.tstest-plan.md详细介绍
replica-test
读取 replica/recon.md 中的流程。生成 replica/test-plan.md、replica/bugs.md,以及项目中的端到端测试(e2e/)。此文件夹中的模板:test-plan.md、bug-report.md、e2e.example.spec.ts。
规则
测试你的克隆版,而不是原版。 切勿对原版应用的服务器进行负载测试、模糊测试、脚本测试或压力测试。像普通用户一样手动使用原版,观察其行为没有问题。
第 1 步:制定计划
针对侦察图中的每个流程 F01、F02……,编写:
- 正常流程:操作步骤,以及用户最终应该看到的内容。
- 适用的边界情况。针对每个流程逐项检查以下情况: 空输入、超长输入、表情符号和重音符号、同时打开两个标签页、双击提交、流程中途点击返回按钮、流程中途刷新、网络缓慢、离线、会话过期、第二位用户的数据(必须不可见)、时区和夏令时、移动端宽度、仅使用键盘、屏幕阅读器标签。
- 异常情况:密码错误、银行卡被拒(Stripe 测试卡
4000 0000 0000 0002)、权限被拒、记录已删除。
为每个测试用例编号:F01-H1、F01-E3、F01-N2。
第 2 步:尽可能自动化
使用 Playwright,每个流程编写一个测试文件,并针对带有种子数据的本地开发服务器进行测试。使用角色和标签作为选择器(getByRole('button', { name: 'Book' })),绝不要使用 CSS 类。参见 e2e.example.spec.ts。
npm i -D @playwright/test && npx playwright install chromium
npx playwright test
在每个测试文件中添加:遇到控制台错误时测试失败,收到任何 5xx 响应时测试失败,并在每个屏幕上运行 axe 无障碍扫描(@axe-core/playwright)。
第 3 步:手动检查其余内容
无法自动化的内容(收到邮件、使用真实服务商进行 OAuth、端到端支付、视觉问题)需要手动检查。如果有浏览器工具可用,请用它操作本地克隆版,并为每个步骤截图。否则,将检查清单交给用户并等待回复。
第 4 步:报告错误
每个错误都按 bug-report.md 格式记录在 replica/bugs.md 中:包含 ID、严重程度、准确步骤、预期结果、实际结果和证据。严重程度:
| 含义 | |
|---|---|
| S1 | 数据丢失、安全漏洞、支付错误、核心流程受阻 |
| S2 | 功能损坏,且没有替代方案 |
| S3 | 功能损坏但有替代方案,或显示明显错误 |
| S4 | 外观问题 |
只报告已复现的问题。“可能存在问题”应放入单独的“待检查”列表。
第 5 步:修复循环
优先修复 S1 和 S2。每次修复都要先编写失败的测试,再修复问题,确认测试通过,并保留测试。每批修复后重新运行整套测试。更新 bugs.md,注明修复每个问题的提交。
输出
test-plan.md、测试文件、bugs.md,以及一份摘要:运行、通过和失败的用例数量,按严重程度分类的错误,以及目前已修复的问题。不得交付仍有未解决 S1 问题的版本。下一步:/replica-diff。