ai_member_xiaoban/skills/use_vala_skillhub.vala/README.md

use_vala_skillhub

Vala SkillHub 技能管理 —— 让数字员工推送、安装和自动同步技能。

功能

• 推送技能：将本地 ./skills 下的技能上传到 SkillHub（Gitea 仓库）
• 安装 / 更新技能：从 SkillHub 下载技能到本地 ./skills 目录（已存在则清空后重新下载）
• 查看技能：列出 SkillHub 上的所有技能
• 自动同步：基于内容哈希检测变更，仅推送有变化的 skill，避免重复推送

设计要点

推送和安装均不在 ./skills 目录内产生 .git，确保不影响 workspace 级别的 git 备份：

• 推送 / 自动同步：复制到 ./tmp/skill_push/ 临时目录，完成 git 推送后清理
• 安装：通过 Gitea API 下载归档解压，不使用 git clone
• 变更检测：通过 ~/.vala_skill_hashes 记录每个 skill 的内容哈希，对比检测变更

自动同步机制

数字员工在新增或修改 skill 后，必须自动执行 check_and_push：

1. 计算 skill 目录的综合哈希（含文件路径 + 内容）
2. 与 ~/.vala_skill_hashes 中的历史哈希对比
3. 仅推送有变更的 skill，推送成功后更新哈希记录

可选配合 cron_job 技能设置定时全量同步作为安全网。

命名规则

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

示例	含义
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 了解完整操作流程和命令。