mcpField
E
explorbot-plan

explorbot-plan

github.com/testomatio测试与质量1694 次安装6 天前更新
代码仓库

关于 explorbot-plan

explorbot-plan 是一项技能，可根据功能需求和必填起始 URL，手动编写 Explorbot 格式的 Markdown 测试计划。它适用于无需浏览器探索即可准备测试场景的人员，计划之后可交由 Explorbot 执行。

主要功能

  1. 01规定 Markdown 计划格式
  2. 02设置套件级前置 URL
  3. 03为场景指定优先级
  4. 04步骤保持原子化且结果可验证
  5. 05提供校验命令和运行说明

适用场景

  1. 01根据功能需求编写测试
  2. 02记录特定起始页面的场景
  3. 03准备由 Explorbot 运行的计划

安装

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

$npx skills add https://github.com/testomatio/skills --skill explorbot-plan

安装后在 Claude Code 中输入/explorbot-plan确认已加载。

详细介绍

编写 Explorbot 测试计划

根据功能描述 / 需求 / 文档和起始 URL，手动按照 Explorbot 的确切 Markdown 格式编写测试计划。无需浏览器或实时探索。

编写计划无需安装 Explorbot——它只是一个 Markdown 文件。只有之后要运行计划时才需要安装（参见“输出”）。

收集输入

  • 功能 / 需求 / 用户故事（请对方提供文档或描述）。
  • 套件标题（要测试的功能）。
  • 起始 URL：相对于应用主机的路径（例如 /login），或完整的绝对 URL。 这是必填项。相对路径会根据项目配置中的 web.url 解析；全局模式下则根据命令指定的网站（EXPLORBOT_URL / 已注册的主机）解析。
  • 每个场景的优先级：critical、important、high、normal、low。

格式


# User Authentication

### Prerequisite

* URL: /login


# User signs in with valid credentials

## Steps
* Enter a registered email in the email field
* Enter the matching password
* Submit the sign-in form

## Expected
* The user lands on the authenticated dashboard
* The signed-in account is shown in the header


# Sign-in is rejected for an unknown account

## Steps
* Enter an unregistered email and any password
* Submit the sign-in form

## Expected
* An invalid-credentials error is shown
* The user stays on the sign-in page

规则

  • 之后的**下一行**是 `# Suite Title`。通常每个文件一个套件；如需添加更多套件，请重复。
  • ### Prerequisite——其第一个列表项必须是 * URL: <path>。这会记录整个套件的起始页面，供读者和 TUI 使用。相对路径根据 web.url / playwright.url 解析；绝对 URL 也可使用。
  • 每个测试：一个 `` 块，然后是 # Scenario（h1）。 未指定优先级时，默认为 normal。
  • Prerequisite URL 是套件中每个测试的起始页面。从其他页面开始的场景应放在独立套件中，并设置自己的 Prerequisite URL。
  • ## Steps 和 ## Expected 使用 * 项目符号；长项目符号应换行，并将续行缩进两个空格。
  • Steps 是指导——测试人员会根据情况调整；每个步骤应是原子性的，不要使用脆弱的选择器。每个 ## Expected 项目都必须可独立验证（数据变更、状态变更，或有实际副作用的 UI 变更），不能只是重复步骤。
  • 场景标题描述业务结果，而不是点击路径。

验证

交付计划前，检查其中是否包含测试用例和 URL: /path 或 URL: https://… Prerequisite。退出代码为 0 表示通过；其他情况请修复计划并重新运行：

npx -y mdq-cli@latest 'comment(/^test/) && section("Prerequisite") item(/^URL: (\/|https?:\/\/)\S*$/)' <plan-file>

输出

手写计划仅作为输入——Explorbot 不会重写它，因此请将其保存在代码仓库中、靠近其覆盖的代码（例如 tests/plans/<feature>.md），并将其路径传递给 explorbot test。只有当用户希望计划与生成的计划放在一起时，才将其保存在本次运行的 output/plans/ 中：项目配置下为 output/plans/，全局模式下为 ~/.explorbot/sites/<host>/output/plans/。

运行计划（索引：1、1,3、1-5，或用 * 表示全部）：

npx explorbot test checkout-plan.md '*'
EXPLORBOT_URL=https://app.example.com npx explorbot test checkout-plan.md '*'

test 不接受 URL 参数：它会使用项目配置中的 web.url；全局模式下需要 EXPLORBOT_URL。会话完成时它始终以 0 退出——请查看 output/reports/ 中的报告，而不要依赖退出代码。参见 [[explorbot-fundamentals]]。

评论

支持 Markdown