From cloudbase-ai-toolkit
Audits CloudBase cloud API wrappers, MCP tools, and generated action metadata for outdated or incorrect action names, parameters, casing, request shapes, or missing contract tests.
How this skill is triggered — by the user, by Claude, or both
Slash command
/cloudbase-ai-toolkit:api-contract-reviewThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Review CloudBase cloud API integrations for contract correctness before the repository ships stale, guessed, or undocumented behavior.
Review CloudBase cloud API integrations for contract correctness before the repository ships stale, guessed, or undocumented behavior.
Use this skill when you need to:
Do NOT use for:
references/review-checklist.md first.mcp/src/tools/*Before judging any implementation, you must read the relevant official documentation first.
Required entry points:
https://cloud.tencent.com/document/product/876/34809https://cloud.tencent.com/document/product/876/34808https://docs.cloudbase.net/api-reference/manager/node/introductionVerify the documented contract, not your memory:
If the docs do not clearly support the action, parameter, or behavior, treat the implementation as unverified and stop short of guessing.
Some parameters are internal to Tencent Cloud and not publicly documented. These parameters are valid but will not appear in the official API documentation.
Known internal parameters:
EnvTypes in DescribeEnvs — filters environments by type (e.g., ["weda", "baas"]). This parameter is not in the public documentation but is accepted by the backend.When you encounter a parameter that:
Mark it as an internal parameter in your review report, not as a contract bug.
Some parameters are internal to Tencent Cloud and not publicly documented. These parameters are valid but will not appear in the official API documentation.
Known internal parameters:
EnvTypes in DescribeEnvs — filters environments by type (e.g., ["weda", "baas"]). This parameter is not in the public documentation but is accepted by the backend.When you encounter a parameter that:
Mark it as an internal parameter in your review report, not as a contract bug.
codebase-audit. Route open-PR repair work to pr-review-fix after the contract finding is confirmed.| Task | Read |
|---|---|
| Review CloudBase API contract correctness | references/review-checklist.md |
| Run a broad code audit after contract review | codebase-audit |
| Repair an already-open PR after confirming the contract fix | pr-review-fix |
mcp/src/tools for CloudBase API actions whose parameter casing or nesting no longer matches the official docs.npx claudepluginhub tencentcloudbase/cloudbase-mcpDesign and review API contracts covering auth, pagination, versioning, errors, compatibility, and OpenAPI/GraphQL shape. Steps through evidence gathering, boundary definition, compatibility checks, semantics validation, and test planning.
Reviews API contracts (OpenAPI/AsyncAPI/GraphQL/gRPC/WebSocket/SSE/Webhook/SDK/IPC-CLI) against PRD for baseline alignment, completeness, consistency, conflicts, and compatibility before HLD/LLD/implementation.
Detects breaking changes in REST, GraphQL, and gRPC API contracts. Compares OpenAPI schemas and protobuf defs to baselines, classifies severity, validates semver, runs Pact tests, generates reports.