Agent Skills
› mx-space/core
mx-space/core
GitHub定义 MX Space API 设计规范，涵盖控制器装饰器、认证、响应转换、分页及参数校验等标准。指导开发者编写符合规范的 HTTP 接口与控制器代码。
Install All Skills
npx skills add mx-space/core --all -g -y
Skills in Collection (11)
定义 MX Space API 设计规范，涵盖控制器装饰器、认证、响应转换、分页及参数校验等标准。指导开发者编写符合规范的 HTTP 接口与控制器代码。
编写 API 控制器或端点
处理 HTTP 请求逻辑
设计 RESTful 接口规范
npx skills add mx-space/core --skill api-conventions -g -y
用于为指定模块创建测试文件，涵盖单元测试和E2E测试两种模式。提供NestJS控制器、服务及仓储的测试模板与路径规范，支持依赖Mock及完整HTTP管道测试。
需要为控制器或服务添加单元测试
需要为模块编写端到端(E2E)测试
npx skills add mx-space/core --skill create-e2e-test -g -y
用于在 NestJS 项目中快速创建包含控制器、服务、仓储及 Drizzle 数据库表定义的新模块，支持 PostgreSQL 和 Zod 校验。
需要新增业务功能模块
添加新的 API 端点
扩展业务领域模型
npx skills add mx-space/core --skill create-module -g -y
在本地开发环境中，当UI或API验证遇到登录门控时，通过操作PostgreSQL数据库创建临时的所有者会话以绕过认证，并在验证完成后立即清理。
UI或API验证遇到401或AUTH_NOT_LOGGED_IN响应
需要绕过本地开发环境的登录门控进行功能测试
npx skills add mx-space/core --skill mx-core-local-auth -g -y
用于验证和修复 MongoDB 迁移至 PostgreSQL 后的 Controller，确保数据完整性、字段映射及下游 SDK/前端同步。
校验 controller
check controller
迁移 controller
修复迁移后的接口
data missing after PG migration
npx skills add mx-space/core --skill mx-pg-controller-migration -g -y
针对 MX Space 项目的代码审查技能，依据 NestJS、Drizzle ORM、Zod 等规范检查控制器、服务、仓库及 API 设计。
需要检查代码是否符合项目规范
进行代码质量审查
npx skills add mx-space/core --skill mx-review -g -y
提供 mxs CLI 工具进行内容管理的自动化能力，涵盖起草、验证、发布及配置等操作。通过标准化工作流与安全规则，确保对 mx-core 内容的读写操作准确无误且符合安全规范。
用户需要通过命令行创建或编辑内容
用户需要批量发布、更新或删除内容
用户需要验证内容状态或执行安全审计
npx skills add mx-space/core --skill mxs-cli-ai-author -g -y
用于 mx-core 系列软件（服务端、API客户端、CLI）的版本发布流程，涵盖版本递增、变更日志生成、Git标签创建、Docker构建及部署自动化。
发版
release a new version
cut a release
bump version
publish api-client
publish cli
release mxs
npx skills add mx-space/core --skill release-core -g -y
用于执行项目测试的 Skill，支持全量、单文件、模式匹配及 Watch 模式运行测试，涵盖单元测试与 E2E 测试场景。
需要运行所有测试时
指定特定文件或测试用例名称运行时
进入测试监听模式时
npx skills add mx-space/core --skill run-test -g -y
提供 MX Space 项目的 Zod Schema 模式与自定义验证器，用于创建 DTO、定义数据校验规则及处理请求参数验证。
需要定义 API 输入输出数据的校验规则
创建或修改 DTO 类
使用项目统一的自定义 Zod 验证器
npx skills add mx-space/core --skill zod-patterns -g -y
用于安全编写和审查Drizzle SQL迁移，确保在滚动部署期间新旧代码兼容。通过扩展-收缩模式处理表结构变更，防止因并发请求导致的服务中断或数据错误。
编辑 schema 或 migrations 文件
运行 drizzle-kit generate
执行 lint-migrations 检查
用户提示进行迁移、改 schema、添加或删除列
npx skills add mx-space/core --skill mx-migration-author -g -y
