核心功能
该技能提供跨云厂商产品文档与API文档的标准化基准评测能力。用户仅需输入产品关键词(如"serverless""百炼"),系统即自动发现各平台官方文档及API链接,基于统一的评分维度进行质量对比,输出排名与可执行的改进建议。
显著优势
- 全栈覆盖:支持全球七大主流云厂商(阿里云、AWS、Azure、GCP、腾讯云、火山引擎、华为云),覆盖L0-L3四级数据源策略,从用户指定链接到自动发现形成完整链路
- 智能发现:集成GCP Discovery API、AWS API Models、Azure REST API Specs等机器可读源,官方域名约束下的网页发现作为兜底
- 灵活配置:内置LLM平台等预设场景,支持自定义评分权重(
scoring-profile),可手动固定权威链接提升评测严谨性 - 结构化输出:自动生成
benchmark_evidence.json证据链与benchmark_report.md评估报告,便于追溯与归档
潜在局限
- 发现置信度风险:L2/L3级别数据源依赖网页抓取,可能遗漏最新文档或API版本,存在时效性偏差
- 评分主观性:
references/review-rubric.md中的评分维度虽统一,但权重配置可能不完全适配所有产品类型 - 厂商差异:各云厂商文档架构差异大(如AWS多服务拆分 vs 阿里云集成式文档),跨平台对齐存在结构性挑战
- 网络依赖:自动发现依赖各厂商公开API与站点可访问性,部分地区或网络环境可能受限
适用人群
- 云产品经理:制定文档体验优化路线图
- 技术文档工程师:对标竞品明确差距优先级
- 开发者体验(DX)团队:评估API易用性与完整性
- 企业上云决策方:多平台技术选型参考
使用建议
对于关键业务评测,建议通过--<provider>-links手动固定官方链接,规避自动发现的不确定性。发现置信度低时,系统会提示重新运行,用户应积极响应以提升结果可靠性。