Copilot CLI 常见问题源于指令拼写错误、参数缺失、环境变量未配置或代理模式不当；解决步骤包括基础指令验证、非交互式调用、modernize评估、会话管理及/research研究代理使用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在终端中使用 GitHub Copilot CLI 时无法执行预期操作，或输出不符合预期格式，则可能是由于指令拼写错误、参数缺失、环境变量未配置或代理模式选择不当所致。以下是解决此问题的步骤：
一、基础指令与快速启动
掌握核心命令是使用 Copilot CLI 的前提，这些指令无需额外参数即可立即生效，适用于初始化会话、查看帮助和验证安装状态。
1、在终端中输入 copilot --help 查看所有可用命令的概览说明。
2、运行 copilot（不带任何参数）以启动交互式会话，并按提示确认信任当前目录。
3、执行 copilot plugin list 验证插件系统是否正常加载，输出应包含已安装插件名称及版本号。
二、非交互式编程调用
该模式适用于脚本集成、CI/CD 流水线或自动化任务，避免人工交互阻塞流程，所有响应直接输出至 stdout，便于管道处理。
1、使用 copilot -p "生成一个 TypeScript 接口，包含 id 和 name 字段" 直接提交单次提示并退出。
2、添加 -s 参数屏蔽统计信息与装饰符，仅保留模型原始输出：例如 copilot -p "列出当前目录下所有 .ts 文件" -s。
3、通过 --add-dir=src 显式指定上下文路径，确保 Copilot 仅读取目标子目录中的文件用于推理。
三、现代化评估（modernize assess）
该指令触发深度代码库分析，生成结构化报告，用于识别技术债、迁移可行性及架构风险，支持多源输入与格式定制。
1、在项目根目录运行 modernize assess --source . --output-path ./report --format markdown 执行本地评估并输出 Markdown 报告。
OpenClaw 技能 — 给定一个 GitHub 仓库 URL，自动解析出 owner/repo 名称，发现其中的 YAML/properties 配置文件及其配对的中文字段说明；在 `workspace/{repo}/` 目录下按同步日期（格式为 `YYYY-MM-DD`）创建时间戳子目录；写入 `.openclaw-config-state.json` 状态文件。每次用户提问前，先比对远程仓库当前 ref（如 `main` 或 `master`）的最新提交 SHA 与本地状态文件中记录的 SHA：
2、指定多个源时重复使用 --source：例如 modernize assess --source https://github.com/org/repo-a --source ./local-project --source config.yaml。
3、强制使用云端代理并等待结果返回：modernize assess --delegate cloud --wait --model claude-sonnet-4.6。
四、会话管理与历史恢复
Copilot CLI 持久化存储交互历史，支持跨终端会话延续、命名标识与快速跳转，避免重复设置上下文。
1、执行 copilot --continue 立即恢复最近一次中断的交互式会话。
2、运行 copilot --resume 打开交互式会话选择器，显示含时间戳与自定义名称的会话列表。
3、在活跃会话中输入斜杠命令 /session 查看当前会话 ID；随后可在新终端中使用 copilot --resume abc123 精确恢复。
五、研究型代理调用（/research）
该功能启用专用研究代理，从代码库、GitHub 仓库及公开网页聚合信息，生成带引文的结构化 Markdown 报告，适用于技术调研与架构决策支撑。
1、在交互式会话中输入 /research Next.js App Router 数据获取策略对比 启动研究流程。
2、授权 Copilot 创建临时工作目录后，等待其完成数据采集与分析，终端将显示摘要及报告路径链接。
3、按下 Ctrl + Y 在默认编辑器中即时打开最新研究报告；若需共享，运行 /share gist research 创建可公开访问的 Gist。
