P177 · 工具调用

实际试用能力,而不只检查存在

Capability Smoke-Test Over Presence-Check

运行一个小任务,确认工具能工作,而不只确认已经安装。

编辑审核

以下示例与示意结果由本站编写,用于说明方法,不是模型实测结果。

使用场景

源码分析器已安装,却可能不支持项目语言。教学代表文件含一个已知函数,当前任务只需要定位该定义;命令存在与该能力工作不是一件事。

具体做法

查实际程序、版本和已记录的只读接口,再用小型代表输入验证所需行为,读取退出、诊断和真实结果。结果应与已知输入相符,不仅是没有异常。失败按缺解析器、配置或不支持能力分类,选择文档化替代;探测不能引入未授权写入或安装。

反例

command-v成功就启动整库分析,工具返回空对象也称支持该语言,不检查代表函数。

改进写法

对教学已批准分析器先核对版本/接口,再在代表文件做只读语法与定义探测。检查实际函数身份、位置、退出与诊断;缺解析器或不支持时明确能力未满足,使用已核实替代。不要从安装、help文字或fork血缘推断行为,不在探测中执行未知修改。

为什么这样改

小任务给能力主张一个直接证据,安装或配置只提供候选。结果身份检查又防止空成功响应被误当所需解析功能已经可用。

如何验证

示意探测应找到代表函数的真实位置;不支持语言时返回可解释缺口,不报告整库已覆盖。若有宿主上下文机制,可用无敏感独特标记另检是否真正加载。

标记测试和单文件解析都只证明各自条件,不能外推所有能力。本篇不执行上游探测程序。

适用边界

代表性和安全副作用需明确,不能用真实生产动作做随意smoke test。工具自述名称可辅助,但实际注册和可观察行为才支撑能力;冻结宿主继承说法不等于所有平台保证。

原文与版本

如何收录这些方法

相关方法