Copilot CLI

📖 本篇術語速查表

英文 / 縮寫	中文	一句話解釋
Copilot CLI	命令列	在終端委派 Copilot 跑任務。
自動化	automation	接進指令碼和 CI。
許可權邊界	scope	CLI 能改什麼、跑什麼。

不想讀完？把下面這段提示詞丟給 AI 幫你跑完——幫你判斷什麼場景該用 Copilot CLI、怎麼安全接入。

你是 Copilot CLI 導航顧問。

【角色】
Copilot CLI 導航顧問，按最小夠用、安全優先的原則給可落地方案，每條結論都落到能照做的步驟或示例，不停留在空泛建議。

【輸入】
- 我想用 CLI 做什麼：___
- 是否要進指令碼 / CI：___
- 涉及的寫操作和命令：___
- 執行環境：___
- 經驗水平：___

【工作流程】
1. 判斷 CLI 是否比 IDE 更合適
2. 說明能做什麼
3. 標出許可權和高危邊界
4. 說明自動化接入注意點
5. 給第一步

【輸出規範】
▌一、是否該用 CLI
▌二、能力
▌三、許可權 / 高危邊界
▌四、自動化注意 + 第一步

【硬約束】
- 按場景選 CLI，不為用而用
- 高危命令預設審批
- 自動化裡憑據安全注入
- 不要替我臆測情況或編造不存在的功能，資訊不全先問清
- 不確定的設定或許可權一律以官方文件為準，禁止照搬過時寫法

GitHub Copilot CLI 把 Copilot 放進終端。它可以回答問題、寫程式碼、除錯、與 GitHub.com 互動，也可以用程式化（programmatic）方式接入指令碼。

這組頁面不把 CLI 當"命令直譯器"輕描淡寫。官方文件已經把它描述成"原生於終端的 AI 程式設計助手"：它能讀寫檔案、執行 shell commands、呼叫工具、管理 PR，也能進入 autopilot 自動模式——能力越靠近終端，越需要許可權、審查和回復這條配套鏈。

閱讀目標：讀完本組索引，你應該能把 Copilot CLI 放進可回復、可審查、可限制工具許可權的終端工作流。

1. 工作流地圖

安裝認證：用 npm、Homebrew、WinGet 或安裝指令碼安裝；首次啟動用 /login。
設定邊界：確認 trusted directories、allowed tools、path permissions、URL permissions。
互動使用：輸入 copilot 啟動 session，用 Ask / Plan / Execute 處理任務。
非互動使用：用 -p 或 --prompt 從命令列傳入一次性 prompt。
委派任務：用 autopilot 在本地執行，或用 /delegate 交給 cloud agent。
回復：用雙擊 Esc 或 /undo 回到某個 prompt 前的 snapshot。

flowchart TD
    Install["安裝 Copilot CLI"] --> Login["/login 認證"]
    Login --> Trust["確認 trusted directory"]
    Trust --> Mode{"使用方式"}
    Mode --> Interactive["Interactive session"]
    Mode --> Programmatic["-p / --prompt"]
    Interactive --> Tools["工具批准 / allow-deny"]
    Programmatic --> Tools
    Tools --> Work["讀寫檔案 / shell / GitHub"]
    Work --> Review["diff / test / PR"]
    Review --> Rollback{"需要回復?"}
    Rollback -->|是| Undo["Esc Esc / /undo"]
    Rollback -->|否| Done["提交或 PR review"]

    style Trust fill:#fef3c7,stroke:#d97706,stroke-width:2px
    style Review fill:#dcfce7,stroke:#16a34a,stroke-width:2px
    style Undo fill:#fee2e2,stroke:#dc2626,stroke-width:2px