安装和使用技能仓库

一个技能是一个包含 SKILL.md 文件的目录，可选地与 scripts/ 和 references/ 目录一起。仓库 https://github.com/risense-ai/skills 包含 Respire 技能库。本页解释用户如何安装和使用该仓库中的技能。

原理

• 一个技能是一个目录加上 SKILL.md。主机（如 opencode）会递归扫描技能目录中的 **/SKILL.md，并暴露每个匹配项的 name、description 和 location。
• SKILL.md 中的 description 字段包含用于引导模型的触发词。模型按需加载技能，因此触发短语只是引导而非保证激活；显式命名技能更可靠。
• 因此，安装是两种选择之一：将技能放在主机扫描的目录中，或注册仓库目录为扫描路径。

先决条件

• 已安装主机；本页以 opencode 为例。查看 入门指南 获取 CLI。
• 方法 A 和 B 需要 git；方法 C 需要 Node 和 npx。
• 必须能访问 GitHub；连接失败属于故障排除范围。

安装方法

方法	机制	范围
A	在 opencode 的 skills.paths 中注册克隆的仓库	整个仓库
B	将一个技能目录复制到 opencode 默认技能目录	单个技能
C	将第三方 skills CLI 安装到共享外部位置	单个技能
D	其他主机和共享外部位置	主机依赖

整个仓库安装

克隆仓库，然后在配置中将该目录注册为技能路径：

git clone https://github.com/risense-ai/skills <local-directory>

编辑全局配置文件，位置如下：

• Windows: C:\Users\<user>\.config\opencode\opencode.jsonc
• macOS 和 Linux: ~/.config/opencode/opencode.json(c)

{
  "$schema": "https://opencode.ai/config.json",
  "skills": {
    "paths": ["<absolute path to the cloned directory>"]
  }
}

该目录下的所有技能（包括嵌套子目录）都将可用。

单个技能安装

仅将所需技能目录复制到 opencode 默认技能位置：

git clone --depth 1 https://github.com/risense-ai/skills /tmp/risense-skills
cp -r /tmp/risense-skills/<skill-name> ~/.config/opencode/skills/

目录 ~/.config/opencode/skills/ 是 opencode 的默认扫描位置。

使用 skills CLI 的单命令安装

npx --yes skills add risense-ai/skills --skill <skill-name> --agent opencode -g -y

• 技能将安装到 ~/.agents/skills/<skill-name>/，opencode 会自动加载。
• -g 选择全局安装；-y 跳过提示，在非交互环境中必需。

其他主机和共享位置

• Claude Code 和遵循 Agent Skills 约定的主机读取 ~/.claude/skills/<name>/SKILL.md。
• 共享外部位置 ~/.agents/skills/<name>/SKILL.md 也被 opencode 读取。
• 技能目录也可放置在任意位置并通过主机等效机制注册，例如 opencode 的 skills.paths。

激活和验证

• 重启主机。opencode 仅在启动时加载技能和配置；运行中的会话不会热加载。
• 通过以下命令验证安装：

opencode debug skill

该命令列出所有加载技能的 name、description 和 location。确认目标技能出现且其 location 指向安装目录。

使用

安装后无需输入命令。向 AI 说出触发短语，短语写在技能 description 中：

"批量整理提取的记忆"

显式命名技能也更可靠：

"使用 memory-batch-tidy 附加提取的会话根目录"

升级

• 方法 A：在克隆目录中运行 git pull，然后重启主机。
• 方法 B：先检查并备份本地修改，再替换原技能目录。方法 C：检查 skills CLI 的更新行为。

卸载

• 删除技能目录，即 ~/.config/opencode/skills/<name>/ 或 ~/.agents/skills/<name>/。
• 或从 opencode.json(c) 的 skills.paths 中移除仓库目录。
• 重启主机。

故障排除

• GitHub 连接超时：在运行 git 或 npx 前通过代理路由。PowerShell 中设置 $env:HTTPS_PROXY = "http://127.0.0.1:7890"；bash 或 zsh 中使用 export HTTPS_PROXY=http://127.0.0.1:7890。将地址替换为您的代理。
• npx 挂起等待输入：添加 -y。如果出现证书错误，请配置代理的受信任 CA（例如 NODE_EXTRA_CA_CERTS），而不要关闭 TLS 验证。
• 已安装但未激活：主机可能未重启，或路径错误或未扫描。使用 opencode debug skill 检查 location。
• 同名技能重复：同一名称仅一个副本生效。避免在多个扫描位置放置同名目录。

仓库技能

技能	用途	触发短语
memory-batch-tidy	批量整理由 rsrs extract 导入的会话摘要根条目到树中	整理提取的记忆；批量整理会话导入

查看 批量整理提取的记忆 了解工作流程。该技能补充 CLI 内存命令；查看 插件 了解基于钩子的扩展点。新增技能的规范在仓库 README.md 中有文档。