SuperAPI AI 工具集

ralph-verify-acceptance-criteria

测试与质量

查看项目

更新于 10-16 04:57

技能介绍

用途:核验 Ralph 用户故事实现是否满足 scripts/ralph/prd.json 中每条验收标准,生成结构化通过/失败报告;在 Ralph 完成用户故事后、需要标记 passes: true 前使用,也用于审计或复验既有实现、检查单条标准、生成跨故事报告。

主要能力与用法:读取项目根目录 scripts/ralph/prd.json 并解析 userStories 数组;可指定故事 ID(如 verify US-005),否则选取优先级最高且已标记 passes: true 的未验证故事或询问用户。先检测是否为 UI 故事:扫描标题、描述与标准中的 UI 关键词、.vue 文件与 app/pages/、app/components/、app/layouts/ 路径、Nuxt UI 组件(UCard、UButton、UBadge、UTable、USkeleton、UModal 等)及渲染/点击/响应式/深色模式等行为语言;UI 故事必须进行浏览器验证,不可跳过或推迟。随后按模式将每条标准映射到验证策略与工具,例如文件存在用 Glob/Read,组件/页面/中间件用 Read + Grep,类型检查用 bun run lint,Terraform 用 bun run tf:plan:staging,GraphQL schema 在 terraform/envs/staging/schema.graphql 上 Grep,解析器在 main.tf 与 terraform/functions/ 上 Grep,组件使用在目标 Vue 文件内 Grep,一般行为描述则阅读相关文件核查逻辑。执行顺序为浏览器验证优先(UI 故事):必要时 bun run dev & 启动开发服务器、./skills/dev-browser/server.sh & 启动浏览器,普通页面用 auth-role=user cookie 加 ?dev-bypass 查询参数,管理页面用 .env 中 DEV_DEMO_EMAIL/DEV_DEMO_PASSWORD 的演示账号,导航目标页后核查无控制台错误、预期元素可见、关键交互可用、响应式与移动端符合标准,并截图留证;之后依次做文件存在、代码内容、GraphQL schema、Terraform 基础设施与 TypeScript/Lint 检查。输出报告含标准结果表(编号、标准、状态、证据)与通过/失败汇总,失败项需给出文件路径与行号等具体缺失信息。

可选更新与批处理:全部通过且用户确认后,可将 prd.json 中对应故事的 passes 设为 true 并加 verifiedAt(ISO 时间戳);若有失败则不更新,改为列出修复步骤。批处理模式(verify all stories 或 audit the PRD)加载全部 passes: true 的故事逐个验证并输出汇总表。快速模式(quick verify 或 verify without browser)先跑静态检查,UI 故事的浏览器验证在报告中标记为 DEFERRED,此时故事不能标记 passes: true,之后可用 verify browser US-XXX 补做。

适用场景与限制:适用于 Nuxt 项目配合 Ralph 流程的验收核验。限制包括:浏览器验证为 UI 故事强制项,仅可延后不可省略;tf:plan:staging 需要 AWS 凭据;报告需包含截图等证据;对资料未提及的其他框架、平台、收费或效果暂未提供。