多云产品文档/API基准测试

当用户需要对同类产品进行跨云文档/API对比时使用此技能。

支持的云平台

• - 阿里云
• AWS
• Azure
• GCP
• 腾讯云
• 火山引擎
• 华为云

数据源策略

• - L0（最高优先级）：用户通过---links参数固定的官方链接
• L1：机器可读的官方元数据/源码

• - L2：基于官方域名的受限网页发现（降级方案）
• L3：发现不足（低置信度）

工作流程

运行基准测试脚本：

bash
python skills/platform/docs/alicloud-platform-multicloud-docs-api-benchmark/scripts/benchmarkmulticlouddocs_api.py --product <产品关键词>

示例：

bash
python skills/platform/docs/alicloud-platform-multicloud-docs-api-benchmark/scripts/benchmarkmulticlouddocs_api.py --product serverless

LLM平台基准测试示例（百炼/Bedrock/Azure OpenAI/Vertex AI/Hunyuan/Ark/Pangu）：

bash
python skills/platform/docs/alicloud-platform-multicloud-docs-api-benchmark/scripts/benchmarkmulticlouddocs_api.py --product Bailian --preset llm-platform

如果省略--preset参数，脚本将尝试根据关键词自动匹配预设配置。

评分权重可通过配置文件切换（参见references/scoring.json）：

bash
python skills/platform/docs/alicloud-platform-multicloud-docs-api-benchmark/scripts/benchmarkmulticlouddocs_api.py --product Bailian --preset llm-platform --scoring-profile llm-platform

可选：固定权威链接

自动发现可能遗漏某些页面。如需更严格的对比，请手动传入官方链接：

bash
python skills/platform/docs/alicloud-platform-multicloud-docs-api-benchmark/scripts/benchmarkmulticlouddocs_api.py \
--product object storage \
--aws-links https://docs.aws.amazon.com/AmazonS3/latest/userguide/Welcome.html \
--azure-links https://learn.microsoft.com/azure/storage/blobs/

可用手动标记参数：

• - --alicloud-links
• --aws-links
• --azure-links
• --gcp-links
• --tencent-links
• --volcengine-links
• --huawei-links

每个标记参数接受逗号分隔的URL列表。

输出策略

所有产物必须写入以下目录：

output/alicloud-platform-multicloud-docs-api-benchmark/

每次运行生成：

• - benchmarkevidence.json
• benchmarkreport.md

报告指南

回答用户时：

1) 展示所有云提供商的评分排名。
2) 突出显示主要差距（P0/P1/P2）及具体修复措施。
3) 如果发现置信度较低，请用户提供固定链接并重新运行。

验证

bash
mkdir -p output/alicloud-platform-multicloud-docs-api-benchmark
for f in skills/platform/docs/alicloud-platform-multicloud-docs-api-benchmark/scripts/*.py; do
python3 -m py_compile $f
done
echo pycompileok > output/alicloud-platform-multicloud-docs-api-benchmark/validate.txt

通过标准：命令退出码为0且output/alicloud-platform-multicloud-docs-api-benchmark/validate.txt已生成。

输出与证据

• - 将产物、命令输出和API响应摘要保存到output/alicloud-platform-multicloud-docs-api-benchmark/目录下。
• 在证据文件中包含关键参数（区域/资源ID/时间范围）以确保可复现性。

前置条件

• - 执行前配置最小权限的阿里云凭证。
• 优先使用环境变量：ALICLOUDACCESSKEYID、ALICLOUDACCESSKEYSECRET，可选ALICLOUDREGIONID。
• 如果区域不明确，在执行变更操作前询问用户。

参考资料

• - 评分标准：references/review-rubric.md