为 FastGPT 生成、维护或合并去重按业务归档的集成测试用例 Markdown,以一个业务验收目标覆盖多个相关场景,支持接口、UI、端到端和服务集成测试及单页阅读器。不用于单独编写 Vitest 测试或系统升级迁移用例。
81%
Does it follow best practices?
Run evals on this skill
Adds up to 20 points to the overall score
Passed
No findings from the security scan
生成可由测试人员或自动化执行方复现的用例,存放于仓库根目录 .agents/test/。默认交付用例文档,不执行真实业务操作,也不自动转换为测试代码。已有脚本优先复用并声明覆盖,用户同时要求执行或自动化时,沿用其授权、环境和测试范围。
需要筛选并实际执行已有用例、逐项记录临时 HTML 报告时,使用 用例执行 skill。
系统升级迁移、历史回填和升级脚本恢复不归入业务集成用例库,由迁移代码旁的 Vitest / 数据库专项测试验证,不为其新增 .agents/test/ 用例或 test:cases 脚本。正常业务接口的旧数据兼容仍按业务行为保留。
用例统一面向本地 dev 环境及其已配置服务,不要求新建独立应用实例、Mongo、Redis 或专用数据库。通过本轮新建团队、应用和记录的明确 ID 清单隔离测试数据,按清单清理,不清空共享开发库或改动无关数据。
先读取仓库 AGENTS.md、.agents/code/syntax.md 和 业务分类。该 JSON 登记已确认的分类名称和路径,阅读器与查询工具直接读取它;分类可随业务需求扩展。
.agents/test/<业务域>/<子业务>/<可选细分>/<ID>-<业务目标>.md,业务目录最多 3 层;每级直接子业务最多 3 个。按业务规则组织最小且可维护的用例集合,不为尚无用例的分类创建空目录。app/workflow、app/agentv2、app/agent。共享的应用管理用例可直接放 app/,使用 tags 说明适用类型;类型间行为不同时拆开。permission;数据库、存储、缓存、队列、沙箱等基础设施集成归 infra。businesses.json,再创建对应目录和用例。已有明确授权的分类调整直接执行,已确认分类下新增用例无需重复确认。case_version: 1 的 Markdown。旧文件 .agents/test/workflow/connection-rules.md 已拆为 app/workflow/editor/ 下的独立用例,旧路径保留查找索引;历史执行结果不作为当前用例通过的证据。category 为单选用例类型,所有用例必须填写:basic(基础场景)验证常规业务路径;abnormal(异常场景)验证非法操作、业务拒绝、依赖失败及恢复;boundary(边界场景)验证临界条件、作用域边界、配置切换和历史兼容。
用例类型与 scenario 相互独立。例如越过容器边界连线可以是 category: boundary、scenario: failure。两者按用例主要验收目标归类,不限制其内部子场景的类型和结果;子场景在表中分别标记,必要时通过已有 tags 补充覆盖范围。不为分类标签或凑齐三类复制同一用例。
types 表示测试方式,可多选;evidence 表示验证证据:
| types | 适用范围 |
|---|---|
| api | 通过真实 HTTP 入口验证入参、认证授权、响应及副作用 |
| ui | 通过产品界面验证交互、状态、错误提示、保存与重载 |
| e2e | 验证跨页面、API、服务及异步任务的完整用户目标 |
| integration | 验证真实服务与数据库、向量库、缓存、队列、存储或第三方依赖的协作 |
NextAPI/共享 HTTP 管线确定请求与响应;同时验证 HTTP 状态、业务 code/data 或流式事件,不能只检查 HTTP 200。不把导入 handler 并 mock 所有依赖称为真实接口集成测试。packages/service/common/logger/、packages/service/common/http/entry.ts、应用日志 API 以及模型渠道日志 API,具体用例只引用已核实的部分。otel: false 会影响可见性;日志/trace 缺失本身不能证明业务没有执行。用户配置错误可能记录为 info,不应要求所有失败都有 error 日志。模板 frontmatter 用于查询,正文必须有「用例简介、前置准备、测试步骤、预期结果」四个二级标题。
id:全库唯一、稳定,例如 FG-APP-WORKFLOW-001。新建前同时检查当前用例与合并来源/旧编号索引,已用过或退役的编号不能复用;改名和移动不改变 ID。business:与文件所在的业务目录完全相同,例如 app/workflow/editor。category:basic / abnormal / boundary,分别表示基础场景、异常场景、边界场景;按主要验收目标选择,与 API/UI 等测试方式分开记录。scenario:success / failure / special,表示主要验证的业务场景,不表示实际执行结果;同一用例可在子场景矩阵中同时覆盖成功、拒绝和特殊行为。status:draft / ready / deprecated,表示用例定义状态。只有前置准备、步骤、断言可复现且无阻塞时才设 ready;不代表测试已通过。priority:P0 核心可用性/权限或数据资金正确性,P1 重要业务分支,P2 次要兼容或体验;按实际影响判断。types、tags、evidence、sources、routes、related 均为数组。没有相关接口时 routes: [],不编造占位接口。automation 可选,按 脚本执行约定 关联实际存在的 Node 或 Playwright 脚本及完整子场景 ID。先查询已有脚本再新增,复用公共准备和操作;没有脚本不影响用例归档,由 AI 执行。只完成一部分参数变体或只做内部规则单测时,不能声明覆盖完整集成场景。automation 映射,在前置准备明确标注 AI 执行;保留验收断言和证据要求,不保留仅靠缺失配置返回阻塞的占位脚本。以下命令从仓库根目录运行,需要已安装仓库依赖(复用 js-yaml,无需新增包):
# 校验用例、ID、分类与必需章节;不执行产品测试
node .agents/skills/system/fastgpt-integration-test-case/scripts/catalog.mjs validate
# 查询并输出 JSON;可组合 --business、--category、--type、--scenario、--tag、--evidence、--status、--q
node .agents/skills/system/fastgpt-integration-test-case/scripts/catalog.mjs list --business app/workflow --category boundary --type ui
# 查询多场景用例的覆盖范围;category 仅表示主类型,覆盖标签由用例按需填写
node .agents/skills/system/fastgpt-integration-test-case/scripts/catalog.mjs list --tag 覆盖异常场景
# 启动只读阅读器和查询接口,默认只监听本机
node .agents/skills/system/fastgpt-integration-test-case/scripts/catalog.mjs serve浏览器访问 http://127.0.0.1:4317/,JSON 入口为 GET /api/cases,支持与 CLI 同名查询参数。返回用例元数据、正文、相对路径、分类及诊断信息;每次读取重新扫描,不另维护 index.json 或数据库。
唯一页面是 .agents/test/index.html,首页先展示大面积的业务目录和用例列表,点击具体用例才进入正文;返回目录保留筛选和浏览位置。默认每 5 秒重新扫描。也可直接打开 HTML,选择 .agents/test/ 目录后离线阅读;支持目录句柄时可重新扫描新增/修改文件,目录上传兼容模式下更新后需要重新选择。浏览器不能未经授权扫描任意本地目录。
维护页面解析逻辑时修改 scripts/case-format.cjs,再运行 catalog.mjs sync-reader,将共用解析器嵌回单页。HTML 已内嵌带许可声明的 Markdown/YAML/净化库,不依赖 CDN。新增用例只写 Markdown,不改 HTML。
交付前运行上述 validate;改动查询工具或阅读器时,使用临时用例目录验证过滤、解析失败诊断、重复 ID、目录扫描、Markdown 渲染和刷新,不在正式用例库留下演示数据。不运行无关或全量产品测试,不另写总结报告。
labring/FastGPT
3b0ad50
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.