用途:在发布前审查 CloudBase 云 API 集成是否与官方文档一致,避免过期、猜测或无文档的行为进入仓库。适用于检查 MCP 工具、云 API 封装、生成的动作元数据和相关文档。
主要能力:核对准确的 action/接口名、必填与可选参数、参数大小写与嵌套、请求结构、鉴权模型、响应结构与限制;并把差异归类为过期命名、参数映射错误、大小写或嵌套错误、无文档请求结构、缺少契约测试、公开文档过期等。
使用方式:先读 references/review-checklist.md,确定审查范围(mcp/src/tools/*、相关测试、生成的 action 元数据、描述同一行为的用户文档);随后以文档为准进行验证,必要入口包括 CloudBase API 概览 https://cloud.tencent.com/document/product/876/34809、依赖资源 API 文档 https://cloud.tencent.com/document/product/876/34808,以及 CloudBase Manager SDK 文档 https://docs.cloudbase.net/api-reference/manager/node/introduction;再对实现、测试、元数据与文档交叉核对,优先依赖邻近的针对性测试。
限制与注意:官方文档未明确支持的 action 或参数应视为未验证,不要凭命名直觉猜测;已知内部参数(如 DescribeEnvs 的 EnvTypes)应标记为内部参数而非契约缺陷。契约修复需配套能在旧契约上失败的测试;严重但模糊时写报告并开 issue。通用代码异味审查和仅修 lint 的 PR 不在本技能范围。