用途:当用户给出阿里云产品名称或产品代码,并希望对该产品的文档与 API 文档做端到端质量审查时使用。
主要能力:根据最新 OpenAPI 元数据解析产品;获取默认版本的最新 API 文档;从官方产品页发现产品/帮助文档链接;生成结构化审查报告,包含评分、证据和按 P0/P1/P2 排序的改进建议。
使用方式:运行捆绑脚本,例如 python skills/platform/docs/aliyun-platform-docs-review/scripts/review_product_docs_and_api.py --product "ECS"。每次运行会在 output/aliyun-platform-docs-review/ 下生成 review_evidence.json 和 review_report.md。回答用户时先说明解析出的产品与版本,再概述评分与前三项问题,列出 P0/P1/P2 建议及具体行动,并提供报告使用的来源链接。
前置条件:执行前配置最小权限的阿里云凭证,优先使用环境变量 ALIBABACLOUD_ACCESS_KEY_ID、ALIBABACLOUD_ACCESS_KEY_SECRET,可选 ALIBABACLOUD_REGION_ID;区域不明确时,执行变更操作前先询问用户。
验证:可用 py_compile 编译脚本,通过标准为命令退出码 0 且生成 output/aliyun-platform-docs-review/validate.txt。
限制:资料未提供具体评分细则、支持的产品范围、脚本依赖版本及失败处理方式;审查规则参考 references/review-rubric.md。