Copilot CLI - AI 代码分析助手

Copilot CLI - AI 代码分析助手

功能

使用 GitHub Copilot CLI 分析代码、探索项目、生成代码和自动化开发任务。

前置条件

1. 安装 Copilot CLI

   brew install copilot-cli
   

2. 设置 GitHub Personal Access Token

   • 访问 https://github.com/settings/personal-access-tokens/new
   • 创建 fine-grained token，权限：Copilot Requests
   • Token 保存到 ~/.copilot/github_token.txt

使用方法

基本命令

# 进入项目目录
cd /path/to/project

# 使用 Copilot CLI（使用保存的 token）
COPILOT_GITHUB_TOKEN=$(cat ~/.copilot/github_token.txt) copilot -p "你的问题"

常用探索问题

项目概览：

"这个项目是做什么的？请简要说明。"

架构分析：

"分析这个项目的架构和主要模块。"

技术栈：

"这个项目使用了哪些主要技术栈和依赖？"

代码查找：

"找到处理用户认证的代码。"

文档生成：

"为这个模块生成文档。"

代码审查：

"审查这个文件，找出潜在问题。"

高级用法

指定文件：

copilot -p "解释 @src/main.js 的功能"

交互式会话：

COPILOT_GITHUB_TOKEN=$(cat ~/.copilot/github_token.txt) copilot

自动执行（需要权限）：

copilot --yolo -p "为这个功能编写单元测试"

注意事项

• Copilot CLI 使用 GitHub Copilot API 分析代码
• 代码存储位置不影响分析（可以是 GitLab、GitHub 等）
• 一次性查询使用 -p 参数
• 复杂任务使用交互式会话

配置文件

• Token 存储：~/.copilot/github_token.txt
• 配置目录：~/.copilot/
• 日志目录：~/.copilot/logs/

故障排查

策略限制错误

如果遇到 "Access denied by policy settings"：

1. 检查 https://github.com/settings/copilot
2. 确认 Copilot CLI 功能已启用
3. 确认组织策略允许第三方 MCP 服务器

Token 过期

创建新的 Personal Access Token 并更新：

echo "新 token" > ~/.copilot/github_token.txt

示例使用

# 分析 base-auto 项目
cd /Users/agent/workspace/base-auto

# 快速提问
COPILOT_GITHUB_TOKEN=$(cat ~/.copilot/github_token.txt) copilot -p "这个项目有什么核心功能？"

# 深度分析
COPILOT_GITHUB_TOKEN=$(cat ~/.copilot/github_token.txt) copilot -p "分析项目的数据库设计，列出主要的表和关系。"

资源

• 官方文档：https://docs.github.com/en/copilot
• 命令参考：https://docs.github.com/en/copilot/reference/cli-command-reference