getskill

# GetSkill ## 何时使用此 Skill 当你需要以下功能时使用此 skill： - 从 getskill.work 仓库搜索 OpenClaw 技能 - 向 OpenClaw 环境安装新技能 - 更新现有技能到最新版本 - 管理 `~/.openclaw/skills` 目录中的技能文件 - 为技能仓库配置自定义 API 端点 ## 指令 ### OpenClaw 首次启动：先安装 getskill CLI 当 OpenClaw 首次启动且尚未安装 getskill CLI 时，按以下流程执行： 1. 先测试 `getskill` 是否可用： ```bash getskill --help ``` 2. 如果不可用，安装 CLI（任选其一）： ```bash pnpm i -g @workskills/getskill ``` 或 ```bash npm i -g @workskills/getskill ``` 3. 安装完成后即可运行 getskill 命令： ```bash getskill search <关键词> ``` ### 搜索技能 1. 使用搜索命令并传入关键词： ```bash getskill search <关键词> ``` 2. 工具查询 API 并返回匹配的技能，包含： - 技能名称和描述 - Git 仓库 URL ### 安装技能 1. 首先确保系统已安装 Git（如未安装，工具会引导安装） 2. 运行安装命令： ```bash getskill install <技能名称> ``` 3. 工具执行以下操作： - 克隆 Git 仓库到 `~/.openclaw/skills-cache/<技能名称>` - 将整个技能目录复制到 `~/.openclaw/skills/<本地技能目录名>`（排除 `.git`） - 返回已复制目录列表 ### 更新技能 1. 运行更新命令： ```bash getskill update <技能名称> ``` 2. 工具会： - 检查技能是否存在于缓存目录 - 执行 `git pull` 获取最新变更 - 重新复制技能目录到 skills 目录 ### 列出本地技能 ```bash getskill list ``` 返回 skills 目录中当前所有技能目录名称。 ### 查看目录路径 ```bash getskill path ``` 显示： - 技能目录：`~/.openclaw/skills` - 缓存目录：`~/.openclaw/skills-cache` ### 配置 API 端点 查看当前端点： ```bash getskill config get ``` 设置自定义端点： ```bash getskill config set https://your-custom-api.com ``` ### 清理缓存 ```bash getskill clean ``` 移除所有 Git 仓库缓存，不影响已安装的技能。 ## 示例 ### 搜索示例 **输入：** 用户想查找与 commit 相关的技能 **命令：** ```bash getskill search commit ``` **输出：** ``` 找到 3 个技能： 1. commit-helper 描述: 帮助生成规范的 git commit 信息 Git: https://getskill.work/skills/commit-helper.git ``` ### 安装示例 **输入：** 用户想安装 commit-helper 技能 **命令：** ```bash getskill install commit-helper ``` **操作：** 1. `git clone` 到 `~/.openclaw/skills-cache/commit-helper` 2. 复制整个目录到 `~/.openclaw/skills/commit-helper` **输出：** ``` 技能已安装到 skills 目录: - ~/.openclaw/skills/commit-helper ``` ### 更新示例 **输入：** 用户想更新已有技能 **命令：** ```bash getskill update commit-helper ``` **操作：** 1. `cd ~/.openclaw/skills-cache/commit-helper` 2. `git pull` 3. 重新复制技能目录到 skills 目录 ## 边缘情况 ### Git 未安装 **场景：** 用户在没有 Git 的系统上运行 install/update 命令 **处理：** - Windows：自动下载 Git 安装程序并启动安装向导 - macOS：提示通过 Homebrew 安装（`brew install git`） - Linux：提供包管理器命令（apt-get、yum、dnf、pacman） ### 技能未找到 **场景：** API 返回 404 表示请求的技能不存在 **处理：** 显示清晰的错误信息："技能不存在: {skill-name}" ### 仓库无技能文件 **场景：** 克隆的仓库中不包含技能 `.md` 文件（除 README 外） **处理：** 抛出错误："在仓库中未找到技能 .md 文件" ### 网络错误 **场景：** 由于网络问题导致 API 请求失败 **处理：** - 主机未找到："无法连接到服务器，请检查网络或 API 地址配置" - 超时："请求超时，请稍后重试" - 连接被拒绝："服务器拒绝连接，请检查 API 地址是否正确" ### 技能名称重复 **场景：** 仓库中有多个名称相似的 `.md` 文件 **处理：** 将技能目录整体复制到 skills 目录（排除 `.git`） ## 关键规则 - 在执行 clone/pull 操作前始终验证 Git 安装 - 复制整个技能目录到 `skills/<技能名>`，并排除 `.git` 目录 - 清理时绝不删除 skills 目录内容 - 只移除缓存 - 支持通过环境变量 `GETSKILL_BASE_URL` 使用自定义端点 - 自动处理 API 重定向（最多 5 次） - API 请求 60 秒后超时 - 如果目录不存在则递归创建 - 搜索失败时返回空数组（而不是抛出异常）以防止程序崩溃 - 在调用 API 前验证所有用户输入