genies-hub

النجوم١

التفرعات٠

آخر تحديث١ يوليو ٢٠٢٦ في ١٤:٤٧

Genies framework unified skill hub. Use when you need to find the right skill for any Genies framework task, including authentication, authorization, caching, configuration, database, DDD microservices, Dapr messaging, macros, K8s deployment, testing, API conventions, gateway proxy, or Salvo web framework features. Also use when the user asks about Genies framework capabilities, asks which skill to use, or wants a quick overview of available Genies skills.

التثبيت

التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.

المصدر

tdcare

tdcare/genies

فتح مستودع GitHub عرض مستودعات المنشئ

تنزيل

المهن ذات الصلةSOC

استنادا إلى تصنيف SOC المهني

المهن الحاسوبية الأخرىمهن الحاسوب والرياضيات·SOC 15-1299

SKILL.md

readonly

المزيد من هذا المستودع

نفس المستودع

rbatis-usage

tdcare/genies

Guide for using RBatis v4 Rust ORM framework. Use when implementing database CRUD operations, writing dynamic SQL with py_sql or html_sql macros, configuring database connections, managing transactions, implementing interceptors, syncing table structures, or integrating RBatis into Genies microservices. Also use when the user asks about RBatis usage patterns, query building, or database operations in Rust.

2026-07-291

api-conventions

tdcare/genies

Genies 前后端接口规范。Use when designing API contracts, defining field naming conventions, date/time formats, response models, pagination, error handling, or ID strategies between Genies backend and frontend (Web/Android/OHOS).

2026-07-011

flyway-usage

tdcare/genies

Guide for using flyway-rs database migration framework with RBatis. Use when implementing database schema migrations, managing SQL changelog files, configuring migration runners, handling multi-database migrations, or integrating database versioning into Genies microservices.

2026-07-011

genies-ddd-microservice

tdcare/genies

Guide for developing Rust microservices using Genies framework following Java DDD layering principles. Use when creating new microservices, designing aggregate roots, implementing domain events, organizing service layers, setting up Flyway migrations, or structuring a DDD-based Genies project.

2026-07-011

genies-usage

tdcare/genies

Guide for using the Genies Rust microservice framework with DDD and Dapr. Use when developing with Genies, creating aggregates, domain events, Dapr subscriptions, Casbin field-level permissions, configuration management, or when the user asks about Genies framework usage patterns.

2026-07-011

salvo-openapi

tdcare/genies

Generate OpenAPI documentation automatically from Salvo handlers. Use for API documentation, Swagger UI, and API client generation.

2026-07-011

name

genies-hub

description

Genies 框架统一 Skill 入口

概述

本文件是 Genies 框架的 统一 Skill 入口，所有 Skill 按功能域分类，按需加载。当你不确定该使用哪个 Skill 时，从此处查找即可。

Genies 框架核心 Skill

认证与权限

Skill	说明	加载场景
`auth-usage`	genies_auth 权限与认证模块	Casbin RBAC、JWT中间件、`#[casbin]`宏、字段级权限过滤、事件驱动同步
`auth-admin-usage`	统一认证管理后台	用户/角色/权限/部门/应用CRUD、OAuth 2.0、JWT认证、Dapr事件发布

数据存储与迁移

Skill	说明	加载场景
`rbatis-usage`	RBatis v4 ORM框架	动态SQL、py_sql/html_sql宏、事务、拦截器、多数据库驱动工厂
`flyway-usage`	flyway-rs 数据库迁移	运行时SQL迁移、多数据库支持、MigrationRunner
`context-usage`	应用上下文管理	全局CONTEXT单例、多数据库连接池、缓存服务、JWT中间件集成

缓存

Skill	说明	加载场景
`cache-usage`	双后端缓存服务	Redis/Memory双后端、ICacheService trait、TTL、原子操作

配置管理

Skill	说明	加载场景
`config-usage`	配置管理	YAML配置加载、`#[derive(Config)]`宏、ApplicationConfig

微服务与消息

Skill	说明	加载场景
`dapr-usage`	Dapr集成	pub/sub消息、CloudEvent解析、`#[topic]`宏、自动topic订阅
`ddd-usage`	DDD基础库	聚合根模式、领域事件、Outbox模式、事件发布

响应与错误处理

Skill	说明	加载场景
`core-usage`	响应模型/错误处理/JWT	RespVO/ResultDTO双响应模型、Salvo Writer集成、Keycloak JWT验证

宏与代码生成

Skill	说明	加载场景
`derive-usage`	过程宏集合	Aggregate、DomainEvent、Config、ConfigCore、topic、remote、casbin宏

K8s部署

Skill	说明	加载场景
`k8s-usage`	K8s健康探针	liveness/readiness端点、SERVICE_STATUS全局状态

测试

Skill	说明	加载场景
`test-usage`	对比测试基础设施	Java/Rust API对比测试、数据库快照/diff/restore、Deep JSON Diff

框架总览与工程规范

Skill	说明	加载场景
`genies-usage`	框架整体使用指南	框架全貌、DDD+Dapr集成、各crate协同、完整配置
`genies-ddd-microservice`	DDD微服务开发指南	Java DDD四层→Rust映射、聚合根设计、项目结构、迁移指南
`api-conventions`	前后端接口规范	字段命名、日期格式、响应模型、分页、错误处理、ID策略
`gateway-dev-proxy`	Gateway/Proxy开发代理	nginx反向代理、servlet_path路由分发、本地开发环境配置

Salvo Web 框架 Skill

Web 基础

Skill	说明	加载场景
`salvo-basic-app`	基础应用	Handler/Router/Server 创建
`salvo-routing`	路由配置	路径参数、嵌套路由、过滤器
`salvo-path-syntax`	路径参数语法	`{}` vs 已弃用的 `<>` 语法
`salvo-middleware`	中间件	Hoop/FlowCtrl 实现
`salvo-error-handling`	错误处理	自定义错误类型、状态码

数据与文件

Skill	说明	加载场景
`salvo-data-extraction`	数据提取	JSON/Form/Query/Path 参数提取
`salvo-database`	数据库集成	SQLx/Diesel/SeaORM
`salvo-static-files`	静态文件	CSS/JS/图片/下载文件服务
`salvo-file-handling`	文件处理	上传/下载/Multipart

安全

Skill	说明	加载场景
`salvo-auth`	认证授权	JWT/Basic Auth
`salvo-cors`	CORS	跨域配置
`salvo-csrf`	CSRF防护	Cookie/Session CSRF
`salvo-rate-limiter`	限流	API限流/DDoS防护
`salvo-session`	会话管理	Session 状态持久化
`salvo-tls-acme`	TLS/HTTPS	ACME自动证书管理

性能

Skill	说明	加载场景
`salvo-compression`	响应压缩	gzip/brotli/zstd/deflate
`salvo-caching`	缓存策略	Cache-Control/ETag
`salvo-concurrency-limiter`	并发限制	并发请求限制
`salvo-timeout`	请求超时	超时配置

运维

Skill	说明	加载场景
`salvo-logging`	日志/Tracing	请求日志、可观测性
`salvo-graceful-shutdown`	优雅关闭	零停机部署

高级功能

Skill	说明	加载场景
`salvo-proxy`	反向代理	负载均衡/API网关
`salvo-openapi`	OpenAPI文档	`#[endpoint]`宏自动生成OpenAPI 3.0
`salvo-testing`	测试工具	TestClient 测试
`salvo-flash`	Flash消息	一次性通知

实时通信

Skill	说明	加载场景
`salvo-realtime`	实时通信概览	WebSocket vs SSE 选型
`salvo-websocket`	WebSocket	双向通信
`salvo-sse`	SSE	服务端推送

按需加载指南

快速决策表——根据开发场景查找推荐 Skill：

开发场景	推荐加载的 Skill
新建微服务	`genies-ddd-microservice`, `genies-usage`, `config-usage`, `context-usage`
添加认证/权限	`auth-usage`, `auth-admin-usage`, `derive-usage` (casbin宏)
数据库操作	`rbatis-usage`, `flyway-usage`, `context-usage`
添加缓存	`cache-usage`
Dapr消息通信	`dapr-usage`, `derive-usage` (topic宏)
API开发	`core-usage`, `api-conventions`, `salvo-routing`, `salvo-data-extraction`
前后端联调	`api-conventions`, `gateway-dev-proxy`
测试	`test-usage`, `salvo-testing`
K8s部署	`k8s-usage`, `config-usage`
性能优化	`cache-usage`, `salvo-compression`, `salvo-caching`
实时通信	`salvo-realtime`, `salvo-websocket`, `salvo-sse`

辅助参考文件

以下 Skill 附带了额外的深度参考文档：

Skill	参考文件	说明
`auth-usage`	`reference.md` (56KB)	详细技术参考
`genies-usage`	`reference.md` (30KB)	完整配置项表
`genies-ddd-microservice`	`migration-guide.md` (96KB)	Java→Rust 迁移指南
`genies-ddd-microservice`	`reference.md` (16KB)	快速 API 参考
`rbatis-usage`	`genies-patterns.md` (5KB)	Genies 多数据库驱动工厂模式