Single tool with Chinese-language description and minimal English context. Tool name 'get_endpoint_oas_by_link' follows verb_noun pattern but description is 280+ chars in Chinese, making it inaccessible to most LLM agents trained on English. Input schema present with Zod validation (projectId, endpointId as numbers with descriptions), but output schema is undocumented, tool returns raw JSON without field documentation. Error handling is minimal (generic catch-all). No parameter constraints (enums, ranges, patterns). Tool lacks idempotency guarantees and does not document prerequisites or when to use it vs alternatives.
通过 Apifox 的协作链接来获取此接口的 OpenAPI Specification 格式定义,协作链接格式如下:https://app.apifox.com/link/project/{projectId}/apis/api-{endpointId} ,{projectId} 为 Apifox 的项目 ID,{endpointId} 为接口(Endpoint)的 ID,由于该链接是无法直接访问的,所以需要通过本工具来获取。如发现有符合条件的链接,则调用本工具
Description is entirely in Chinese (280+ chars). LLM agents trained primarily on English cannot parse intent or selection criteria. Violates pattern:tool-description requirement for LLM-optimized descriptions.
Output schema is completely undocumented. Tool returns JSON.stringify(file) with no field documentation. LLMs cannot plan downstream calls or extract required data (e.g., endpoint name, method, parameters). Violates pattern:tool requirement for documented return types.
Error handling is generic catch-all returning 'Error fetching file: {error}'. Does not categorize errors as retryable/user-fixable/fatal or provide recovery guidance. Violates pattern:recovery-guide.
No parameter constraints. projectId and endpointId accept any number with no range validation, format hints, or examples. LLMs may pass invalid IDs (negative, zero, absurdly large). Violates pattern:constrained-input.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 38 | 2026-07-28+ | v2 |
No idempotency guarantee documented. Tool calls external API with POST; unclear if repeated calls with same projectId/endpointId produce identical results or side effects. Violates pattern:idempotent-operation.