# use_vala_skillhub

Vala SkillHub 技能管理 —— 让数字员工推送和安装技能。

## 功能

- **推送技能**：将本地 `./skills` 下的技能上传到 SkillHub（Gitea 仓库）
- **安装 / 更新技能**：从 SkillHub 下载技能到本地 `./skills` 目录（已存在则清空后重新下载）
- **查看技能**：列出 SkillHub 上的所有技能

## 设计要点

推送和安装均不在 `./skills` 目录内产生 `.git`，确保不影响 workspace 级别的 git 备份：
- **推送**：复制到 `./tmp/skill_push/` 临时目录，完成 git 推送后清理
- **安装**：通过 Gitea API 下载归档解压，不使用 git clone

## 命名规则

仓库名 = `技能名` + `.` + `来源名`

| 示例 | 含义 |
|------|------|
| `cron_job.xiaoxi` | xiaoxi 的定时任务技能 |
| `web_scraper.vala` | 公司官方的爬虫技能 |

来源为 `vala` 的属于公司级别官方技能。

## 配置

首次使用需提供配置，保存在 `~/.vala_skillhub_config`：

- `GITEA_URL` — Gitea 服务地址（默认 `https://git.valavala.com`）
- `GITEA_TOKEN` — API Token（需有组织仓库的创建和推送权限）
- `GITEA_OWNER` — SkillHub 组织名（默认 `vala_skillhub`）
- `SOURCE_NAME` — 当前数字员工的 name

## 使用方式

本技能面向 AI 数字员工使用。请参阅 `SKILL.md` 了解完整操作流程和命令。