用途:该技能用于校验文档中的代码示例,确保示例语法正确,并且使用的 API 真实有效,适合在被要求验证代码正确性或校验 API 用法时使用。
主要能力:一是识别文档中的每个代码块,覆盖 Python、C#、PowerShell、CLI、JavaScript 等语言;二是针对 Azure/Microsoft SDK,借助 microsoft_code_sample_search 核实方法、类是否真实存在;三是识别假装成真实代码的伪代码,例如 client.do_magic_thing() 这类虚构调用。
检查范围:会导致无法编译或运行的语法错误;知名 CLI 命令中无效的参数或实参;括号、花括号开闭不匹配;变量命名不一致,例如定义 myVar 却使用 my_var。合理的占位符(如 <resource-group-name>)属于可接受用法,但虚构的 API 调用不行。
不报告的项:不影响执行的风格或 lint 问题、注释与文档字符串、格式上的简化。
使用与限制:资料未提供具体安装命令、调用方式或价格信息;技能依赖 microsoft_code_sample_search 校验 Microsoft/Azure SDK 的真实性,对其他 API 的校验方式暂未提供。