mcpField
A
aureuserp-test-case-builder

aureuserp-test-case-builder

github.com/aureuserp测试与质量373 次安装35 周前更新
代码仓库

关于 aureuserp-test-case-builder

用于为 AureusERP 插件 API 编写可复用 Pest 功能测试的技能。它强调优先使用工厂、区分安全与引导辅助工具,并先修复测试侧问题。

主要功能

  1. 01使用 Pest 测试 API 端点
  2. 02优先通过工厂创建数据
  3. 03分离安全与引导辅助工具
  4. 04采用事务式数据库配置
  5. 05编写插件范围内的可复用测试

适用场景

  1. 01测试 API 端点行为与验证
  2. 02重构 API 测试及辅助工具
  3. 03生成插件 API 测试文件

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/aureuserp/agent-skills --skill aureuserp-test-case-builder

安装后在 Claude Code 中输入/aureuserp-test-case-builder确认已加载。

附带文件references/api.md

详细介绍

AureusERP 测试用例构建器

使用此技能,通过仅针对测试的修复和可复用辅助工具,使用 Pest 构建插件 API 测试。

范围分轨

  1. API 测试用例轨道(当前启用)
  • 按照 references/api.md 中的端到端工作流、辅助工具边界、断言和防护措施执行。
  1. Filament 测试用例轨道(预留,未来启用)
  • 目前不要在此技能中臆造 Filament 专属测试规则。
  • 保持 API 约定不变。
  • 后续添加 Filament 指引时,应将其作为单独的参考资料添加(例如 references/filament-*.md),并根据任务类型明确选择。

核心规则

  1. 对 API 端点使用 Pest 功能测试(getJson、postJson、patchJson、deleteJson)。
  2. 优先使用工厂进行设置和负载创建。
  3. 严格区分辅助工具的职责:
  • SecurityHelper 用于身份验证/权限/防护措施。
  • TestBootstrapHelper 用于非安全相关的引导和插件安装。
  1. 不要在测试文件中使用 RefreshDatabase 或 LazilyRefreshDatabase;使用全局 DatabaseTransactions 配置。
  2. 优先修复测试/辅助工具,再修改应用代码。
  3. 不要使用跳过测试作为解决方案。

快速路由

  1. API 控制器端点测试(index/store/show/update/destroy、身份验证、验证、恢复/强制删除):使用 references/api.md。
  2. 带有辅助工具清理的 API 重构/错误修复:使用 references/api.md。
  3. 为新的插件 API 测试文件生成模板:使用 references/api.md。

输出预期

  1. 测试应限定于插件范围且可复用。
  2. 断言应具有确定性,并与 JSON 资源保持一致。
  3. 负载应优先通过工厂创建,仅进行有针对性的覆盖。
  4. 安装/引导过程应为非交互式,并确保环境安全。

评论

支持 Markdown