xworkmate-app/docs/testing/xworkmate-test-spec.md

XWorkmate 测试规范模板与指南

适用范围: xworkmate.svc.plus 目的: 提供可直接套用的验收写法，方便快速产出单次测试记录。

1. 这份文档的角色

这不是正式规范，而是模板和执行提示。正式规范见 docs/quality/xworkmate-test-spec.md。

2. 使用场景

• UI 行为调整
• 设置页、网关、凭据、存储、权限相关变更
• 路由、运行时、会话、同步链路相关变更
• 发布前验证
• 需要把日志任务、测试任务、验收结果统一归档

3. 写这份记录要回答什么

最少回答四个问题：

1. 这次改动改了什么
2. 哪些自动化测试已经覆盖
3. 哪些高风险点仍需人工确认
4. 失败或跳过时，后续该怎么补测

4. 建议输出目录

按变更类型选择一个最接近的目录：

• docs/releases/：发布前验收、日志任务、版本回收
• docs/reports/：专项测试报告、问题定位报告
• docs/quality/：正式测试规范、质量标准
• docs/architecture/：与测试相关的约束说明或验收边界

如果是正式规范，优先放到 docs/quality/。 如果是一次具体变更的验收结果，优先放到 docs/releases/。

5. 推荐结构

直接按下面结构填：

标题

• 用一句话说明主题
• 若是具体变更，可带日期或模块名

变更摘要

• 说明改动范围
• 说明功能是否变化
• 说明是否影响安全、存储、发布或交互

测试命令与结果

用表格列出：

• 命令
• 结果
• 测试数量或关键摘要

重点验证点

把需求拆成可验证的行为项：

• 每个行为项都要能映射到具体测试用例或人工步骤
• 不要写无法验证的抽象结论

失败项

如果有失败：

• 说明失败命令
• 摘要首个失败点
• 指出受影响文件或模块

如果没有失败，明确写 无

高风险回归点

只列仍然值得警惕的点：

• 自动化没有覆盖到的分支
• 需要真机、真服务、真账号验证的路径
• 依赖外部环境的路径

建议人工补测项

列出最小可执行步骤：

• 场景
• 操作路径
• 期望结果

相关文件

列出：

• 受影响的实现文件
• 对应测试文件
• 生成的文档文件

6. 参考示例

可参考现有验收文档：

• docs/releases/2026-03-23-single-agent-test-acceptance.md
• 正式规范: docs/quality/xworkmate-test-spec.md