Agent skill · software engineering · aiskillstore
darkit-gin
基于 gin-gonic/gin 的企业级 Web 框架增强版，提供开箱即用的 JWT 认证、SSE 实时通信、缓存管理、OpenAPI 文档生成等企业级功能。涵盖选项式路由配置、统一响应格式、中间件管理、安全加固、性能优化等完整开发能力。
Why this skill is useful
Adds executable scripts for JWT authentication, SSE real-time communication, and OpenAPI documentation generation that aren't in public docs.
What it needs
Requires go installed locally. About 5k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
Darkit Gin Framework 技能 适用场景 构建企业级 RESTful API 服务 需要快速集成 JWT 认证和授权系统 实现服务器发送事件（SSE）实时通信 自动生成 OpenAPI 3.0 规范和 Swagger UI 需要内置缓存系统提升性能 要求统一的 API 响应格式 从 gin-gonic/gin 迁移并增强功能 操作流程 1. 快速开始 2. 定义路由 3. 便捷响应方法 4. JWT 认证 5. SSE 实时通信 6. 缓存系统 7. OpenAPI 文档 使用示例 完整 RESTful API 示例 指导原则 架构设计 选项式配置优先：使用 gin.NewRouter() 配合 gin.WithXXX() 选项进行链式配置 统一响应格式：始终使用 Success()、Fail()、NotFound() 等便捷方法 分层架构：遵循 Handler → Service → Repository 分层模式 接口抽象：业务逻辑依赖接口而非具体实现 安全实践 JWT 密钥管理：从环境变量读取，不要硬编码 CORS 配置：生产环境明确指定允许的域名 输入验证：使用 binding 标签自动验证，结合 c.BindJSON() 敏感信息过滤：启用 SecurityConfig.SensitiveFilter 安全头：使用 c.SetSecureHeaders() 设置安全响应头 性能优化 缓存策略：对热点数据使用缓存，设置合理的 TTL 连接池：配置数据库连接池参数（MaxOpenConns、MaxIdleConns） 并发处理：使用 goroutine 并行获取独立数据 分页限制：限制最大分页大小（如 100） Context 超时：使用 gin.WithTimeout() 设置全局超时 错误处理 统一错误响应：使用框架提供的错误响应方法 定义业务错误：创建自定义错误类型 错误日志记录：记录详细错误信息，返回用户友好消息 错误包装：使用 fmt.Errorf("...: %w", err) 包装错误 测试策略 单元测试：测试业务逻辑和数据访问层 集成测试：使用 httptest 测试 HTTP 处理器 Mock 依赖：使用接口进行依赖注入，便于测试 常见陷阱 配置问题 ❌ 硬编码配置：不要在代码中硬编码密钥、URL 等配置 ❌ 通配符 CORS：生产环境不要使用 "" 允许所有域名 响应格式 ❌ 不统一的响应格式：直接使用 c.JSON() 导致格式不一致 错误处理 ❌ 忽略错误：不处理或忽略错误返回值 ❌ 泄露敏感信息：直接返回数据库错误给用户 JWT 使用 ❌ 不设置过期时间：JWT 令牌应设置合理的过期时间 ❌ 未验证 JWT：受保护的路由忘记添加认证中间件 缓存使用 ❌ 缓存键冲突：使用简单的键名导致冲突 ❌ 忘记清除缓存：更新或删除数据后忘记清除缓存 并发安全 ❌ 共享变量无保护：多个 goroutine 访问共享变量未加锁 资源导航 核心特性 Quick Start Guide - 快速开始和基础配置 Router Configuration - 路由器配置选项详解 Response Methods - 统一响应方法详解 Middleware Guide - 中间件使用指南 认证授权 JWT Authentication - JWT 认证完整指南 OAuth 2.0 System - OAuth 2.0 认证系统 Role-Based Access - 基于角色的访问控制 高级特性 SSE Real-time - 服务器发送事件 Cache System - 缓存系统详解 OpenAPI Documentation - OpenAPI 文档生成 Static Resources - 静态资源和文件系统 安全和性能 Security Hardening - 安全加固指南 Performance Optimization - 性能优化技巧 Production Deployment - 生产环境部署 最佳实践 Project Structure - 推荐的项目结构 Error Handling - 错误处理模式 Testing Strategies - 测试策略和实践 Migration Guide - 从 gin-gonic/gin 迁移 完整示例 Complete Examples - 生产级应用示例 API Reference - 完整 API 速查表 相关技能 golang-web-development - Go Web 开发基础 golang-database - 数据库操作和 ORM golang-testing - 测试驱动开发 golang-security - Go 应用安全实 …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/darkit-gin