add-test-requirement

添加测试要求

先加载规则。 在读取、编辑或编写任何 .plain 文件之前，先调用 load-plain-reference 技能，并阅读它指引你查看的规则文件。只有在本次对话中已运行过 load-plain-reference 时，才可跳过此步骤。

工作流

1. 确定目标 .plain 文件。 如果目标不明确，请询问用户。
2. 读取文件，了解现有测试要求和整体规范结构。
3. 确认这是符合性测试事项——单元测试指南应放在 ***implementation reqs*** 中，而不是这里。
4. 起草要求，遵循下方规则。
5. 插入要求，放在 ***test reqs*** 部分。
6. 再次读取文件，确认位置和语法正确。

适用内容

测试要求规定如何编写和运行符合性测试。常见内容包括：

• 测试框架：要使用的框架（例如 pytest、Unittest、xUnit）
• 执行方式：运行测试的命令
• 测试约束：测试中必须或不得执行的操作（例如，不得跳过测试、模拟要求）
• 测试数据：测试夹具或模拟数据的结构
• 环境设置：运行符合性测试的前置条件

不适用内容

• 单元测试指南——应放在 ***implementation reqs*** 中
• 测试场景——符合性和验收场景应写在测试 plain 文件中，使用 add-test-scenarios（参见 test-plain-files.md）
• 行为要求——应放在 ***functional specs*** 中
• 实现技术选型——应放在 ***implementation reqs*** 中

符合性测试与其他测试的区别

测试类型	指定位置	目的
单元测试	***implementation reqs***	单独测试各项功能
符合性测试	如何测试：***test reqs***；测试什么：测试 plain 文件中的 ***conformance tests***	验证某项功能预期的使用方式及其主要路径
验收测试	如何测试：***test reqs***；测试什么：测试 plain 文件中的 ***acceptance tests***	验证某项功能在非预期使用情况下的表现：参数无效、身份验证错误或缺失、数据缺失

格式

测试要求应以项目符号形式列在 ***test reqs*** 部分：

***test reqs***

- :ConformanceTests: should be implemented using pytest framework.

- :ConformanceTests: will be run using "pytest" command.

- :ConformanceTests: must be implemented and executed - do not skip tests.

- :ConformanceTests: should mock all external HTTP calls.

在有助于明确内容时，引用预定义概念（例如 :ConformanceTests:）以及任何已定义的 :Concepts:。

验证清单

• 描述的是符合性测试事项，而非单元测试或行为
• 所有引用的 :Concepts: 均已定义（或为 :ConformanceTests: 这类预定义概念）
• 未重复文件或其导入内容中已有的指南
• 按 concise-specs.md 精简：用词直白，不写理由，不写框架默认行为
• 已放在 ***test reqs*** 部分中
• 不含应放在 ***functional specs*** 中的行为要求