技能副驾驶提供者

工程开发 社区

技能解读

当前原文的自动摘译,尚未人工审校。

概述

GitHub Copilot CLI(自 2026 年 2 月起正式发布)作为 Claude Octopus 多 LLM 生态系统中的可选提供商。集成使用官方的copilot -p编程模式,而不是逆向工程的API端点。核心原则:Copilot 以零额外成本补充现有提供商的研究和探索(使用现有的 GitHub Copilot 订阅)。每个提示算作 1 个

检测

优雅降级:当 Copilot CLI 不可用或未经身份验证时,静默跳过。其他供应商继续正常运营。

认证

Copilot CLI 按以下优先顺序检查凭据: COPILOT_GITHUB_TOKEN env var(最高优先级 - 具有“Copilot 请求”权限的细粒度 PAT) GH_TOKEN env var GITHUB_TOKEN env var 来自系统钥匙串的 OAuth 令牌(通过 copilot login)

设置

选项 1:交互式登录(建议用于本地开发) 选项 2:细粒度 PAT(建议用于 CI/自动化) 在 https://github.com/settings/personal-access-tokens/new 创建细粒度 PAT 启用“Copilot Requests”权限 设置环境变量:

可用角色

角色 · 代理类型 · 用例一般 · copilot · 广泛的研究、代码解释、探索 研究 · copilot-research · 以研究为中心的探索和分析

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
工程开发
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@nyldn · 未声明许可证
上下文用量评级
低消耗
接入复杂程度
需简单配置
是否需要外部接口密钥
需要 · GitHub
兼容的系统
未声明(默认跨平台)
运行环境要求
未检出明确要求
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
  • 命令执行
  • 读取环境变量
网络行为
允许外网请求
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

作者说明文件(原文) SKILL.md

> **Host: Codex CLI** — This skill was designed for Claude Code and adapted for Codex.
> Cross-reference commands use installed skill names in Codex rather than `/octo:*` slash commands.
> Use the active Codex shell and subagent tools. Do not claim a provider, model, or host subagent is available until the current session exposes it.
> For host tool equivalents, see `skills/blocks/codex-host-adapter.md`.


# GitHub Copilot Provider Skill

## Overview

GitHub Copilot CLI (GA since Feb 2026) serves as an optional provider in the Claude Octopus
multi-LLM ecosystem. Integration uses the official `copilot -p` programmatic mode, not
reverse-engineered API endpoints.

**Core principle:** Copilot supplements existing providers for research and exploration at
zero additional cost (uses existing GitHub Copilot subscription). Each prompt counts as one
premium request against your subscription quota.

**Agent types:** `copilot` (general), `copilot-research` (research-focused)


## Detection

```bash
# Check copilot CLI is available
if ! command -v copilot &>/dev/null; then
  # Copilot CLI not installed — silently skip
  return 0
fi
```

**Graceful degradation:** When Copilot CLI is unavailable or unauthenticated, silently skip.
Other providers continue to operate normally.


## Authentication

Copilot CLI checks credentials in this precedence order:

1. `COPILOT_GITHUB_TOKEN` env var (highest priority — fine-grained PAT with "Copilot Requests" permission)
2. `GH_TOKEN` env var
3. `GITHUB_TOKEN` env var
4. OAuth token from system keychain (via `copilot login`)
5. GitHub CLI (`gh`) authentication fallback

### Setup

**Option 1: Interactive login (recommended for local dev)**
```bash
copilot login
```

**Option 2: Fine-grained PAT (recommended for CI/automation)**
1. Create a fine-grained PAT at https://github.com/settings/personal-access-tokens/new
2. Enable the "Copilot Requests" permission
3. Set the env var:
```bash
export COPILOT_GITHUB_TOKEN="github_pat_..."
```

**Option 3: Reuse existing `gh` auth**
If `gh auth login` is already configured, Copilot CLI will use it automatically.

**Note:** Classic PATs (`ghp_*`) are NOT supported. Use fine-grained PATs (`github_pat_*`).


## Available Roles

| Role | Agent Type | Use Case |
|------|-----------|----------|
| **General** | `copilot` | Broad research, code explanation, exploration |
| **Research** | `copilot-research` | Research-focused exploration and analysis |

### Dispatch

```bash
# Programmatic mode (non-interactive)
copilot -p "<prompt>" --no-ask-user
```


## Provider Indicators

When Copilot is active in a multi-provider workflow:

```
Providers:
🔴 Codex CLI - Implementation
🟡 Gemini CLI - Security review
🟢 Copilot CLI - Research perspective
🔵 Claude - Synthesis
```

Indicator legend:
- 🔴 = Codex CLI
- 🟡 = Gemini CLI
- 🟢 = Copilot CLI
- 🟣 = Perplexity
- 🔵 = Claude


## Doctor Integration

The `/octo:doctor` providers check reports Copilot availability and auth method:

```
Providers:
  ✓ Copilot CLI installed (auth: keychain)
```

When unauthenticated: `⚠ Copilot CLI installed but not authenticated`
When missing: `ℹ Copilot CLI not installed (optional)`


## Integration Notes

1. **Zero additional cost** — Uses existing GitHub Copilot subscription (Pro, Pro+, Business, Enterprise)
2. **Premium request quota** — Each `copilot -p` prompt = 1 premium request from your monthly allowance
3. **Graceful degradation** — When unavailable, silently skip with no errors or warnings
4. **No provider cascade** — If unavailable, the role is reassigned to another provider
5. **Model selection** — Copilot CLI selects the model internally (default: Claude Sonnet 4.5, configurable via `/model`)
6. **Multi-model access** — Copilot subscription includes access to Claude, GPT, and Gemini models


## Example Workflows

### Research with Copilot

```
🐙 **CLAUDE OCTOPUS ACTIVATED** - Multi-provider research mode
🔍 Discover Phase: Researching WebSocket authentication patterns

Providers:
🔴 Codex CLI - Technical implementation analysis
🟡 Gemini CLI - Ecosystem research
🟢 Copilot CLI - Research perspective
🔵 Claude - Strategic synthesis
```

### Copilot Unavailable (Graceful Degradation)

```
🐙 **CLAUDE OCTOPUS ACTIVATED** - Multi-provider research mode
🔍 Discover Phase: Researching WebSocket authentication patterns

Providers:
🔴 Codex CLI - Technical implementation analysis
🟡 Gemini CLI - Ecosystem research
🔵 Claude - Strategic synthesis
```

When Copilot is not detected, it is silently omitted from the provider list.

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。