# lumin-skill

**Repository Path**: xfcode-projects/lumin-skill

## Basic Information

- **Project Name**: lumin-skill
- **Description**: 专为  QClaw、OpenClaw 框架设计的技能聚合仓库，采用「单仓库多技v能」架构，将常用业务模块，封装为独立 Skill，统一规范、统一维护、批量扩展。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: https://www.xfcode.com
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-13
- **Last Updated**: 2026-05-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<!-- xfcode.com -->

# 🚀 lumin-skill - AI Agent 聚合技能仓库

> **呦呦鹿鸣，食野之苹。我有嘉宾，鼓瑟吹笙—— xfcode.com**

---

## 作者声明

目前龙虾对技能调用不稳定，所有优先小技能训练，稳定后会完善该项目。过程详见：
🌐 Gitee: [https://gitee.com/xfcode-ai](https://gitee.com/xfcode-ai)

## 💡 项目简介

**lumin-skill** 是一款专为 **QClaw、KsClaw、Lumin** 框架设计的技能聚合仓库，采用「单仓库多技能」架构，将常用业务模块（用户中心、CMS内容管理等）封装为独立 Skill，统一规范、统一维护、批量扩展。

区别于单个 Skill 单独建仓库的繁琐模式，本项目将多个高频使用的业务 Skill 聚合在同一仓库下，依托框架的递归扫描特性，用户下载后只需简单部署，即可让框架自动识别所有内置 Skill，无需额外配置，大幅提升开发效率。

本项目所有 Skill 均遵循 QClaw/KsClaw/Lumin 框架规范，支持本地部署、二次开发、私有技能库搭建，适用于个人开发者、团队协作场景，可快速复用业务模块，减少重复开发工作。

### ✨ 核心优势

- ✅ **原生兼容**：完美适配 QClaw、KsClaw、Lumin 所有主流版本，无需修改代码
- ✅ **自动加载**：框架递归扫描子目录，识别所有含 SKILL.md 的子 Skill，无需手动注册
- ✅ **统一规范**：所有 Skill 遵循统一的输入输出、命名、格式规范，便于维护和扩展
- ✅ **灵活扩展**：支持新增、修改、删除 Skill，支持二次开发自定义业务逻辑
- ✅ **轻量化**：无多余依赖，仅保留核心技能逻辑，部署简单、占用资源少
- ✅ **多场景适配**：支持本地开发、团队共享、私有技能库搭建，适配个人和企业需求

---

## 📂 目录结构

```
lumin-skill/
├── README.md               # 项目说明、使用文档（当前文件）
├── LICENSE                 # 开源协议（Apache 2.0）
├── user-skill/             # 用户中心Skill（核心业务模块）
│   └── SKILL.md            # 技能详细说明、输入输出规范
└── cms-skill/              # CMS内容管理Skill（核心业务模块）
    └── SKILL.md            # 技能详细说明、输入输出规范
```

> 💡 **提示**：可无限新增业务 Skill（如订单 Skill、权限 Skill 等），只需新增「xxx-skill」子目录并创建 SKILL.md 即可，框架自动识别。

---

## 📥 使用方式（超简单）

### 1️⃣ 克隆/下载本项目

**方式 1**：Git 克隆
```bash
git clone https://gitee.com/xfcode-ai/lumin-skill.git
```

**方式 2**：下载 ZIP 压缩包
- 在 Gitee/GitHub 页面下载 ZIP 压缩包
- 解压得到 `lumin-skill` 文件夹

### 2️⃣ 部署到框架

将整个 `lumin-skill` 文件夹复制到 QClaw/KsClaw/Lumin 框架根目录下的 `skills` 文件夹中

### 3️⃣ 重启框架

重启 QClaw/KsClaw/Lumin，框架会自动递归扫描 lumin-skill 下的所有子 Skill，加载完成后即可直接使用

> ⚠️ **注意**：若加载失败，检查两点：
> 1. 子目录命名是否为「xxx-skill」格式
> 2. 每个子目录下是否有且仅有 1 个 SKILL.md 文件

---

## 🎯 内置 Skill 详情

### 1. user-skill（用户中心 Skill）

**核心功能**：封装用户全流程业务逻辑，适配各类系统的用户管理需求，无需重复开发登录、注册等基础功能。

#### 功能清单

- 🔐 **用户注册**：接收用户信息，完成注册校验、数据入库
- 🔑 **用户登录**：接收账号密码，完成身份校验、token 生成与返回
- 👤 **用户信息管理**：查询、修改、删除用户基本信息
- 🛡️ **角色权限关联**：简单角色分配、权限校验（适配基础权限场景）
- 🔄 **密码重置**：支持手机号/邮箱验证重置密码

#### 输入规范

| 操作类型 | 必填参数 | 可选参数 |
|---------|---------|----------|
| register（注册） | username, password | phone, email |
| login（登录） | username, password | - |
| update（修改信息） | userId | username, phone, email |
| delete（删除用户） | userId | - |
| resetPwd（重置密码） | username, newPassword, verifyCode | - |

#### 输出规范

- **统一返回格式**：`{"code": 200, "msg": "操作成功", "data": {...}}`
- **登录成功**：返回 token、userId、username
- **注册/修改/删除成功**：返回操作结果提示，无多余冗余数据
- **失败返回**：对应错误码、错误提示（如用户名已存在、密码错误等）

---

### 2. cms-skill（CMS 内容管理 Skill）

**核心功能**：封装 CMS 内容管理全流程逻辑，适配博客、官网、小程序等各类内容展示场景，快速实现文章、栏目、标签的管理功能。

#### 功能清单

- 📁 **栏目管理**：栏目新增、修改、删除、查询（支持多级栏目）
- 📝 **文章管理**：文章新增、编辑、删除、查询、分页、置顶、下架
- 🏷️ **标签管理**：标签新增、删除、关联文章、查询
- 🔍 **内容检索**：根据标题、关键词、栏目 ID 检索文章
- 📋 **草稿管理**：文章草稿保存、编辑、提交发布

#### 输入规范

| 操作类型 | 主要参数 |
|---------|----------|
| column（栏目操作） | operateType(add/edit/delete/query), columnName, parentId(可选), sort(可选) |
| article（文章操作） | operateType(add/edit/delete/query/draft), title, columnId, content, tags(可选), isTop(可选), status(可选) |
| tag（标签操作） | operateType(add/delete/query), tagName, articleId(可选) |
| search（内容检索） | keyword(可选), columnId(可选), pageNum, pageSize |

#### 输出规范

- **统一返回格式**：`{"code": 200, "msg": "操作成功", "data": {...}}`
- **查询/检索输出**：返回分页数据（total、list）、栏目/文章/标签完整信息
- **新增/编辑/删除输出**：返回操作结果提示、操作 ID
- **失败返回**：对应错误码、错误提示（如栏目不存在、文章标题不能为空等）

---

## 🚀 扩展建议

1. **新增 Skill**：按照「xxx-skill」目录格式，新增子目录并创建 SKILL.md（参考内置两个 Skill 的格式），框架自动识别
2. **二次开发**：可修改现有 Skill 的输入输出规范、业务逻辑，适配自身项目需求
3. **问题反馈**：若使用过程中出现加载失败、功能异常等问题，欢迎提交 Issue 反馈

---

## 📜 开源协议

本项目采用 **Apache 2.0** 开源协议，允许个人和企业自由使用、修改、分发，无需额外授权，详情见 [LICENSE](LICENSE) 文件。

---

## 📞 联系作者

📧 Email: xfcode@126.com