阿里云官方开源的多云文档/API 基准测试工具，支持7大云厂商自动发现与质量评分，输出可落地的改进建议。
说明：
## 核心用法
该 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` 评分权重切换，也可通过 `—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 可能触发限流，建议控制并发与调用间隔。
会员专属
