# 啟動互動式 Session
copilot

# 單次提示執行
copilot -p "顯示本週的 commits 並摘要" --allow-tool 'shell(git)'

# 搭配腳本
./script-outputting-options.sh | copilot

# 使用環境變數設定 PAT（依優先順序）
export GH_TOKEN="github_pat_xxxx"
# 或
export GITHUB_TOKEN="github_pat_xxxx"

# 安裝正式版
winget install GitHub.Copilot

# 安裝預覽版
winget install GitHub.Copilot.Prerelease

# 安裝後驗證
copilot --version

# 安裝正式版
brew install copilot-cli

# 安裝預覽版
brew install copilot-cli@prerelease

# 驗證
copilot --version

# 使用 curl
curl -fsSL https://gh.io/copilot-install | bash

# 或使用 wget
wget -qO- https://gh.io/copilot-install | bash

# 確認架構
uname -m
# 預期輸出：arm64

# 確認 Homebrew 安裝在正確路徑
which brew
# 預期：/opt/homebrew/bin/brew

brew install copilot-cli

# 一般使用者安裝（預設安裝至 $HOME/.local/bin）
curl -fsSL https://gh.io/copilot-install | bash

# 以 root 安裝至 /usr/local/bin
curl -fsSL https://gh.io/copilot-install | sudo bash

# 指定版本與自訂安裝目錄
curl -fsSL https://gh.io/copilot-install | VERSION="v0.0.410" PREFIX="$HOME/custom" bash

# 前提：需要 Node.js 22 或更新版本
node --version  # 需 >= 22.x

# 安裝正式版
npm install -g @github/copilot

# 安裝預覽版
npm install -g @github/copilot@prerelease

# 檢查 Copilot CLI 版本
copilot --version

# 顯示說明
copilot -h

# 啟動互動模式（首次會引導登入）
copilot

# 設定系統環境變數（永久生效）
[System.Environment]::SetEnvironmentVariable("HTTPS_PROXY", "http://proxy.company.com:8080", "User")
[System.Environment]::SetEnvironmentVariable("HTTP_PROXY", "http://proxy.company.com:8080", "User")
[System.Environment]::SetEnvironmentVariable("NO_PROXY", "localhost,127.0.0.1,.company.com", "User")

# 或在當前 Session 設定（暫時）
$env:HTTPS_PROXY = "http://proxy.company.com:8080"
$env:HTTP_PROXY = "http://proxy.company.com:8080"
$env:NO_PROXY = "localhost,127.0.0.1,.company.com"

# 加入 ~/.bashrc 或 ~/.zshrc（永久生效）
export HTTPS_PROXY="http://proxy.company.com:8080"
export HTTP_PROXY="http://proxy.company.com:8080"
export NO_PROXY="localhost,127.0.0.1,.company.com"

# 套用設定
source ~/.bashrc

export HTTPS_PROXY="http://username:password@proxy.company.com:8080"

# 出站（Outbound）規則
目的地                                        埠號    通訊協定
─────────────────────────────────────────────────────────────
github.com                                    443     HTTPS
api.github.com                                443     HTTPS
copilot-proxy.githubusercontent.com           443     HTTPS
default.exp-tas.com                           443     HTTPS
copilot-telemetry.githubusercontent.com       443     HTTPS
objects.githubusercontent.com                 443     HTTPS
github-cloud.githubusercontent.com            443     HTTPS

# 如企業使用自簽 CA 憑證
# 方法一：設定 Node.js 環境變數（npm 安裝方式適用）
export NODE_EXTRA_CA_CERTS="/path/to/company-ca.crt"

# 方法二：設定 Git SSL 憑證
git config --global http.sslCAInfo /path/to/company-ca.crt

#!/bin/bash
# test_connectivity.sh - 測試 Copilot CLI 所需的網路連線

ENDPOINTS=(
  "github.com"
  "api.github.com"
  "copilot-proxy.githubusercontent.com"
  "default.exp-tas.com"
  "copilot-telemetry.githubusercontent.com"
)

echo "=== GitHub Copilot CLI 網路連線測試 ==="
for endpoint in "${ENDPOINTS[@]}"; do
  if curl -s --connect-timeout 5 "https://${endpoint}" > /dev/null 2>&1; then
    echo "✅ ${endpoint} - 連線成功"
  else
    echo "❌ ${endpoint} - 連線失敗"
  fi
done

# Test-CopilotConnectivity.ps1
$endpoints = @(
    "github.com",
    "api.github.com",
    "copilot-proxy.githubusercontent.com",
    "default.exp-tas.com",
    "copilot-telemetry.githubusercontent.com"
)

Write-Host "=== GitHub Copilot CLI 網路連線測試 ===" -ForegroundColor Cyan
foreach ($endpoint in $endpoints) {
    try {
        $result = Invoke-WebRequest -Uri "https://$endpoint" -TimeoutSec 5 -UseBasicParsing -ErrorAction Stop
        Write-Host "✅ $endpoint - 連線成功" -ForegroundColor Green
    } catch {
        Write-Host "❌ $endpoint - 連線失敗: $($_.Exception.Message)" -ForegroundColor Red
    }
}

# 步驟 1：啟動 Copilot CLI
copilot

# 步驟 2：確認信任當前目錄
# 選擇：
# 1. Yes, proceed（僅本次 Session 信任）
# 2. Yes, and remember this folder for future sessions（永久信任）
# 3. No, exit (Esc)（離開）

# 步驟 3：如未登入，輸入 /login
/login

# 步驟 4：依螢幕指示開啟瀏覽器、輸入裝置代碼完成認證

# 使用 GH_TOKEN（優先）或 GITHUB_TOKEN
export GH_TOKEN="github_pat_xxxxxxxxxxxx"

# 啟動 CLI（會自動使用環境變數中的 Token）
copilot

# GitHub Actions 範例
- name: Run Copilot CLI
  env:
    GH_TOKEN: ${{ secrets.COPILOT_PAT }}
  run: |
    copilot -p "Analyze the code changes" --allow-all-tools

建議配置：
├── 開發團隊（Dev Team） ─────── Copilot 授權 ✅ + CLI 政策啟用
├── QA 團隊 ─────────────────── Copilot 授權 ✅ + CLI 政策啟用
├── DevOps 團隊 ─────────────── Copilot 授權 ✅ + CLI 政策啟用
├── 管理職 ──────────────────── 視需求 ⚠️
└── 外包人員 ────────────────── 需額外評估 ⚠️

# 查看設定說明
copilot help config

# 查看環境變數說明
copilot help environment

# 查看日誌設定
copilot help logging

# 查看權限設定
copilot help permissions

# Bash / Zsh - 加入 ~/.bashrc 或 ~/.zshrc
alias cop='copilot'
alias copp='copilot -p'

# PowerShell - 加入 $PROFILE
function cop { copilot @args }
function copp { copilot -p @args }

# 顯示 Profile 路徑
Write-Host $PROFILE

{
  "trusted_folders": [
    "/home/developer/projects/my-app",
    "/home/developer/projects/api-server"
  ]
}

# 新增目錄到當前 Session
/add-dir /path/to/other/project

# 列出當前可存取的目錄
/list-dirs

# 切換工作目錄
/cwd /path/to/directory
# 或
/cd /path/to/directory

# ❌ 不要這樣做
export GH_TOKEN="github_pat_xxxx"  # 寫在 .bashrc 中

# ✅ 建議做法：使用密鑰管理工具
# macOS - 使用 Keychain
security add-generic-password -a "github-copilot" -s "GH_TOKEN" -w "github_pat_xxxx"

# Linux - 使用 pass
pass insert github/copilot-token
export GH_TOKEN=$(pass show github/copilot-token)

# Windows - 使用 Credential Manager 或環境變數

# 啟動互動模式
copilot

# 直接用自然語言提問或下達任務
# 範例提示：

> 這個專案的架構是什麼？請說明主要目錄結構
> 找出 src/main/java 中所有的 REST Controller
> 解釋 UserService.java 中的認證邏輯

> 在 src/main/java/com/app/ 下建立 UserController.java，包含 CRUD 端點
> 修改 pom.xml，加入 Spring Security 依賴
> 重寫 README.md，讓新人更容易理解

> 列出 CPU 使用率最高的前 10 個程序
> 找出 port 8080 被哪個程序占用
> 清理所有停止的 Docker 容器和未使用的映像

# 在互動模式中使用 ! 前綴直接執行 Shell 指令
!git status
!docker ps
!mvn clean compile

# 方法一：在互動模式中按 Shift+Tab 切換至計畫模式
# 方法二：使用 /plan 指令
/plan 新增 OAuth2 認證，支援 Google 和 GitHub 登入

# Implementation Plan: OAuth2 Authentication

## Overview
Add social authentication using OAuth2 with Google and GitHub providers.

## Tasks
- [ ] Install dependencies (passport, passport-google-oauth20, passport-github2)
- [ ] Create authentication routes in `/api/auth`
- [ ] Implement passport strategies for each provider
- [ ] Add session management middleware
- [ ] Create login/logout UI components
- [ ] Add environment variables for OAuth credentials
- [ ] Write integration tests

> Read the authentication files but don't write code yet     # 探索
> /plan Implement password reset flow                        # 計畫
> （審閱計畫，提出修改建議）                                    # 審閱
> Proceed with the plan                                      # 實作
> Run the tests and fix any failures                         # 驗證
> Commit these changes with a descriptive message            # 提交

# 基本用法
copilot -p "顯示本週的 commits 並摘要" --allow-tool 'shell(git)'

# 允許所有工具（⚠️ 注意安全風險）
copilot -p "Revert the last commit" --allow-all-tools

# 限制特定工具
copilot -p "分析程式碼品質" --allow-tool 'shell' --deny-tool 'shell(rm)'

# 從腳本管道輸入
echo "Fix all lint errors in src/" | copilot --allow-tool 'write'

# 引用特定檔案作為上下文
> Explain @config/ci/ci-required-checks.yml
> Fix the bug in @src/app.js
> 根據 @docs/API.md 的規格，實作 UserController

# 查看目前上下文使用情況
/context

# 手動壓縮對話歷史
/compact

# 查看使用統計
/usage

# 清除對話、開始新話題
/clear
# 或
/new

# 建立完整的 Next.js 應用
> Use the create-next-app kit and tailwind CSS to create a next.js app.
> The app should be a dashboard built with data from the GitHub API.
> After creating the app, give me easy to follow instructions on how to build,
> run, and view the app in my browser.

# 建立 Spring Boot 專案骨架
> 建立一個 Spring Boot 3.4 + Java 21 的 REST API 專案，
> 包含 User CRUD 端點、JPA + PostgreSQL、Spring Security JWT 認證。
> 使用 Clean Architecture 目錄結構。

# 重構建議
> Suggest improvements to @src/services/UserService.java
> 重構這個專案中所有 class components 為 functional components with hooks

# 搭配計畫模式的重構
> /plan Migrate all class components to functional components with hooks

# 使用 /review 指令
/review

# 指定 Review 重點
> /review Use Opus 4.5 and Codex 5.2 to review the changes in my current branch
> against main. Focus on potential bugs and security issues.

# 使用 TDD 工作流程
> Write failing tests for the user registration flow
# （審閱測試）
> Now implement code to make all tests pass
# （審閱實作）
> Commit with message "feat: add user registration"

# 產生 JUnit 測試
> 為 @src/main/java/com/app/UserService.java 撰寫 JUnit 5 測試案例，
> 包含正常和異常情境，使用 Mockito

# 產生 API 整合測試
> 使用 Spring MockMvc 為 UserController 的所有端點撰寫整合測試

# 產生 E2E 測試
> 使用 Playwright 撰寫使用者登入流程的 E2E 測試

# 產生最佳化 Dockerfile
> 為 Java 21 Spring Boot 應用撰寫多階段建置 Dockerfile，
> 使用 Eclipse Temurin 基底映像、非 root 使用者、健康檢查

# 產生 docker-compose.yml
> 撰寫 docker-compose.yml 開發環境，包含 app、postgres、redis、kafka

# 產生 GitHub Actions Workflow
> Branch off from main and create a GitHub Actions workflow that will run
> on pull requests. The workflow should run eslint, and if errors are found,
> the workflow should cause the PR check to fail.
> Push the new branch and create a pull request.

# Git 操作
> Commit the changes to this repo
> Revert the last commit, leaving the changes unstaged
> Rebase this branch against main
> Resolve the merge conflicts in package.json
> What changes went into version 2.3.0?

# Pull Request 管理
> List my open PRs
> Create a PR for this branch with a detailed description
> Check the changes made in PR https://github.com/org/repo/pull/123.
> Report any serious errors.
> Merge all of the open PRs that I've created in org/repo
> Close PR #11 on org/repo

# Issue 管理
> List all open issues assigned to me in org/repo
> I've been assigned this issue: https://github.com/org/repo/issues/1234.
> Start working on this for me in a suitably named branch.
> Raise an improvement issue in org/repo about the file handling bug

# 允許所有工具（⚠️ 高風險）
copilot --allow-all-tools
# 或
copilot --allow-all
# 或
copilot --yolo

# 允許特定工具
copilot --allow-tool 'shell(git)'
copilot --allow-tool 'shell(npm run:*)'
copilot --allow-tool 'write'

# 禁止特定工具
copilot --deny-tool 'shell(rm)'
copilot --deny-tool 'shell(git push)'

# 組合使用：允許所有但禁止危險操作
copilot --allow-all-tools --deny-tool 'shell(rm)' --deny-tool 'shell(git push)'

# 允許 MCP Server 工具
copilot --allow-tool 'My-MCP-Server'
copilot --deny-tool 'My-MCP-Server(dangerous_tool)'

# 預設只能存取當前目錄和子目錄
# 允許所有路徑（⚠️ 高風險）
copilot --allow-all-paths

# 允許特定 URL
copilot --allow-url github.com

# 允許所有 URL
copilot --allow-all-urls

# 在互動模式中
/reset-allowed-tools

## Build Commands
- `mvn clean compile` - Build the project
- `mvn test` - Run all tests
- `mvn verify` - Run all checks

## Code Style
- Use Java 21+ features
- Follow Clean Architecture pattern
- Always add JavaDoc comments for public APIs
- Use Log4j2 for logging

## Workflow
- Run `mvn verify` after making changes
- Commit messages follow Conventional Commits format
- Create feature branches from `main`

# 方法一：使用 /agent 指令選擇
/agent

# 方法二：在提示中直接提及
> Use the refactoring agent to refactor this code block

# 方法三：命令列指定
copilot --agent=refactor-agent --prompt "Refactor this code block"

# 使用技能
> 使用 security-audit 技能檢查這個專案的安全性

# 在互動模式中切換模型
/model

# 命令列指定模型
copilot --model "claude-opus-4.5"

# 使用 GitHub MCP Server 的範例
> List my open PRs
> Create a PR for this branch with a detailed description
> Use the GitHub MCP server to find good first issues from org/repo
> List any Actions workflows in this repo that add comments to PRs
> Merge all of the open PRs that I've created in org/repo

# 在互動模式中
/mcp add

# 填寫 MCP Server 詳細資訊，使用 Tab 切換欄位
# 按 Ctrl+S 儲存

{
  "mcpServers": {
    "database-query": {
      "command": "npx",
      "args": ["-y", "@company/mcp-database-server"],
      "env": {
        "DB_HOST": "db.company.com",
        "DB_PORT": "5432",
        "DB_NAME": "production_readonly"
      }
    },
    "internal-api": {
      "command": "python",
      "args": ["/opt/mcp-servers/api-server/main.py"],
      "env": {
        "API_BASE_URL": "https://api.internal.company.com",
        "API_KEY_FILE": "/etc/secrets/api-key"
      }
    }
  }
}

{
  "mcpServers": {
    "remote-api-server": {
      "url": "https://mcp.internal.company.com/sse",
      "headers": {
        "Authorization": "Bearer ${MCP_AUTH_TOKEN}"
      }
    }
  }
}

# 在互動模式中查看已設定的 MCP Server
/mcp

# 查看特定 MCP Server 的工具清單
# 選擇 Server 後即可查看

// mcp-server/index.js
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { z } from "zod";

const server = new McpServer({
  name: "company-tools",
  version: "1.0.0",
  description: "企業內部工具 MCP Server"
});

// 定義工具：查詢員工資訊
server.tool(
  "query-employee",
  "查詢員工資訊",
  {
    employeeId: z.string().describe("員工編號")
  },
  async ({ employeeId }) => {
    const response = await fetch(
      `${process.env.HR_API_URL}/employees/${employeeId}`,
      {
        headers: {
          "Authorization": `Bearer ${process.env.HR_API_TOKEN}`
        }
      }
    );
    const data = await response.json();

    return {
      content: [{
        type: "text",
        text: JSON.stringify(data, null, 2)
      }]
    };
  }
);

// 定義工具：檢查系統健康狀態
server.tool(
  "check-system-health",
  "檢查內部系統健康狀態",
  {
    systemName: z.string().describe("系統名稱")
  },
  async ({ systemName }) => {
    const response = await fetch(
      `${process.env.MONITOR_URL}/api/health/${systemName}`
    );
    const status = await response.json();

    return {
      content: [{
        type: "text",
        text: `系統 ${systemName} 狀態：${status.healthy ? '✅ 正常' : '❌ 異常'}\n延遲：${status.latency}ms`
      }]
    };
  }
);

// 啟動 Server
const transport = new StdioServerTransport();
await server.connect(transport);

# mcp_server/main.py
from mcp.server import Server
from mcp.server.stdio import stdio_server
from mcp.types import TextContent
import httpx
import os
import json

server = Server("company-tools")

@server.tool()
async def query_database(query: str, database: str = "default") -> list[TextContent]:
    """
    執行唯讀 SQL 查詢（僅支援 SELECT）

    Args:
        query: SQL 查詢語句（僅限 SELECT）
        database: 資料庫名稱
    """
    if not query.strip().upper().startswith("SELECT"):
        return [TextContent(
            type="text",
            text="❌ 錯誤：僅允許 SELECT 查詢"
        )]

    async with httpx.AsyncClient() as client:
        response = await client.post(
            f"{os.environ['DB_PROXY_URL']}/query",
            json={"sql": query, "database": database},
            headers={"Authorization": f"Bearer {os.environ['DB_TOKEN']}"}
        )
        result = response.json()

    return [TextContent(
        type="text",
        text=json.dumps(result, indent=2, ensure_ascii=False)
    )]

async def main():
    async with stdio_server() as (read_stream, write_stream):
        await server.run(read_stream, write_stream)

if __name__ == "__main__":
    import asyncio
    asyncio.run(main())

{
  "mcpServers": {
    "company-api": {
      "command": "node",
      "args": ["./mcp-servers/api-gateway-bridge/index.js"],
      "env": {
        "API_GATEWAY_URL": "https://gateway.company.com",
        "API_CLIENT_ID": "copilot-mcp-client",
        "API_CLIENT_SECRET_FILE": "/etc/secrets/api-client-secret",
        "ALLOWED_ENDPOINTS": "/api/v1/accounts,/api/v1/transactions,/api/v1/reports",
        "MAX_REQUESTS_PER_MINUTE": "30"
      }
    }
  }
}

{
  "mcpServers": {
    "secure-db-query": {
      "command": "node",
      "args": ["./mcp-servers/db-query/index.js"],
      "env": {
        "DB_CONNECTION": "readonly-replica.company.com",
        "DB_USER": "mcp_readonly",
        "DB_PASSWORD_FILE": "/etc/secrets/db-password",
        "ALLOWED_TABLES": "users,products,orders",
        "BLOCKED_COLUMNS": "password_hash,ssn,credit_card",
        "MAX_ROWS": "1000",
        "QUERY_TIMEOUT_MS": "5000",
        "AUDIT_LOG_PATH": "/var/log/mcp/db-query.log"
      }
    }
  }
}

# .github/workflows/copilot-assisted-review.yml
name: Copilot Assisted Review

on:
  pull_request:
    types: [opened, synchronize]

permissions:
  contents: read
  pull-requests: write

jobs:
  ai-review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - name: Install Copilot CLI
        run: |
          curl -fsSL https://gh.io/copilot-install | bash

      - name: AI Code Review
        env:
          GH_TOKEN: ${{ secrets.COPILOT_PAT }}
        run: |
          copilot -p "Review the changes in this PR and summarize potential issues" \
            --allow-tool 'shell(git)' \
            --deny-tool 'shell(rm)' \
            --deny-tool 'shell(git push)'

# 在 Copilot CLI 互動模式中
> Branch off from main and create a GitHub Actions workflow that will run
> on pull requests, or can be run manually. The workflow should run eslint
> to check for problems. If errors are found, the workflow should cause the
> PR check to fail. Push the new branch and create a pull request.

#!/bin/bash
# scripts/ci-copilot-checks.sh

# 使用 Copilot 生成變更日誌
generate_changelog() {
    local last_tag=$(git describe --tags --abbrev=0 2>/dev/null || echo "HEAD~10")
    local log=$(git log ${last_tag}..HEAD --oneline)

    copilot -p "根據以下 git log，產生結構化的 CHANGELOG 條目：${log}" \
        --allow-tool 'write' \
        --deny-tool 'shell(rm)'
}

# 使用 Copilot 分析程式碼品質
analyze_quality() {
    copilot -p "分析 src/ 目錄中的程式碼品質，報告潛在的 Bug 和效能問題" \
        --allow-tool 'shell(grep)' \
        --allow-tool 'shell(find)' \
        --deny-tool 'shell(rm)'
}

# 主流程
case "$1" in
    changelog) generate_changelog ;;
    analyze) analyze_quality ;;
    *) echo "Usage: $0 {changelog|analyze}"; exit 1 ;;
esac

# 使用 Copilot CLI 輔助容器化開發

# 1. 產生最佳化的 Dockerfile
> 為 Java 21 Spring Boot 應用產生 Production-ready Dockerfile，
> 包含健康檢查、非 root 使用者、多階段建置

# 2. Docker 故障排除
> Docker container 一直重啟，如何查看原因

# 3. 映像安全掃描
> 使用 Trivy 掃描 Docker 映像漏洞並產生 JSON 報告

# 4. Kubernetes 資源產生
> 為 Spring Boot 應用產生 Kubernetes Deployment、Service、Ingress YAML

# 在互動模式中
/review

# 指定 Review 範圍和重點
> /review Use Opus 4.5 and Codex 5.2 to review the changes in my current branch
> against main. Focus on potential bugs and security issues.

# 查看 PR 變更並請 AI 分析
> Check the changes made in PR https://github.com/org/repo/pull/42.
> Report any serious errors you find in these changes.

# 針對特定安全性問題
> 審查 PR #42 的變更，特別注意：
> 1. SQL Injection 風險
> 2. XSS 漏洞
> 3. 認證和授權問題
> 4. 敏感資料洩漏

# 方法一：使用 /delegate 指令
/delegate complete the API integration tests and fix any failing edge cases

# 方法二：使用 & 前綴
& Add dark mode support to the settings page

# 方法三：在 Session 外委派
copilot -p "Update the documentation" --delegate

# 產生 Conventional Commit Message
> Commit these changes with a descriptive message following Conventional Commits format

# 建立 PR 並附帶詳細描述
> Create a PR for this branch with a detailed description

# Conventional Commit 格式範例
# feat(auth): 新增 JWT Token 刷新機制
# fix(api): 修正使用者查詢 N+1 問題
# docs(readme): 更新安裝說明
# refactor(service): 重構訂單處理邏輯
# test(user): 新增使用者註冊測試案例
# ci(pipeline): 加入 SonarQube 分析步驟

# 查看當前版本
copilot --version

# 升級至最新版
# Windows
winget upgrade GitHub.Copilot

# macOS / Linux (Homebrew)
brew upgrade copilot-cli

# npm
npm update -g @github/copilot

# 安裝腳本
curl -fsSL https://gh.io/copilot-install | bash

# 安裝特定版本（安裝腳本）
curl -fsSL https://gh.io/copilot-install | VERSION="v0.0.410" bash

#!/bin/bash
# scripts/check-copilot-version.sh

REQUIRED_VERSION="0.0.410"

CURRENT_VERSION=$(copilot --version 2>/dev/null | grep -oP '\d+\.\d+\.\d+')

if [ -z "$CURRENT_VERSION" ]; then
    echo "❌ Copilot CLI 未安裝"
    exit 1
fi

echo "✅ Copilot CLI 版本：$CURRENT_VERSION（要求：>= $REQUIRED_VERSION）"

# Windows - 安裝特定版本
winget install GitHub.Copilot --version 0.0.xxx

# macOS / Linux - 使用安裝腳本指定版本
curl -fsSL https://gh.io/copilot-install | VERSION="v0.0.xxx" bash

# npm - 安裝特定版本
npm install -g @github/copilot@0.0.xxx

# 查看日誌設定說明
copilot help logging

# 設定環境變數啟用日誌
# （詳細設定請參考 copilot help logging 的輸出）

# 查看使用統計
/usage
# 顯示：Premium Requests 使用量、Session 時長、編輯行數、Token 使用分佈

# 查看當前 Session 資訊
/session

# 查看 Session 檢查點
/session checkpoints

# 查看特定檢查點詳情
/session checkpoints 1

# 查看 Session 中建立的臨時檔案
/session files

# 查看當前計畫
/session plan

# 恢復之前的 Session
/resume
# 或命令列
copilot --resume

# 快速恢復最近關閉的 Session
copilot --continue

~/.copilot/session-state/{session-id}/
├── events.jsonl      # 完整 Session 歷史
├── workspace.yaml    # 中繼資料
├── plan.md           # 實作計畫（若有）
├── checkpoints/      # 壓縮歷史
└── files/            # 持久化檔案

# ❌ 不安全的 Prompt
> 修正這段包含資料庫密碼 'P@ssw0rd123' 的連線字串

# ✅ 安全的 Prompt
> 如何使用環境變數設定 JDBC 資料庫連線字串

# ❌ 不安全的 Prompt
> 解釋 @src/main/java/com/company/core/TradingEngine.java（含高度機密邏輯）

# ✅ 安全的 Prompt
> 如何實作交易引擎的冪等性（idempotency）設計

## 團隊 Prompt 模板

### API 開發
> 使用 {framework} 建立 {resource} 的 REST API，
> 包含 CRUD 操作、輸入驗證、錯誤處理和 OpenAPI 文件。
> 使用 {language} {version}。

### 計畫式重構
> /plan 將所有 {pattern} 重構為 {new_pattern}，
> 遵循 SOLID 原則，確保所有測試通過。

### Code Review
> /review 審查當前分支相對於 main 的變更，
> 專注於安全性風險和效能問題。

### 測試案例
> 為 @{file_path} 中的 {class}.{method}() 方法撰寫 {test_framework} 測試案例，
> 包含以下情境：正常路徑、邊界值、異常情境。
> 使用 Arrange-Act-Assert 模式。

📁 training/
├── Level-1-基礎篇/
│   ├── 01-安裝與設定.md
│   ├── 02-互動模式基本操作.md
│   ├── 03-安全規範.md
│   └── exercises/
├── Level-2-進階篇/
│   ├── 01-Plan-Mode-與-Custom-Instructions.md
│   ├── 02-MCP-串接.md
│   ├── 03-Custom-Agents-與-Skills.md
│   └── exercises/
├── Level-3-管理篇/
│   ├── 01-治理策略.md
│   ├── 02-成本管理.md
│   └── 03-風險控管.md
└── Level-4-DevOps篇/
    ├── 01-程式化模式與CI-CD整合.md
    ├── 02-Coding-Agent-委派.md
    └── exercises/

# 查看目前使用量
/usage

# 切換至較低成本的模型
/model
# 選擇 Sonnet 4.5

# 完整系統診斷
echo "=== 系統診斷 ==="
echo "OS: $(uname -a)"
echo "Copilot CLI: $(copilot --version 2>/dev/null || echo 'Not installed')"
echo ""
echo "Proxy:"
echo "  HTTP_PROXY: $HTTP_PROXY"
echo "  HTTPS_PROXY: $HTTPS_PROXY"
echo "  NO_PROXY: $NO_PROXY"
echo ""
echo "Connectivity:"
for endpoint in github.com api.github.com copilot-proxy.githubusercontent.com; do
  if curl -s --connect-timeout 5 "https://${endpoint}" > /dev/null 2>&1; then
    echo "  ✅ $endpoint"
  else
    echo "  ❌ $endpoint"
  fi
done
echo ""
echo "Config directory:"
ls -la ~/.copilot/ 2>/dev/null || echo "  ~/.copilot/ not found"

# PowerShell 版系統診斷
Write-Host "=== 系統診斷 ===" -ForegroundColor Cyan
Write-Host "OS: $([System.Environment]::OSVersion.VersionString)"
Write-Host "PowerShell: $($PSVersionTable.PSVersion)"
try {
    Write-Host "Copilot CLI: $(copilot --version 2>$null)"
} catch {
    Write-Host "Copilot CLI: Not installed" -ForegroundColor Red
}

Write-Host "`nProxy:"
Write-Host "  HTTP_PROXY: $env:HTTP_PROXY"
Write-Host "  HTTPS_PROXY: $env:HTTPS_PROXY"

Write-Host "`nConnectivity:"
$endpoints = @("github.com", "api.github.com", "copilot-proxy.githubusercontent.com")
foreach ($endpoint in $endpoints) {
    try {
        $null = Invoke-WebRequest -Uri "https://$endpoint" -TimeoutSec 5 -UseBasicParsing -ErrorAction Stop
        Write-Host "  ✅ $endpoint" -ForegroundColor Green
    } catch {
        Write-Host "  ❌ $endpoint" -ForegroundColor Red
    }
}

Write-Host "`nConfig directory:"
if (Test-Path "$env:USERPROFILE\.copilot") {
    Get-ChildItem "$env:USERPROFILE\.copilot" | Format-Table Name, Length, LastWriteTime
} else {
    Write-Host "  ~/.copilot/ not found" -ForegroundColor Yellow
}