# openkylin-skills

**Repository Path**: openkylin/openkylin-skills

## Basic Information

- **Project Name**: openkylin-skills
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 10
- **Created**: 2026-04-23
- **Last Updated**: 2026-10-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# openKylin Skills 仓库

用于存放 openKylin 社区相关的技能（Skill）文档和工具，供 AI Agent 自动化执行各类任务。

---

## 📁 目录结构

```
openkylin-skills/
├── README.md                          # 本文件
├── install.sh                         # 一键安装脚本
├── skills/                            # 技能目录
│   ├── ukui/                          # UKUI 桌面环境技能集
│   │   └── README.md                  # UKUI 技能索引
│   ├── linux-generic/                 # Linux 通用技能集
│   │   └── README.md                  # Linux 技能索引
│   ├── devops/                        # 开发运维技能集
│   │   └── README.md                  # DevOps 技能索引
│   ├── community/                     # 社区贡献技能集
│   │   ├── proposed-monitor/          # PROPOSED 分支监控技能
│   │   │   ├── SKILL.md               # 技能说明（主文件）
│   │   │   ├── config.json            # 配置参数
│   │   │   └── references/            # 参考资料
│   │   │       └── record_template.md
│   │   └── README.md                  # 社区技能索引
│   ├── ai/                            # AI/LLM 相关技能集
│   │   └── README.md                  # AI 技能索引
│   └── domain/                        # 特定领域技能集
│       └── README.md                  # 领域技能索引
└── docs/                              # 文档
    ├── how-to-add-skill.md            # 如何添加新技能
    └── UKUI接口技能规划.md             # UKUI 接口技能规划文档
```

---

## 🛠️ 已有技能

### UKUI 桌面环境控制
详见 [UKUI 技能集](skills/ukui/README.md)

| 分类 | 技能数量 | 主要功能 |
|------|----------|----------|
| 设备控制 | 5 | 亮度、音量、WiFi、蓝牙、电源模式 |
| UI 个性化 | 4 | 主题、壁纸、任务栏、字体 |
| 系统操作 | 2 | 快速启动、会话管理 |
| 文件能力 | 3 | 截屏、录屏、文件搜索 |
| 通知提醒 | 1 | 桌面通知 |
| 应用管理 | 1 | 应用查询与自启动管理 |

### 社区贡献技能
详见 [社区技能集](skills/community/README.md)

| 分类 | 技能数量 | 主要功能 |
|------|----------|----------|
| 分支监控 | 1 | PROPOSED 分支变更监控 |

### 内容创作技能
详见 [领域技能集](skills/domain/README.md)

| 技能名称 | 功能描述 | 状态 |
|----------|----------|------|
| `openkylin-cover` | 公众号封面图生成 | ✅ 已完成 |
| `domain-mpwriter` | 公众号文章创作与优化 | ✅ 已完成 |
| `ai-musecard` | 情绪金句插画卡片生成（风语绘） | ✅ 已完成 |
| `ai-gridtale` | 宫格手绘故事图生成（格语） | ✅ 已完成 |
| `ai-imgmuse` | AI 绘图 Prompt 生成器（图片姬） | ✅ 已完成 |
| `ai-agnespaint` | AI 图片/视频生成（Agnes画影） | ✅ 已完成 |

### 自我探索技能
| 技能名称 | 功能描述 | 状态 |
|----------|----------|------|
| `ai-selfdiscovery` | 自我探索梳理（见自己） | ✅ 已完成 |
| `ai-queshadow` | AI 视频分镜脚本生成（雀影） | ✅ 已完成 |
| `ai-vomicgen` | 动态漫画分镜脚本生成（雀漫） | ✅ 已完成 |

### 投资理财技能
| 技能名称 | 功能描述 | 状态 |
|----------|----------|------|
| `domain-market-dawn` | 全时段股市资讯生成（破晓） | ✅ 已完成 |

### 办公自动化技能
| 技能名称 | 功能描述 | 状态 |
|----------|----------|------|
| `office-batch-to-pdf` | 办公文档批量转PDF（Word/Excel/PPT转PDF） | ✅ 已完成 |

### Linux 通用技能
| 技能名称 | 功能描述 | 状态 |
|----------|----------|------|
| `linux-browser-control` | 浏览器自动化控制（截图、读取、JS 执行） | ✅ 已完成 |
| `linux-blaze-fan` | EC 风扇调速（炽风）——探接口、定方案、指数曲线控温 | ✅ 已完成 |
| `linux-capture-injection-probe` | Linux 截图/注入通道探测（Wayland/X11、grim/wtype/ydotool） | ✅ 已完成 |
| `linux-session-health-check` | 无人值守桌面会话健康门禁（活性/锁屏判定、失活恢复） | ✅ 已完成 |
| `linux-ui-visual-verify` | 桌面操作后视觉回读验证（截图取证、断言、证据留痕） | ✅ 已完成 |
| `astron-rpa-linux-runbook` | AstronRPA 在 openKylin/Linux 的部署与原子能力分级手册 | ✅ 已完成 |
| `openkylin-shot-guard` | 截图守卫：拦截黑屏/不落盘/重复图/窄条四类失败（Wayland 双屏适配） | ✅ 已完成 |
| `linux-apt` | apt 包查询、安装、升级、清理与健康巡检 | ✅ 已完成 |

### 开发运维技能
详见 [DevOps 技能集](skills/devops/README.md)

| 技能名称 | 功能描述 | 状态 |
|----------|----------|------|
| `openkylin-deploy-doctor` | openKylin Docker 容器栈部署诊断与修复（11 项自动检查 + 修复脚本生成） | ✅ 已完成 |
| `openkylin-rpa-patrol` | openKylin 服务栈巡检（基于 **Astron 原生 RPA 执行引擎**，非手写脚本） | ✅ 已完成 |
| [openkylin-health-report](skills/devops/openkylin-health-report/SKILL.md) | Astron Agent 调用原生 RPA，生成 openKylin 只读健康报告 | ✅ 已完成 |
| `okbs-build-checker` | OKBS 编译状态查询 | ✅ 已完成 |
| `devops-dpkg-build` | dpkg-buildpackage 编译打包与失败日志分析 | ✅ 已完成 |

### 知识管理技能
| 技能名称 | 功能描述 | 状态 |
|----------|----------|------|
| `ai-reader` | AI 读书摘要与知识图谱生成 | ✅ 已完成 |
| `ai-memocap` | 忆时记忆系统：类人记忆检索/存储/遗忘/胶囊/可视化 | ✅ 已完成 |

### AI/LLM 相关技能
详见 [AI 技能集](skills/ai/README.md)

| 技能名称 | 功能描述 | 状态 |
|----------|----------|------|
| `cangjie-skill` | 仓颉 Skill：把书/视频/播客蒸馏成可执行 Skills 工具包 | ✅ 已完成 |
| `ai-rag-build` | 双人格本地 RAG 构建助手：一句话建库，原生 768 维向量 + BM25 混合召回 + 知识图谱 | ✅ 已完成 |
| `ai-rag-optimize` | RAG 检索效果诊断与优化：定位问题环节，给出可执行优化方案 | ✅ 已完成 |
| `ai-vector-db` | 向量数据库选型与管理：选型建议、HNSW 参数调优、索引更新、性能诊断 | ✅ 已完成 |

---

## 📖 如何使用技能

### 方式一：一键安装（推荐）

使用 `install.sh` 脚本，一条命令完成技能安装：

```bash
# 查看所有可用技能
curl -fsSL https://gitee.com/openkylin/openkylin-skills/raw/master/install.sh | bash -s -- --list

# 为 OpenClaw 安装全部技能
curl -fsSL https://gitee.com/openkylin/openkylin-skills/raw/master/install.sh | bash -s -- --agent openclaw

# 安装指定技能（逗号分隔可多选）
curl -fsSL https://gitee.com/openkylin/openkylin-skills/raw/master/install.sh | bash -s -- --agent openclaw --skill ukui-volume,ukui-wifi

# 按分类安装
curl -fsSL https://gitee.com/openkylin/openkylin-skills/raw/master/install.sh | bash -s -- --agent kylin-bot --category ukui

# 为 WorkBuddy 安装（用户级，全项目可用）
curl -fsSL https://gitee.com/openkylin/openkylin-skills/raw/master/install.sh | bash -s -- --agent workbuddy

# 为当前项目的 WorkBuddy 安装（项目级，仅本项目可见）
curl -fsSL https://gitee.com/openkylin/openkylin-skills/raw/master/install.sh | bash -s -- --agent workbuddy-project --skill ukui-volume

# 自定义安装路径
curl -fsSL https://gitee.com/openkylin/openkylin-skills/raw/master/install.sh | bash -s -- --target /opt/my-agent/skills --all
```

支持以下智能体平台：

| 平台 | 参数 | 默认安装路径 | 目录布局 |
|------|------|-------------|---------|
| OpenClaw | `--agent openclaw` | `~/.openclaw/skills/` | `<分类>/<技能>/` |
| Kylin Bot | `--agent kylin-bot` | `~/.kylinbot/workspace/skills/` | `<分类>/<技能>/` |
| Claw | `--agent claw` | `~/.claw/skills/` | `<分类>/<技能>/` |
| WorkBuddy（用户级） | `--agent workbuddy` | `~/.workbuddy/skills/` | `<技能>/` |
| WorkBuddy（项目级） | `--agent workbuddy-project` | `./.workbuddy/skills/` | `<技能>/` |
| 自定义 | `--target <路径>` | 用户指定 | `<分类>/<技能>/` |

> 设置 `GITEE_TOKEN` 环境变量可提高 API 速率限制。

#### WorkBuddy 安装说明

WorkBuddy 通过 `SKILL.md` frontmatter 里的 `name` / `description` 识别技能，缺少就静默忽略。脚本会做两件自动处理：

1. **自动补全 frontmatter** —— 仓库里部分技能用的是纯 Markdown 写法（`# 标题` + `## 技能描述`），安装时会从中提取内容生成 `name` 与 `description`，源仓库文件不受影响。安装结束会列出被补全的技能，建议人工复核描述文案；用 `--strict` 可让补全失败的技能直接报错。
2. **目录名对齐 `name`** —— 例如 `ukui/desktop` 的 `name` 是 `desktop-manager`，安装后目录即为 `desktop-manager/`，避免目名与技能名不一致。`ukui-file-framework` 同理安装为 `ukui-ufile-mcp/`。
3. 平铺布局下 `--category` 仅作筛选，不再产生分类子目录（技能名跨分类唯一）。

用户级安装完成后**重启 WorkBuddy（或重载窗口）**即可在技能列表中看到。

> 使用 `--agent` 时，可改用环境变量 `AGENT_TARGET` 传平台名；`AGENT` / `AGENT_TYPE` 也会被识别。注意部分 shell 会话本就导出了 `AGENT`，此时请显式传 `--agent`。

### 方式二：对话式安装

直接告诉你的 AI Agent 要安装哪个技能，它会自动处理：

```
帮我安装https://gitee.com/openkylin/openkylin-skills里的ukui-bluetooth 技能
```

### 方式三：手动安装

克隆仓库后，将对应的技能目录复制到你的 Agent 技能目录下：

```bash
git clone https://gitee.com/openkylin/openkylin-skills.git
cp -r openkylin-skills/skills/ukui/ukui-bluetooth ~/.openclaw/skills/
```

### 调用技能

安装完成后，在对话中直接描述需求即可触发对应技能：

```
打开蓝牙
把音量调到 50%
切换深色主题
```

也可以通过 CLI 手动加载：

```bash
openclaw skills load ukui-bluetooth
```

### 定时执行

通过 Calendar 创建定时任务，在 description 中引用技能。

---

## 💬 反馈与支持

遇到问题或有建议？查看 [反馈与支持](docs/feedback.md)

---

## 🤝 如何贡献新技能

欢迎社区小伙伴贡献技能！详见 [如何贡献技能](docs/how-to-add-skill.md)。

### 可以贡献的技能方向

| 方向 | 说明 |
|------|------|
| UKUI 桌面环境 | 亮度、音量、主题、壁纸等桌面控制技能 |
| Linux 通用技能 | 包管理、服务管理、用户管理、磁盘管理等 |
| 社区贡献 | PROPOSED 监控、Issue 管理、仓库操作等 |
| 开发运维 | 编译构建、CI/CD、Docker、自动化脚本等 |
| AI/LLM 相关 | Prompt 模板、Agent 架构、RAG 实现等 |
| 特定领域 | 文档写作、安全审计、性能调优、数据分析、内容创作等 |

---

## 📚 规划文档

| 文档 | 描述 |
|------|------|
| [UKUI接口技能规划](docs/UKUI接口技能规划.md) | 基于 UKUI Framework D-Bus 接口的技能规划，涵盖设备控制、UI个性化、系统操作、文件能力等模块 |

---

## 📜 许可证

MulanPSL-2.0（木兰宽松许可证第2版）

Copyright (c) 2026 kiber234324

Licensed under the Mulan PSL v2.
You may obtain a copy of Mulan PSL v2 at:
http://license.coscl.org.cn/MulanPSL2

THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT, MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.

---

## 👥 维护者

- Maintainer: kiber234324