运行时依赖
安装命令
点击复制技能文档
Alibaba Cloud 产品文档 + API 文档审查者 当用户提供产品名称并请求对端到端文档/API 质量进行审查时,使用此技能。 此技能的作用 从最新的 OpenAPI 元数据中解析产品。 获取默认版本的最新 API 文档。 从官方产品页面发现产品/帮助文档链接。 生成结构化的审查报告,包括: 评分 证据 优先级建议(P0/P1/P2) 工作流 运行捆绑的脚本:python skills/platform/docs/aliyun-platform-docs-review/scripts/review_product_docs_and_api.py --product "<产品名称或产品代码>" 示例: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 报告指南 当回答用户时: 首先声明解析的产品 + 版本。 总结评分和前 3 个问题。 列出 P0/P1/P2 建议,并提供具体的操作。 提供报告中使用的源链接。 验证 mkdir -p output/aliyun-platform-docs-review for f in skills/platform/docs/aliyun-platform-docs-review/scripts/*.py; do python3 -m py_compile "$f" done echo "py_compile_ok" > output/aliyun-platform-docs-review/validate.txt 通过标准:命令退出 0 且 output/aliyun-platform-docs-review/validate.txt 被生成。 输出和证据 将工件、命令输出和 API 响应摘要保存在 output/aliyun-platform-docs-review/ 下。 在证据文件中包含关键参数(区域/资源 ID/时间范围)以实现可复现性。 先决条件 在执行之前配置最小特权的 Alibaba Cloud 凭证。 更喜欢环境变量:ALICLOUD_ACCESS_KEY_ID、ALICLOUD_ACCESS_KEY_SECRET、可选 ALICLOUD_REGION_ID。 如果区域不明确,请在运行可变操作之前询问用户。 参考 审查标准:references/review-rubric.md GitHub CLI API