Menú
De forma predeterminada está seleccionado el prompt que primero revisa el origen. Puedes cambiar a un comando directo o descargar una copia local.
Lee SKILL.md y los archivos complementarios que muestra SkillsMP antes de decidir si quieres instalarlo.
Basado en la clasificación ocupacional SOC
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.
Un comando directo omite el prompt de revisión. Revisa el origen antes de ejecutarlo.
npx skills add https://github.com/ArtisanCloud/PowerXPlugin --skill crud-api-restEl comando permanece en una sola línea. Desplázate horizontalmente para revisarlo antes de copiarlo.
¿Prefieres una copia local? Descarga los archivos que SkillsMP tiene disponibles ahora.
Mostrando SKILL.md
管理 PowerXPlugin 的基础模板对象。该对象仅包含标题、描述和内容，用于开发者验证插件侧 CRUD、能力注册和 Agent 调用链路。
生成功能使用指导文档（人性化、可执行、与代码实现对齐）。强制包含背景、流程图、泳道图、模块关系、页面/接口步骤、前后置依赖、验证与排障。
自动检查 contracts/capabilities 与 plugin.yaml/catalog（plugin.d）的同步对齐，适用于功能迭代后快速发现路由、RBAC、清单漂移问题。
| name | crud-api-rest |
| description | 基于内嵌规则 的 REST 约定。用于检查 CRUD 路由集、响应封装与路由注册。 |
本文件内嵌规则。backend/internal/transport/http/** 保证 REST 路由完整。routes.go 与聚合 router 中注册路由。contracts.Response*。/api/v1 入口。# HTTP Envelope & REST 约定
kind: ruleset
id: crud_api_rest
version: 1.0.0
exports:
envelope:
success: boolean
message: string | null
data: object | array | null
error:
code: string
message: string
details: object | array | string | null
timestamp: string
request_id: string | null
page:
items: array
total: integer
page: integer
page_size: integer
checks:
- id: rest-methods
desc: 资源具备 GET/GET:id/POST/PUT/DELETE 的最小集合
assert:
type: route
target: backend/internal/transport/http/**
route_set:
- GET /api/v1/{resource}
- GET /api/v1/{resource}/:id
- POST /api/v1/{resource}
- PUT /api/v1/{resource}/:id
- DELETE /api/v1/{resource}/:id
- id: api-rest-validate
desc: 写接口必须有参数验证
assert:
type: grep
target: backend/internal/transport/http/**
pattern:
- binding:"
- id: api-rest-response
desc: 返回统一使用 contracts.ResponseXXX 辅助方法
assert:
type: grep
target: backend/internal/transport/http/**
pattern:
- "contracts.Response"
- id: api-rest-route-register
desc: CRUD 资源实现后必须在对应 routes.go 中注册到 HTTP 路由树，确保 /api/v1 下的入口可被访问
assert:
type: manual
instructions: |
为新增的 CRUD 模块确认：
1) 在所属模块的 routes.go 中声明 HTTP group 与 GET/POST/PUT/DELETE handlers；
2) 在 admin/tenant 等聚合 routers（例如 backend/internal/transport/http/admin/routes.go）里引入并调用 RegisterRoutes;
3) 若存在多租户/平台区分，分别在需要的 router group 中挂载，避免出现 404。