GitHub Copilot CLI中使用skills教程（以aminer-open-skill为例）

目录

• [GitHub Copilot CLI的安装与使用skills](#GitHub Copilot CLI的安装与使用skills)
• • [一、GitHub Copilot CLI安装](#一、GitHub Copilot CLI安装)
  • [二、初次使用GitHub Copilot CLI](#二、初次使用GitHub Copilot CLI)
  • [三、在GitHub Copilot CLI使用skills](#三、在GitHub Copilot CLI使用skills)
  • 四、aminer-open-skill的配置使用

---

GitHub Copilot CLI的安装与使用skills

注：我是在WSL2中执行的

一、GitHub Copilot CLI安装

1. 检查 Node.js 和 npm 版本

   node --version   # 应该输出 v22.x.x 或更高
   npm --version    # 应该输出 10.x.x 或更高

   如果不满足，执行下面的方式进行升级

   # 1. 卸载旧版
   sudo apt remove --purge -y nodejs npm
   sudo apt autoremove -y
   
   # 2. 添加官方 Node.js 24 源
   curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
   
   # 3. 安装新版
   sudo apt install -y nodejs
   
   # 4. 验证是否成功
   node --version
   npm --version

2. 安装 GitHub Copilot CLI

   目前官方唯一推荐的安装方式是通过 npm：

   npm install -g @github/copilot

   验证安装

   copilot --version

3. 更新到最新版本

   更新命令与安装命令相同，npm 会自动安装最新版本

   npm install -g @github/copilot

二、初次使用GitHub Copilot CLI

1. 启动GitHub Copilot CLI

   进入项目目录，在终端输入：

   copilot

2. 登录

   在对话栏输入：

   /login

   打开终端显示的网址，输入终端的8位认证码授权

3. 切换模型

   在对话栏输入：

   /model

   可以切换模型

4. 输入命令

   除了直接对话，还支持输入命令使用。输入最开始时写一个英文!就是命令模式

5. 退出

   /exit

6. 继续对话

   copilot --continue

三、在GitHub Copilot CLI使用skills

1. 下载所需skills的文件夹+SKILL.md

2. 放置在~/.copilot

   目录放在~/.copilot，也就是目录结构应该是~/.copilot/skills名称/SKILL.md，你下载的文件夹内可以不止SKILL.md，还可以包含其他的脚本文件

3. 重新加载skills

   在CLI中输入

   /skills reload

   即可加载skills

4. 验证是否加载成功

   在CLI中输入

   /skills list

四、aminer-open-skill的配置使用

aminer-open-skill项目地址

1. 按照三、在GitHub Copilot CLI使用skills加载该skills

2. 在 AMiner 控制台生成 Token

   点击网址进入控制台

   https://open.aminer.cn/open/board?tab=control

   点击一键生成Token，下面的可以一键复制的就是（上面API Key处的***==不用管）

3. 导入 Token

   1. 临时导入（关闭终端后就失效）

      export AMINER_API_KEY="<YOUR_TOKEN>"
      
      # 验证（应会输出 Token）
      echo "$AMINER_API_KEY"

   2. 永久导入

      echo 'export AMINER_API_KEY="xxx"' >> ~/.bashrc
      source ~/.bashrc
      
      # 重启终端，验证是否成功
      echo "$AMINER_API_KEY"

4. 测试调用效果

   1. curl调用
      README有误，命令中的参数应该用双引号包围，有中括号参数才用单引号包围

      # 论文搜索
      curl -X GET "https://datacenter.aminer.cn/gateway/open_platform/api/paper/search?page=1&size=5&title=BERT" -H "Authorization: ${AMINER_API_KEY}" -H "X-Platform: openclaw"
      
      # 学者搜索
      curl -X POST "https://datacenter.aminer.cn/gateway/open_platform/api/person/search" -H "Content-Type: application/json;charset=utf-8" -H "Authorization: ${AMINER_API_KEY}" -H "X-Platform: openclaw" -d '{"name":"Andrew Ng","size":5}'

   2. python脚本调用
      正确配置好skills后，用文本问题向Copilot提问，Copilot正常都是用python脚本

5. 关于费用问题

   1. 输入问题消耗的是Copilot的额度
   2. Copilot使用命令或脚本去检索消耗的是AMiner平台的费用
   3. 具体价格在aminer-open-skill/skills/aminer-data-search/SKILL.md有写
   4. 这个skills会优先使用免费API，除非用户明确需要更深入的字段或者免费API无法满足

---