| name | create-test-case-templates |
| description | 创建测试用例模板阶段专属技能，用于生成正确的pytest参数签名、覆盖率标记和未实现占位断言，并依据STDERR区分模板错误与fixture、Mock、参考模型、依赖或配置错误 |
测试用例模板创建
模板参数契约
模板可以直接使用内置文本编辑工具创建。先按Guide_Doc/dut_test_template.md读取当前工作区的已解析配置并确定唯一pytest函数签名；若RunSkillScript可用，也可以执行createtemplate.py批量生成相同模板。脚本是可选助手，不是参数契约的唯一来源。
普通DUT模板可能采用def test_xxx(env):或def test_xxx(env, ref_model):。若脚本生成了ref_model，它必须保持为第二个参数。普通DUT测试始终从env访问真实DUT；mock_dut只用于test_api_{DUT}_mock_*形式的Mock组件独立单元测试。本阶段不创建、不修改Mock测试，也不能把普通测试的env替换为mock_dut。
已提供基础设施的只读边界
本阶段只创建或修正普通测试模板。{OUT}/tests/{DUT}_api.py、{OUT}/tests/{DUT}_function_coverage_def.py以及其中的create_dut、dut/env fixture、ucagent.is_imp_test_template() fake DUT分支、get_coverage_groups(dut)、dut.fc_cover绑定、采样回调和coverage上报均是上游阶段已经完成的基础设施契约，禁止在本阶段修改、复制、替换或绕过。
尤其禁止下列做法：
- 在测试文件中重新定义
dut/env fixture，或构造自定义fake DUT、空fc_cover、假CovGroup
- 为消除
KeyError、setup错误或未标记CK而删除/延后mark_function，或把它包进忽略异常的代码
- 修改API模板、fake DUT返回路径、覆盖组名称、
fc_cover绑定、StepRis采样或set_func_coverage，使Checker表面通过
mark_function失败时，先核对模板中的FG/FC/CK字符串是否逐字存在于当前功能文档和覆盖率定义，并读取最早traceback定位责任行。若证据明确指向上游基础设施，应报告准确文件、行号和不变量缺失，并回到对应API/fixture/覆盖率阶段修复；不得在本阶段就地改造提供的模板。
本阶段通过函数命名隔离已完成的上游测试。API测试文件中的函数必须已经以完整、大小写敏感的test_api_{DUT}_开头；test_api_basic、test_ref_model、test_compute_api等名称表示API阶段未完成命名契约。出现TEST_FUNCTION_CONTRACT_VIOLATION时，应回到API测试阶段按details一次修正全部函数定义和mark_function函数对象引用。禁止在模板阶段删除skip、覆盖fixture、启用真实DUT、移动/重命名API测试文件，或给已实现API测试添加Not implemented。
普通模板函数使用test_<scenario>，不得占用test_api_、test_static_、test_random_保留前缀。保留前缀只能与其专用测试文件和阶段成对使用；发现错位时修正所属文件/阶段和完整函数前缀，不要用skip或移动到Checker范围外规避。
模板示例：
def test_basic_addition(env):
"""测试基本加法功能。"""
env.dut.fc_cover["FG-ADD"].mark_function(
"FC-BASIC", test_basic_addition, ["CK-NORM"]
)
assert False, "Not implemented"
执行步骤
- 阅读
reference_files和当前批次CK，确认每个模板的测试意图。
- 使用
EditTextFile(path, content)直接创建模板；ReplaceStringInFile只用于局部修改已经存在的模板。若RunSkillScript可用，可改用createtemplate.py一次性生成，但不得同时生成两套重复模板。
- 检查生成结果：保留当前配置要求的参数及顺序，确认覆盖率路径准确、TODO具体、最后一条语句为占位断言。
- 使用
Complete推进阶段；失败时先按下述流程定位真实原因。
模板边界
- 只写测试结构、docstring、具体TODO、
mark_function和末尾占位断言。
- 不调用DUT API，不调用参考模型，不实现激励或预期计算。
- 所有非忽略模板必须执行到
assert False, "Not implemented"并以AssertionError('Not implemented')结束。
- 不生成
test_api_{DUT}_*和test_api_{DUT}_mock_*测试；这些测试属于此前独立阶段。
- 不能在普通模板中直接使用
mock_dut或单独实例化Mock组件。
- 不修改
{DUT}_api.py、{DUT}_function_coverage_def.py或任何已有fixture来适配新模板。
检查失败处理
除预期占位断言外，ERROR、pytest收集失败和其他异常都不是合格模板结果。
- 先读
STDERR、完整traceback和必要的STDOUT。
- 从最早的有效异常定位责任文件，不要只看最终异常类型。
- collection/import错误：检查测试模块、API模块、参考模型、Mock模块、依赖和配置。
- setup错误：先检查新模板的导入、参数和FG/FC/CK字面量，再读取
env、ref_model、fake DUT和覆盖组初始化的最早异常；这些文件可用于定位，但不得在本阶段改写。
- call错误：确认失败是否确实来自末尾
Not implemented；其他异常必须修复。
- teardown错误：检查fixture finalizer、资源释放和清理逻辑。
- 参数门禁失败时，按Checker给出的期望参数和Guide中的已解析配置修正fixture参数；可选脚本可用时也可以重新生成，但不要规避Checker。
- 修复后重新检查，直到所有非忽略模板只以预期占位断言失败。
完成条件
- 每个目标CK至少被一个准确模板关联。
- 所有普通模板符合当前工作区的
env[, ref_model]参数契约。
- 普通DUT测试与Mock组件独立测试没有混用fixture类别。
- 提供的API模板、fake DUT路径、fixture和覆盖率定义保持不变，
env.dut.fc_cover由原有fixture正常提供。
- 不存在导入、fixture、setup、teardown或配置错误。
- 没有提前实现测试，也没有移动、删除或吞掉占位断言。
