40 lines
1.4 KiB
Markdown
40 lines
1.4 KiB
Markdown
# 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` 了解完整操作流程和命令。
|