名詞對照與三套 CLI 遷移表

GitHub Copilot CLI 是本站第四款進站的終端機 agent——你可能是從 Claude Code、Codex CLI 或 Gemini CLI 任何一家過來的，所以這份附錄不做單向搬家表，改做三方對照，讓你從自己熟悉的那一家，直接跳到「Copilot CLI 這裡怎麼寫」。

想像你已經會開三種不同廠牌的車，現在要租一台新廠牌的車上路。方向盤、油門、煞車的位置八成大同小異，但「開遠光燈的桿子在哪」「行李廂怎麼開」這種細節，每家廠牌總有幾個地方硬是不一樣。這份附錄就是你的「新車說明書」：前半段是純查字典的中英名詞速查，後半段是「你熟悉的那一家 → Copilot CLI」對照表，最後再加一份遷移檢查清單，照著打勾就能把工作習慣搬過來。

在那之前，還有一個 Copilot CLI 特有的地雷得先排除——因為它跟本站另外三家都不一樣，它的名字被官方自己用過兩次。

動工前先辨認：你查到的是舊指令還是新指令？

如果你在網路上搜尋「Copilot CLI」，很有機會先撞見一批教你打 gh copilot suggest 的舊文章——這些文章沒有錯，只是講的是已經停用的東西，跟本書教的完全是另一套指令。

(料源：official，GitHub Changelog — Upcoming deprecation of gh-copilot CLI extension、github/gh-copilot、GitHub Changelog — GitHub Copilot CLI is now generally available)

舊版還留了一手：gh copilot alias 指令可以幫你的 shell 產生兩個捷徑——ghcs（包 suggest）與 ghce（包 explain）。如果你電腦裡的 .zshrc 或 .bashrc 還留著這兩個別名，那是舊時代的遺跡，跟本書教的 copilot 指令完全無關，可以放心清掉。

B.1 中英名詞速查表

第一次碰到英文縮寫卡住很正常。下面把全書出現的核心名詞集中起來，看到不懂的詞就回這裡查。

核心身分與角色

記憶與設定

安全與權限

工具、自動化與計費

B.2 一張表看懂：Claude Code／Codex CLI／Gemini CLI → Copilot CLI

如果你是這三家任何一家的老手，這一節就是你的「搬家對照表」。

(料源：mixed——Claude Code／Codex CLI／Gemini CLI 各欄位取自本站對應單元既有正文的官方查證內容；Copilot CLI 各欄位取自本篇官方文件查證，查核日 2026-07-18)

B.3 自訂代理對照：custom agent 不是 subagent

Copilot CLI 在「幫主 agent 找幫手」這件事上，用詞跟本站另外三家都不一樣——它不叫 subagent，叫 custom agent。

(料源：mixed——Claude Code／Codex CLI 欄位取自本站對應單元既有正文；Gemini CLI 欄位取自本站 gemini 單元第 11 章正文（「自訂 subagent 通常放在 .gemini/agents/*.md 或 ~/.gemini/agents/*.md」）；Copilot CLI 欄位取自官方文件 Create custom agents for Copilot CLI，查核日 2026-07-18)

B.4 Hooks 事件命名風格對照：camelCase vs PascalCase

四家都有生命週期 hooks 機制，但事件命名風格上，Copilot CLI 是唯一一個走小駝峰（camelCase）的。

(料源：mixed——Claude Code／Codex CLI 事件名取自本站對應單元既有正文；Gemini CLI 部分本次研究未逐一查證完整事件清單，老實標註待查，只確認命名同樣偏 PascalCase 但分類邏輯是另一套設計；Copilot CLI 官方 6 個事件取自 Use hooks in Copilot CLI 與 Hooks reference，查核日 2026-07-18)

Copilot CLI 的 hooks 還有一條特有的硬性規定：同一個 hook 要同時準備 bash 跟 PowerShell 兩份腳本，因為它要跨 macOS／Linux／Windows 都能執行，不像其他三家通常只認一種 shell 腳本格式。

B.5 全篇最大觀念差異：指示檔案「全部合併」vs「就近覆蓋」

這是四方對照裡張力最大的一組，也是遷移讀者最容易帶錯心智模型的地方——但實際情況比「三家覆蓋、一家合併」更細緻，值得把每家的規則攤開來看清楚。

(料源：mixed——Codex CLI／Claude Code／Gemini CLI 規則取自本站對應單元既有正文查證內容；Copilot CLI 規則取自官方文件 Add custom instructions for Copilot CLI「How multiple instruction files interact」段落逐字查證，查核日 2026-07-18)

翻成白話排一次順位（從「規則最硬」到「規則最鬆」）：Codex（硬性近者覆寫）→ Claude（跨層硬順序＋同層軟疊加）→ Gemini（全串接＋軟性慣例，連官方都提醒不保證）→ Copilot（全合併＋官方明講不承諾順序）。如果你是 Codex CLI 老手，最容易犯的錯就是把「子目錄那份會蓋過根目錄那份」的直覺帶進 Copilot CLI——這在 Copilot CLI 完全不成立，官方連「慣例」都不給你，實務上唯一安全的做法是：不同層級的守則檔裡，別寫互相矛盾的規則，各自負責不重疊的範圍。

好消息放在最後：雖然指示檔案的合併規則四家互不相同，但 Skills 目錄的相容性是一個例外。Copilot CLI 官方文件把 .claude/skills/ 直接列為專案層可用的三個 Skills 存放路徑之一（另外兩個是 .github/skills/ 與 .agents/skills/）——也就是說，如果你原本是 Claude Code 使用者、已經寫好一批 .claude/skills/<name>/SKILL.md，直接把 Copilot CLI 加進同一個專案，這批技能不用搬家、原封不動就能被讀到。這是可查證的官方生態系互相借鏡實例，第 12 章會完整展開。

B.6 遷移落實檢查清單

照著這張清單一條一條做，就能把你熟悉的那一家搬到 Copilot CLI。每條都標了對應章節，卡住就回去翻。

1. 確認你裝的是新版：跑一次 copilot --version，確認裝的是獨立 npm 套件 @github/copilot，不是已停用的 gh copilot 擴充功能。（第 2 章）
2. 記憶檔不用搬：你的 CLAUDE.md／AGENTS.md／GEMINI.md 直接留在原地，Copilot CLI 會原生讀取，不用複製或改檔名。⚠️ 但要重新檢視守則裡有沒有互相矛盾的規則——B.5 講過的「全合併、不定義優先順序」在這裡最容易踩雷。（第 5 章）
3. 登入方式換一套：不管你原本用哪家帳號登入，Copilot CLI 一律走 GitHub 帳號的 OAuth device flow，互動內打 /login。（第 3 章）
4. 權限模型重新設定：把你熟悉的 allow/deny 或 approval policy，轉換成 Copilot CLI 的 --allow-tool/--deny-tool（deny 永遠贏）；全放行旗標是 --allow-all（別名 --yolo），官方紅線警告只能在隔離環境用，絕對不要寫進 alias。（第 6 章）
5. Skills 幾乎零改：.claude/skills/* 可以直接沿用，Copilot CLI 官方相容這個路徑。（第 12 章）
6. 自訂代理要重寫：.claude/agents/*.md、.codex/agents/*.toml、.gemini/agents/*.md 都要改寫成 Copilot CLI 的 .agent.md 格式，存到 .github/agents/ 或 ~/.copilot/agents/；必填欄位只有 name 跟 description，相對簡單。（B.3）
7. Hooks 事件名記得改小寫開頭：PreToolUse → preToolUse，PostToolUse → postToolUse，以此類推；別忘了 bash／PowerShell 兩份腳本都要準備。（B.4）
8. MCP 設定重新接一次：把 .mcp.json／config.toml／settings.json 裡的 MCP server 定義，改寫進 ~/.copilot/mcp-config.json，或用互動 /mcp add。⚠️ GitHub 官方 MCP server 這一項可以刪掉不用手動加——Copilot CLI 內建、預設只開唯讀工具。（第 9 章）
9. 額度池要重新確認：CLI 用量跟 IDE 版 Copilot Chat 共用同一個 premium request／AI Credits 額度池，不是獨立一份，導入前先跟團隊或組織管理員確認額度夠不夠用。（第 15 章）

小結

這一章是你的「翻譯字典」加「搬家清單」。開頭先處理 Copilot CLI 特有的歷史包袱——舊的 gh copilot（GitHub CLI 擴充功能，只能建議／解釋指令，2025-10-25 已停止運作）跟新的獨立 copilot 指令（本書主角，讀寫檔案、跑指令、開 PR 的全能 agent）是兩個完全不同的東西，判斷法是看指令有沒有 gh 開頭。B.1 整理了核心中英名詞速查。B.2 做了 Claude Code／Codex CLI／Gemini CLI 三家 → Copilot CLI 的核心對照表，涵蓋啟動、非互動模式、登入、恢復對話、記憶檔、設定檔、權限模型、MCP 設定。B.3 講清楚 Copilot CLI 用「custom agent」而不是「subagent」這個詞，四家的檔案位置、格式、呼叫方式都不一樣。B.4 對照 hooks 事件命名——Copilot CLI 是四家裡唯一用 camelCase 的，其餘三家（有查證資料的部分）偏 PascalCase。B.5 是全篇分量最重的一節：四家指示檔案的合併規則其實排成一條光譜，從 Codex 的硬性「近者覆寫」，到 Claude 的「跨層硬順序＋同層軟疊加」，到 Gemini 的「全串接＋官方自己都不保證的軟性慣例」，最後是 Copilot CLI 最直白的「全部合併、官方明講不定義優先順序、請自行避免衝突」——但好消息是 Skills 目錄相容 .claude/skills/，這批技能不用搬家。B.6 收尾一份可以直接照著打勾的遷移落實檢查清單。

動手試試

1. 打開你電腦裡的 ~/.zshrc 或 ~/.bashrc，搜尋看看有沒有殘留 ghcs／ghce 這兩個舊版別名——如果有，代表你之前裝過舊版 gh copilot 擴充，可以放心清掉。
2. 挑一個你已經在用 Claude Code 或 Codex CLI 開發的專案，直接在同一個資料夾裝好 Copilot CLI，打開互動模式後用 /instructions（見第 5 章）確認它有沒有自動讀到你既有的 CLAUDE.md 或 AGENTS.md，不用你多做任何設定。
3. 如果你的專案已經有 .claude/skills/ 目錄，開 Copilot CLI 打 /skills reload 之後用 /skills info <name> 確認技能被正確載入——親自驗證 B.5 提到的「Skills 相容性」不是空話。
4. 對照 B.2 那張核心表，挑三個你最常用的指令（例如非互動模式、恢復對話、登入），在自己電腦上實際各打一次 Copilot CLI 的對應版本，感受一下跟你原本工具的差異有多大。
5. 故意在專案根目錄與子目錄各寫一份指示檔案，內容互相矛盾（例如一個要求「用 npm」、另一個要求「用 pnpm」），實際觀察 Copilot CLI 聽了哪一條——親身體會一次 B.5 講的「官方不定義優先順序」在實機上長什麼樣子。

本章官方文件參考

• 舊擴充棄用公告：https://github.blog/changelog/2025-09-25-upcoming-deprecation-of-gh-copilot-cli-extension/
• GA 正式公告：https://github.blog/changelog/2026-02-25-github-copilot-cli-is-now-generally-available/
• 自訂指示檔案（B.5 主要來源）：https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/add-custom-instructions
• 建立自訂代理（B.3 主要來源）：https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/create-custom-agents-for-cli
• Hooks 使用說明與參考（B.4 主要來源）：https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/use-hooks、https://docs.github.com/en/copilot/reference/hooks-reference
• 新增 Skills：https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/add-skills
• 新增 MCP servers：https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers