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

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

支持的云平台

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

数据源策略

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

• - L2：官方域名受限的网页发现回退
• L3：发现不足（低置信度）

工作流程

运行基准测试脚本：

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

示例：

bash
python skills/platform/docs/aliyun-platform-docs-benchmark/scripts/benchmarkmulticlouddocs_api.py --product serverless

LLM 平台基准测试示例（百炼/Bedrock/Azure OpenAI/Vertex AI/混元/方舟/盘古）：

bash
python skills/platform/docs/aliyun-platform-docs-benchmark/scripts/benchmarkmulticlouddocs_api.py --product 百炼 --preset llm-platform

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

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

bash
python skills/platform/docs/aliyun-platform-docs-benchmark/scripts/benchmarkmulticlouddocs_api.py --product 百炼 --preset llm-platform --scoring-profile llm-platform

可选：固定权威链接

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

bash
python skills/platform/docs/aliyun-platform-docs-benchmark/scripts/benchmarkmulticlouddocs_api.py \
--product 对象存储 \
--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/aliyun-platform-docs-benchmark/

每次运行：

• - benchmarkevidence.json
• benchmarkreport.md

报告指导

回答用户时：

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

验证

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

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

输出与证据

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

前提条件

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

参考资料

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