use_vala_skillhub

管理 Vala SkillHub 上的技能：推送（上传）和安装。

SkillHub 基于 Gitea，每个技能对应一个独立的 Git 仓库。推送时使用 ./tmp 临时目录，不在 ./skills 内创建 .git，避免影响 workspace 级别的 git 备份。

命名规则

仓库名格式：{skill_name}.{source_name}

skill_name：技能目录名（如 cron_job、web_scraper）
source_name：来源名称，即当前数字员工的 name（如 xiaoxi）
如果 source_name 为 vala，表示公司级别的官方技能

示例：

cron_job.xiaoxi — xiaoxi 的定时任务技能
web_scraper.vala — 公司官方的爬虫技能

配置

操作前需要确认以下配置（保存到 ~/.vala_skillhub_config）：

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

如果配置文件不存在，请询问用户获取以上信息后创建：

cat > ~/.vala_skillhub_config <<EOF
GITEA_URL=https://git.valavala.com
GITEA_TOKEN=<token>
GITEA_OWNER=vala_skillhub
SOURCE_NAME=<name>
EOF

后续操作前先加载配置：

source ~/.vala_skillhub_config

操作一：推送技能到 SkillHub

将本地 ./skills 下的技能目录推送到 SkillHub。

核心原则：使用 ./tmp/skill_push/ 作为临时工作区，不在 ./skills 内执行任何 git 操作，保持 workspace 干净。

流程

确定仓库名：repo_name = {skill_dir_name}.{SOURCE_NAME}

检查远程仓库是否存在：

curl -s -o /dev/null -w "%{http_code}" \
  "${GITEA_URL}/api/v1/repos/${GITEA_OWNER}/${repo_name}" \
  -H "Authorization: token ${GITEA_TOKEN}"

返回 200 → 仓库已存在，跳到步骤 4
返回 404 → 需要创建，执行步骤 3

创建远程仓库：

curl -s -X POST "${GITEA_URL}/api/v1/orgs/${GITEA_OWNER}/repos" \
  -H "Authorization: token ${GITEA_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{"name": "'${repo_name}'", "private": false, "description": "技能描述", "auto_init": false}'

复制到临时目录并推送：

# 清理并准备临时目录
rm -rf ./tmp/skill_push/${repo_name}
mkdir -p ./tmp/skill_push/${repo_name}

# 复制技能内容（不含隐藏文件的 .git 等）
cp -r ./skills/${skill_dir_name}/* ./tmp/skill_push/${repo_name}/
cp -r ./skills/${skill_dir_name}/.[!.]* ./tmp/skill_push/${repo_name}/ 2>/dev/null || true

# 在临时目录中执行 git 操作
cd ./tmp/skill_push/${repo_name}
git init
git checkout -b main
git add -A
git commit -m "update: sync skill $(date +%Y-%m-%d)"
git remote add origin https://oauth2:${GITEA_TOKEN}@${GITEA_URL#https://}/${GITEA_OWNER}/${repo_name}.git
git push -u origin main --force

清理临时目录：

cd -
rm -rf ./tmp/skill_push/${repo_name}

批量推送

遍历 ./skills/ 下所有子目录，对每个目录重复以上流程。注意跳过 use_vala_skillhub 目录本身。

操作二：安装 / 更新技能

从 SkillHub 下载技能到本地 ./skills 目录。若本地已存在同名目录，则清空后重新下载，确保与远程版本一致。

注意：不使用 git clone，而是下载归档解压，避免在 ./skills 下产生 .git 目录。

流程

确定要安装的仓库名（完整名，如 cron_job.xiaoxi）

下载并解压（已存在则先清空再覆盖）：

repo_name="cron_job.xiaoxi"
target_dir="./skills/${repo_name}"

# 如果已存在，清空目录内容以确保与远程一致（删除远程已移除的文件）
rm -rf "${target_dir}"
mkdir -p "${target_dir}"

# 通过 Gitea API 下载 tar.gz 归档并解压（自动尝试 main/master）
curl -sL "${GITEA_URL}/api/v1/repos/${GITEA_OWNER}/${repo_name}/archive/main.tar.gz" \
  -H "Authorization: token ${GITEA_TOKEN}" \
  | tar xz --strip-components=1 -C "${target_dir}" 2>/dev/null \
|| curl -sL "${GITEA_URL}/api/v1/repos/${GITEA_OWNER}/${repo_name}/archive/master.tar.gz" \
  -H "Authorization: token ${GITEA_TOKEN}" \
  | tar xz --strip-components=1 -C "${target_dir}"

操作三：列出 SkillHub 上的技能

curl -s "${GITEA_URL}/api/v1/orgs/${GITEA_OWNER}/repos?page=1&limit=50&sort=updated" \
  -H "Authorization: token ${GITEA_TOKEN}"

返回 JSON 数组，每个元素包含 name、description、updated_at 等字段。如结果满 50 条，继续翻页 page=2。

4.8 KiB Raw Blame History Unescape Escape