Menú
基于内嵌规则 的 Nuxt API Client 规范。用于生成/校对 api.ts 与 CRUD composable。
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Basado en la clasificación ocupacional SOC
生成功能使用指导文档（人性化、可执行、与代码实现对齐）。强制包含背景、流程图、泳道图、模块关系、页面/接口步骤、前后置依赖、验证与排障。
自动检查 contracts/capabilities 与 plugin.yaml/catalog（plugin.d）的同步对齐，适用于功能迭代后快速发现路由、RBAC、清单漂移问题。
FastAPI 后端配置加载规范（与 Gin 对齐）
FastAPI 后端入口技能，按需路由到配置与数据库/同步规范子技能。
Gin 后端配置加载规范
Gin 后端入口技能，按需路由到配置规范子技能。
| name | nuxt-api-client |
| description | 基于内嵌规则 的 Nuxt API Client 规范。用于生成/校对 api.ts 与 CRUD composable。 |
本文件内嵌规则。web-admin/plugins/api.ts 与 web-admin/composables/useTemplates.ts。web-admin/composables/api/index.ts 统一导出入口。apiGet/apiPost/apiPatch/apiPut/apiDel 与 useApiClient。$fetch，保持认证/租户头与错误处理一致。kind: ruleset
name: plugin/crud/frontend/nuxt_api_client
version: 1
client:
runtime_config:
public_keys:
apiBase: "NUXT_PUBLIC_API_BASE"
pluginId: "NUXT_PUBLIC_PLUGIN_ID"
powerxProxy: "NUXT_PUBLIC_POWERX_PROXY"
defaults:
apiBase: "/_p/<plugin-id>/api/v1"
powerxProxy: 1
files:
- target: web-admin/plugins/api.ts
template: builtin/nuxt_api_plugin_fetch
- target: web-admin/composables/useTemplates.ts
template: builtin/nuxt_composable_crud
params:
resource: "templates"
dto:
item: "TemplateItem"
create: "TemplateCreateReq"
update: "TemplateUpdateReq"
usage:
import: |
import { apiGet, apiPost, apiPatch, apiPut, apiDel, useApiClient } from "~/composables/api";
notes:
- 不要直接调用 $fetch；统一用 apiGet/apiPost/apiPatch/apiPut/apiDel 以附带认证/租户头并获得一致的错误处理。
- apiGet(path, query?, init?) / apiPost(path, body?, init?) 语义同 $fetch，body 默认自动 JSON.stringify，FormData 保持原样。
- useApiClient() 暴露 client/baseURL，如需底层访问请使用 client.raw。
- 页面/组件不要直接调用 apiGet/apiPost；按域封装 useXXX 组合式函数（参考 web-admin/app/composables/api/useTemplate.ts、useRss.ts），在 ~/composables/api/index.ts 暴露入口，统一类型/字段规范。
gates.require: [PG-FE-API-001]