# skills-hub

**Repository Path**: java-and-net/skills-hub

## Basic Information

- **Project Name**: skills-hub
- **Description**: 易开元团队项目开发Skills集合。
- **Primary Language**: 其他
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-10
- **Last Updated**: 2026-03-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Skills Hub

[![Gitee](https://img.shields.io/badge/Gitee-java--and--net-blue)](https://gitee.com/java-and-net/skills-hub)

一个面向 Codex/Agent 场景的本地技能仓库，当前主要收录 Topsky 酒店管理系统相关的前后端专项技能。

## 仓库定位

这个仓库不是业务系统源码仓库，而是一个 `skills/` 集合仓库。  
每个技能都以 `SKILL.md` 为入口，并按需配套：

- `references/`：补充约定、架构说明、工作流文档
- `scripts/`：辅助脚本
- `agents/`：Agent 平台展示与默认提示配置

这些技能的目标，是让 Codex 在进入具体项目后，优先遵循目标仓库已有的架构、命名、验证方式和交付流程，而不是临时生成一套新风格。

## 当前收录技能

### 1. `topsky-backend-developer`

用于 Topsky 酒店管理系统 ASP.NET Core 后端开发，覆盖：

- Controller 风格 Web API
- Contract DTO、Service、Domain、Data 分层协作
- SqlSugar 数据访问
- 权限、并发控制、软删除、Quartz 任务等既有模式

技能入口：

```text
skills/topsky-backend-developer/SKILL.md
```

配套参考文档：

- `references/architecture.md`
- `references/patterns.md`
- `references/workflow.md`

### 2. `topsky-frontend-developer`

用于 Topsky 酒店管理系统 Vue 3 前端开发，覆盖：

- Vue 3 + `script setup`
- Ant Design Vue 页面改造
- API 封装、实体定义、筛选器配置的既有组织方式
- 变更后的格式化、语法检查与变更报告输出

技能入口：

```text
skills/topsky-frontend-developer/SKILL.md
```

配套内容：

- `references/project-conventions.md`
- `scripts/generate-change-report.ps1`
- `agents/openai.yaml`

## 目录结构

```text
skills-hub/
|- skills/
|  |- topsky-backend-developer/
|  |  |- agents/
|  |  |- references/
|  |  `- SKILL.md
|  `- topsky-frontend-developer/
|     |- agents/
|     |- references/
|     |- scripts/
|     `- SKILL.md
|- README.md
|- README.en.md
`- LICENSE
```

## 使用方式

当你的 Agent/Codex 环境支持本地技能发现时，可直接引用技能名触发对应工作流，例如：

```text
$topsky-backend-developer
$topsky-frontend-developer
```

典型使用场景：

- 需要在 Topsky ASP.NET Core 后端仓库中新增或修改接口
- 需要在 Topsky Vue 3 前端仓库中修改页面、接口调用或筛选配置
- 需要先审查现有实现模式，再按仓库约定完成改动和验证

## 适用特点

与通用提示词相比，这个仓库中的技能更强调：

- 先审查现有代码，再动手修改
- 尽量复用目标仓库的实现模式
- 用最小、连贯的 diff 完成变更
- 在结束前完成必要的格式化、检查和交付说明

## 维护说明

新增技能时，建议保持以下结构：

```text
<skill-name>/
|- SKILL.md
|- references/
|- scripts/
`- agents/
```

其中 `SKILL.md` 负责定义入口说明、工作流、约束和验证要求；其余目录按需要提供支撑材料即可。

## 许可证

本仓库基于 [MIT License](LICENSE) 发布。