alicloud-platform-multicloud-docs-api-benchmark

核心用法

该 Skill 是一款面向多云环境的文档与 API 质量评估工具，用户只需提供一个产品关键词（如 "serverless"、"object storage"），即可自动对阿里云、AWS、Azure、GCP、腾讯云、火山引擎、华为云七大主流云厂商的同类产品文档进行横向对比评测。

工具采用分层数据源策略：优先使用用户手动指定的官方链接（L0），其次调用各云厂商的机器可读元数据 API（GCP Discovery API、AWS API Models、Azure REST API Specs 等，L1），最后才退化为受域名白名单约束的网页发现（L2）。执行命令为 Python 脚本调用，支持 --preset 预设模式（如 LLM 平台横评）和 --scoring-profile 评分权重切换，也可通过 --<provider>-links 手动固定权威链接以提升比对精度。

显著优点

1. 覆盖全面：一次性覆盖国内三大云（阿里云、腾讯云、华为云、火山引擎）与国际三大云（AWS、Azure、GCP），避免人工逐站检索的低效。
2. 评分体系标准化：内置可配置的评分维度（references/scoring.json），确保跨厂商评分口径一致，输出结果具备可比性。
3. 自动化程度高：从链接发现、内容抓取、质量打分到生成优先级改进建议（P0/P1/P2）全流程自动化，大幅降低竞品调研的人力成本。
4. 输出结构化：每次运行生成 benchmark_evidence.json（证据链）与 benchmark_report.md（可读报告），便于存档与二次分析。
5. 安全零依赖：仅使用 Python 标准库，无第三方包引入，消除供应链攻击风险。

潜在缺点与局限性

1. 网络依赖性强：必须能访问各云厂商官方站点及 DuckDuckGo、GitHub API，离线环境无法使用。
2. 发现置信度波动：L2/L3 层级的自动发现可能遗漏最新页面或误抓非权威内容，需用户手动校验链接。
3. 评分主观性：虽然维度标准化，但权重配置（scoring-profile）仍反映设计方偏好，不同业务场景可能需要自定义调整。
4. 仅限公开文档：无法评估需要登录或签署 NDA 才能查看的受限文档、内测 API。
5. 语言与区域局限：主要面向中文与英文文档，对小语种区域站点的支持未明确说明。

适合的目标群体

• 云产品经理：进行竞品文档对标，制定改进路线图。
• 技术写作团队：量化评估文档质量差距，争取资源投入。
• 解决方案架构师：快速了解多云产品差异，为客户选型提供依据。
• 开发者体验（DX）团队：持续监控 API 文档完整性与易用性。

使用风险

• 网络超时：各站点响应时间不一，默认 12-25 秒超时可能导致部分厂商数据缺失。
• 输出目录权限：脚本需写入 output/alicloud-platform-multicloud-docs-api-benchmark/，若目录无写权限会导致执行失败。
• 域名白名单误拦截：若云厂商新增文档子域名未纳入 allowed_domains，合法请求会被拒绝。
• 频率限制：频繁调用 GitHub API 或 DuckDuckGo 可能触发限流，建议控制并发与调用间隔。