SkillUp

# SkillUp ## Overview `SkillUp` 通过一个统一的 shell 入口，对 skill 进行检查、打包和多平台发布。 它被设计成可在 Codex、OpenClaw 中文社区及其他能读取 `SKILL.md` 并执行 shell 命令的智能体环境中使用。 ## When to Use 在这些场景下使用： - 你要把一个 skill 发布到一个或多个平台 - 你要批量同步整个 skills 仓库 - 你希望尽量避免浏览器自动化 - 你希望优先从环境变量读取凭证，并允许配置文件回退 这些情况不适合使用： - 任务只是修改 skill 内容，并不需要发布 - 目标平台只能通过浏览器手工完成，且无法用 CLI 或 HTTP 配置替代 ## Inputs 统一入口： ```bash ./skills/SkillUp/scripts/publish.sh [publish|check|package|redact-check|install-local|rollback] --source <path> [options] ``` 常用参数： - `--source <path>`: single skill directory or skill repository root - `--platforms <csv>`: `github,xiaping,openclaw,clawhub` - `--config <path>`: path to a local TOML-like config file - `--artifact-dir <path>`: where packaged zip files are written - `--result-file <path>`: where structured JSON results are written - `--dry-run`: validate and package without external publishing - `--fail-fast`: stop at the first failure - `--continue-on-error`: keep going after failures - `--retry <n>`: retry failed publishes - `--redact-mode <mode>`: `strict`, `warn`, `off` - `--parallel-publish`: 并发发布多个平台 - `--sequential-publish`: 禁用并发发布 模式： - `check`：检查 metadata、命令可用性和平台要求 - `package`：只校验并打包，不进行远程发布 - `publish`：校验、打包并执行发布 - `doctor`：检查本地发布环境是否齐全 - `status`：查看本地版本和远端平台状态 - `bump`：自动提升版本号 - `redact-check`：上传前脱敏检查，扫描目录中的敏感信息 - `install-local`：把当前 skill 安装到 `codex`、`openclaw` 或两者本地目录 - `rollback`：从 GitHub release 还原本地 skill 文件到指定版本 ## Credential Priority 凭证优先级： 1. Environment variables 2. Config file values 默认支持的环境变量： - `SKILLUP_GITHUB_TOKEN` - `SKILLUP_XIAPING_API_KEY` - `SKILLUP_OPENCLAW_TOKEN` - `SKILLUP_CLAWHUB_TOKEN` - `CLAWHUB_TOKEN` ## Expected Layout 单个 skill 目录至少应包含： - `SKILL.md` 可选的每个 skill 元数据可写在： - `manifest.toml` 如果是 skills 仓库模式，根目录下可以包含多个子 skill 目录，每个目录都有自己的 `SKILL.md`。 为了让 Codex 和 OpenClaw 中文社区都能直接发现并使用这个技能，建议安装到各自的默认技能目录之一： - `~/.codex/skills/SkillUp` - `~/.openclaw/skills/SkillUp` 平台开关： - 在 `manifest.toml` 里设置 `[github].enabled = false` 之类的值，可以跳过某个平台 - 可以把 manifest 中的开关和 `--platforms <csv>` 组合使用，分别控制“允许的平台集合”和“实际启用的平台集合” 上传前脱敏检查： - 默认使用 `strict` 模式，在打包前扫描技能目录中的文本文件 - 命中高风险敏感内容会直接阻止 `check`、`package`、`publish` - 可用 `.skillup-ignore` 忽略特定文件或 glob 模式 - 如需只提示不阻止，可用 `--redact-mode warn` ## Publish Flow 1. 从给定 source 路径发现 skill 2. 校验每个 skill 目录 3. 预先获取各平台远端状态并输出发布前差异摘要 4. 打包生成 zip 产物 5. 按要求尝试发布到各个平台 6. 在允许时并发发布多个平台 7. 输出简洁的成功、跳过和失败摘要 8. 把机器可读结果写入 `publish-result.json` ## Examples 以 dry-run 方式模拟发布单个 skill： ```bash ./skills/SkillUp/scripts/publish.sh \ publish \ --source ./skills/SkillUp \ --platforms github,xiaping,openclaw,clawhub \ --dry-run ``` 只做校验： ```bash ./skills/SkillUp/scripts/publish.sh \ check \ --source ./skills/SkillUp \ --result-file ./skills/SkillUp/.skillup-artifacts/check-result.json ``` 只做脱敏检查： ```bash ./skills/SkillUp/scripts/publish.sh \ redact-check \ --source ./skills/SkillUp ``` 安装到本地智能体目录： ```bash ./skills/SkillUp/scripts/publish.sh \ install-local both \ --source ./skills/SkillUp ``` 从 GitHub release 回滚本地文件： ```bash ./skills/SkillUp/scripts/publish.sh \ rollback 0.1.7 \ --source ./skills/SkillUp ``` 使用配置文件发布整个 skills 仓库： ```bash ./skills/SkillUp/scripts/publish.sh \ --source ./skills \ --config ./skills/SkillUp/config.example.toml ``` ## Notes - GitHub 发布支持把产物同步到目标仓库，并通过 `gh` 创建或更新 release - 发布结果 JSON 现在会同时写出 `local_version`、`remote_version`、`platform_adjusted`、`blocking` - 虾评在有 `SKILLUP_XIAPING_API_KEY` 或配置文件凭证时走 HTTP API - 虾评分类型会在可能的情况下通过实时分类 API 做校验 - ClawHub 优先使用官方 `clawhub` CLI，失败后再考虑 HTTP 回退 - OpenClaw 中文社区优先使用 `claw` 社区 CLI - 如果你希望 OpenClaw 中文社区自动发现这个技能，请优先放在 `~/.openclaw/skills/SkillUp` 或当前 OpenClaw 工作区的 `skills/SkillUp` - ClawHub 的服务端 trigger 异常会被单独分类，方便区分平台 bug 和本地打包问题