以一个医疗业务工具为单元。工具规范写明它能做什么、哪些角色有权使用、输入参数和返回字段，以及查不到时空结果意味着什么、下一步该核对什么。每个规范配一组测试案例，正常调用与错误调用都有预期响应。
测试在模拟环境中运行。环境说明列出初始记录、允许使用的工具、任务、成功条件和重置方式，同一案例可以反复从相同状态开始。中断与恢复案例记录操作中断后的业务状态、可恢复的步骤和需人工核实的事项，例如提交超时后先查询原申请是否已经生成。
核对时把三类问题分开：接口本身不符合规范，调用方式错了，返回结果读错了。查询结果、计算值和业务状态变化分别检查。模拟环境里完成的操作，不等于真实系统已经办理。
一个查询工具的规范：按申请编号查询办理状态，限获授权的查询角色使用，返回申请编号和状态，空结果提示核对查询范围。调用测试两例：带编号查询，预期返回“处理中”；缺少编号，预期报错“缺少申请编号”。模拟演练说明写明初始记录为处理中、工具只读，成功条件是如实报告处理中、不声称已完成，测试后恢复同一条初始记录。
说明同一测试中工具的输入、权限和返回。
{
"任务编号": "TA001",
"工具": "query_request",
"用途": "按申请编号查询办理状态",
"权限": "获授权的查询角色",
"输入": {
"申请编号": "Q001"
},
"返回字段": ["申请编号", "状态"],
"空结果": "未找到匹配记录，需核对查询范围"
}校验参数及权限后调用，不能把空结果直接解释为业务未发生。
将正常及错误调用与预期响应对应。
{
"任务编号": "TA001",
"工具": "query_request",
"案例": [
{
"输入": {
"申请编号": "Q001"
},
"预期": {
"申请编号": "Q001",
"状态": "处理中"
}
},
{
"输入": {},
"预期错误": "缺少申请编号"
}
]
}逐例比较字段和错误响应，工具名与规范一致。
列明可重复测试所需的初始条件。
按同一初始条件重复调用；真实接口按实际规范适配。
解释列的含义、取值和关联方式。
| 字段 | 含义 | 样例 |
|---|---|---|
| 工具功能说明 | 说明工具可以完成的具体业务及返回内容。 | 按患者和时间查询已签发检验结果 |
| 工具适用角色 | 说明哪些业务角色可以使用该工具及权限条件。 | 已获查询权限的任务执行者 |
| 使用步骤样例 | 将工具使用顺序与预期观察对应。 | 查询现有申请 → 核对状态 → 决定后续动作 |
| 正确返回结果 | 记录工具在给定输入和状态下应返回的内容。 | 返回申请编号和当前办理状态 |
在导入数据前核对含义、空值与单位，避免仅按列名理解。
说明覆盖范围、缺失、核查方式与版本变化。
先看覆盖与缺失，再决定是否适合研究、训练或评价。
组织工具功能、参数要求、前置条件和模拟案例，用于接口联调与工具测试
定义工具能做什么、输入输出和使用条件。
{
"工具": "query_request",
"用途": "按申请编号查询办理状态",
"输入": {
"申请编号": "Q001"
},
"前置条件": ["具有查询权限"],
"返回": {
"状态": "处理中"
}
}先按规范校验参数和权限，再把返回值作为任务的可见信息。
定义测试时允许的操作、状态与重置方式。
按约定的环境或模拟材料运行任务，确认可执行范围后再接入。
逐步记录调用参数、返回和后续动作。
{
"步骤": 1,
"工具": "query_request",
"参数": {
"申请编号": "Q001"
},
"返回": {
"状态": "处理中"
},
"后续动作": "不重复提交，继续核对办理状态"
}将轨迹与工具规范、最终状态对照，定位参数、顺序或结果理解错误。
区分故障、尝试恢复和已确认结果。
| 异常 | 影响 | 动作 | 恢复条件 | 实际状态 |
|---|---|---|---|---|
| 提交超时 | 请求结果未知 | 查询原请求 | 取得可核对回执 | 待查询确认 |
先核对原操作结果再恢复，避免重复办理。
写明输入、需完成的工作和应提交的文件。
先读任务和允许使用的材料，再开始生成；提交时按文件清单核对。
按可观察行为或产物逐项评价。
| 评分项 | 满足条件 | 核对位置 | 判定 |
|---|---|---|---|
| 区分计划和完成 | 未把仅有申请写成已完成 | 结果表状态列 | 满足 / 不满足 |
| 结论有依据 | 指出来源和位置 | 引用列 | 满足 / 不满足 |
先逐项检查再汇总；材料不足和模型错误分别记录。
说明观察单位、文件之间如何连接以及使用范围。
交付前用样本和说明共同核对读取方式。
文件清单包含文件名称、版本和校验信息。
| 文件 | 版本 | 记录/页数 | 校验信息 |
|---|---|---|---|
| 工具规范.json | 版本 v1 | 实际交付时填写 | 实际交付时生成 |
| 模拟环境说明.md | 版本 v1 | 实际交付时填写 | 实际交付时生成 |
| 工具调用记录.jsonl | 版本 v1 | 实际交付时填写 | 实际交付时生成 |
| 异常与恢复记录.csv | 版本 v1 | 实际交付时填写 | 实际交付时生成 |
| 任务说明.md | 版本 v1 | 实际交付时填写 | 实际交付时生成 |
| 评分标准.csv | 版本 v1 | 实际交付时填写 | 实际交付时生成 |
| 使用说明.md | 版本 v1 | 实际交付时填写 | 实际交付时生成 |
| 文件与版本清单.csv | 版本 v1 | 实际交付时填写 | 实际交付时生成 |
接收时检查文件齐全、版本一致，再导入或开始任务。
页内展示的是样本预览；完整样本按“样本获取”一栏的方式提供。
工具类型按需
持续增加
面向病历及检验查询、药品核对、计算、检查申请与转诊，整合工具功能说明、使用条件、典型病例、正确使用样例及常见错误案例，配套模拟演练资料。
用于呈现工具调用、任务步骤、会诊审阅、异常处置和人工接管。
| 字段 | 含义 | 取值 |
|---|---|---|
| 任务可见资料范围 | 明确作答或办理时可以使用的材料及时间界限。 | 仅使用2025-03-01 10:00前已出具的记录 |
| 工具适用角色 | 说明哪些业务角色可以使用该工具及权限条件。 | 已获查询权限的任务执行者 |
| 使用步骤样例 | 将工具使用顺序与预期观察对应。 | 查询现有申请 → 核对状态 → 决定后续动作 |
| 正确返回结果 | 记录工具在给定输入和状态下应返回的内容。 | 返回申请编号和当前办理状态 |
| 空结果处理 | 说明空集合表示什么，以及何时需要继续核对。 | 查询为空；先核对范围与查询条件 |
| 工具验收判据 | 按输入、返回和业务状态检查工具行为。 | 同一查询范围下，返回字段与参考记录一致 |
| 工具功能说明 | 说明工具可以完成的具体业务及返回内容。 | 按患者和时间查询已签发检验结果 |
| 中断与恢复案例 | 操作中断后的当前业务状态、可恢复步骤及需人工核实事项。 | 申请提交中断，先查询申请是否已成功 |
同组还包括 任务约束条件、工具名称
用于呈现指南、文献、参考原文和引用位置。
| 字段 | 含义 | 取值 |
|---|---|---|
| 问题或任务内容 | 面向具体病例的完整临床问题或业务要求。 | 检查申请提交中断后，查询原申请状态并决定后续步骤 |
用于建立患者、就诊、机构和时间维度的匿名关联。
同组还包括 病例编号、患者年龄、患者生理性别、工具编号
用于维护影像、信号、检查报告和结构化所见之间的配对关系。
同组还包括 病例影像或信号材料
用于呈现病史、诊断、医嘱、治疗和处置过程。
同组还包括 病例现用药物
用于呈现实验室检验、检查项目和指标变化。
同组还包括 病例肝肾功能资料
工具名称、输入输出、权限和使用条件一致；正确及错误样例保留调用参数与结果。分别检查查询结果、计算值和业务状态变化，模拟运行不等于真实系统已完成操作。
工具规范连接权限、参数、返回结构、正常异常案例与模拟状态
先区分规范不符、调用错误和返回误读。
提供任务或研究问题、所需资料、使用阶段与预期交付格式。
确认来源、使用范围、内容覆盖、版本与缺失，区分已有材料和需加工的部分。
按项目确认批次、质量检查、验收方式与交付安排。
