Full Flow Test

简体中文 | English

一个自适应的软件质量 Skill，把代码审查、缺陷修复、自动化测试、对外契约、 打包部署和真实运行时验收串成一条可验证的流程。

它不会每次强制执行所有步骤，而是根据用户目标和受影响范围选择必要门禁：

1. 审查代码逻辑并修复已确认的问题；
2. 按受影响单元执行静态检查、构建、单元和集成测试；
3. 验证真实的 HTTP、CLI、消息、文件、SDK、数据库或插件契约；
4. 在浏览器、移动端、桌面端、终端或设备等真实产品运行时验收；
5. 根据测试证据核对验收清单；
6. 清理本次测试创建的资源，并如实报告未覆盖范围。

支持只审查、只运行指定测试、库/CLI/服务验证、只做运行时验收，以及从代码审查到 完整产品回归的发布门禁。Web 项目仍分别报告后端、前端、API 和浏览器结果； 其他项目不会被强行套用 Web 门禁。未选择的步骤会标记为不适用或按用户要求排除， 不会被宣称为已经通过。

安装

npx skills add guorui999/full-flow-test

全局安装：

npx skills add guorui999/full-flow-test -g

使用示例

使用 full-flow-test 审查当前分支，修复确认的问题，然后跑相关单元和集成测试。

发布前做一次全量质量门禁：代码审查修复、自动化/API 测试、真实浏览器全功能回归。

只执行现有后端单元测试，不要修改代码，也不用启动浏览器。

工作原则

• 默认只覆盖当前变更及直接受影响范围；只有明确要求时才执行全量回归。
• 多个门禁被选中时，前一阶段未通过不会进入依赖它的下一阶段。
• 只有用户授权修复时才修改代码；只测试不代表允许修复。
• 优先使用仓库已有命令、测试框架和 CI 配置。
• 不对生产环境或共享客户数据执行写入测试。
• 只清理本次运行明确创建并记录的进程、数据库、账号和临时文件。
• 相关代码、配置、夹具、依赖或运行环境变化后，旧证据会失效。
• 没有证据的测试、构建、迁移或运行时流程不会被报告为通过。

可选的项目发现脚本需要 Python 3.10+（读取 pyproject.toml / Cargo 时需 3.11+ 的 tomllib，或在 3.10 安装 tomli），只读取项目配置，不会执行发现到的命令。 Skill 还包含机器可读资源台账、可恢复长任务管理器、浏览器环境预检器，以及 可执行的 Gate C 工具包：with_server.py（起停自有服务）、browser_action.py（discover/smoke 侦察与就绪）、flow_harness.py（PASS/FAIL/BLOCKED、HTTP、有头 Chromium）、 playwright_probe.py（就绪探针），以及 examples/ 下手写完整 Playwright 场景模板。 预检器可识别仓库内的 Node 运行器、本机 Python Playwright、npm 全局 Playwright，以及 scripts/*suite* / *flow* / webapp_* 等混合 API+UI 套件候选，并输出 preferred_runner / fallback_runner / hybrid_suite_candidates。先对运行中的前后端 URL 尝试仓库 E2E 或混合套件；没有仓库套件时，必须复制 examples/ 模板写并执行 run-owned 手写场景（discover/smoke 不能单独关闭多步清单项），不得把「没 E2E 目录」 当成跳过 Runtime UI 的理由。有头观察可用 FULL_FLOW_HEADED / WEBAPP_HEADED（可选 FULL_FLOW_SLOW_MO / WEBAPP_SLOW_MO / SLOW_MO）。Runtime UI 结果按 PASS/FAIL/BLOCKED 记账：未实现产品面与缺外部权威为 BLOCKED，不得把未执行写成通过。 详见 full-flow-test/references/hybrid-runtime-suites.md 与 full-flow-test/examples/README.md。

开源许可

MIT License。参考项目和方法来源见 THIRD_PARTY_NOTICES.md。