| name | infoq-backend-verify |
| description | 为本仓库后端执行可重复验证，覆盖 service/controller/mapper/plugin/aspect 单测、Mapper XML 集成、HTTP smoke、WebSocket cluster smoke、登录/auth 校验和 Redisson OSS 兼容性验证。适用于后端测试设计、覆盖率回补、登录诊断、API smoke、运行态验证和后端回归验证。 |
InfoQ 后端验证
本技能只负责一件事：后端测试和运行态验证闭环。它是后端领域型 SOP，优先复用仓库脚本和 Maven runner，不临时拼接不可复跑命令，也不主导数据库侧数据修复。
模式选择
- 单测、覆盖率、Mapper XML、回归补测或 test-first backend fix，读取
references/unit/*。
- HTTP API smoke、导出、菜单、受保护接口、运行态验证，使用 smoke 脚本并读取
references/smoke/endpoints.md。
- 登录成功、token、
/auth/login、加密/明文登录回退和鉴权失败诊断，使用 scripts/verify_login.mjs 并读取 references/login/endpoints.md。
- WebSocket 集群、双节点路由或异常退出验证，使用
scripts/run_cluster_smoke.mjs。
- SQL、数据库、Redis、数据修复、迁移、测试数据维护或 API/UI/DB 一致性验证，改用
infoq-data-ops。
执行顺序
- 判定范围：先确认是单测、登录诊断、HTTP smoke、WebSocket 集群、Mapper XML，还是 Redisson OSS 兼容性验证。
- 只读探测：先读取配置、测试命令、端点说明和已有状态文件；不要先启动长生命周期进程。
- 最小闭环：每类问题先跑最小可复现命令，再扩展到完整 suite。
- 写入门禁：涉及数据库初始化、测试数据、导出、缓存清理、限流状态或登录态变更时，先列出目标表/键/接口、影响范围、清理方式和回滚条件；数据修复方案转交
infoq-data-ops。
- 执行验证：检查退出码、HTTP 响应、日志摘要、状态文件、owned 端口收口和 Redisson OSS 报错。
- 失败处理：产品代码缺陷、环境缺失、脚本缺陷和外部依赖不可达要分开说明，禁止吞错或伪造成功。
默认命令
扫描缺失测试：
node .codex/skills/infoq-backend-verify/scripts/scan_missing_tests.mjs
登录链路校验：
node .codex/skills/infoq-backend-verify/scripts/verify_login.mjs
后端 HTTP smoke：
node .codex/skills/infoq-backend-verify/scripts/run_smoke.mjs
双节点 WebSocket cluster smoke：
node .codex/skills/infoq-backend-verify/scripts/run_cluster_smoke.mjs
护栏
- 默认不关闭验证码；只有显式快速诊断才允许
--allow-captcha-disabled。
- Redisson PRO-only API 报错必须视为产品缺陷，不当作环境噪声。
- 单测失败先排查产品代码，不通过削弱断言、放宽 mock 或伪造成功路径来过关。
- 后端 Maven 命令优先使用
node .codex/scripts/backend_mvn.mjs -- ...。
- 任何写入数据库、Redis、文件导出或批量状态变更的诊断必须先明确目标和 cleanup。
- 不把后端 smoke 或单测通过当成数据修复完成；数据侧修复、迁移和一致性核对使用
infoq-data-ops。
- 任何由本 skill 启动的后端运行态必须写入
doc/tmp/infoq-backend-verify/*.state.json，状态至少覆盖 starting、running、passed、failed、interrupted、stopped。
run_smoke.mjs、run_cluster_smoke.mjs 和 verify_login.mjs --allow-captcha-disabled 在验证完成、失败或收到 SIGINT/SIGTERM/SIGHUP 时必须关闭自己启动的端口；下一次运行前必须先清理仍为 running/interrupted 的旧状态。- 只有显式
--keep-server / --keep-servers 才允许保留后端进程，且状态文件必须保留 running 与 pid/port/log，便于后续清理。
参考
- 单测模式：
references/unit/
- Smoke 端点：
references/smoke/endpoints.md
- 登录端点：
references/login/endpoints.md
