SuperAPI AI 工具集

copilot-harness

智能体与模型

查看项目

更新于 10-16 07:14

技能介绍

用途:让宿主智能体以非交互方式驱动 GitHub Copilot CLI,优先用 copilot -p,不要用无 PTY 的方式运行 TUI。本技能针对 Copilot CLI 1.0.80 验证,flag 过时请重查 copilot --help。注意这不是 VS Code Copilot Chat,程序化 JSON-RPC 应使用 copilot-sdk。

安装与认证:Windows 用 winget install --id GitHub.Copilot --accept-source-agreements --accept-package-agreements,安装后需刷新 PATH,再 where.exe copilot 与 copilot --version。认证用 copilot login,无头环境可加 --device-code;令牌环境变量顺序为 COPILOT_GITHUB_TOKEN、GH_TOKEN、GITHUB_TOKEN,不支持经典 ghp_ PAT。

用法:一次性调用示例 copilot -p "问题或任务" --allow-all-tools --no-ask-user -s;-p 为单轮退出,-s 仅输出回复,--model 选模型,--mode 有 interactive/plan/autopilot,--continue 与 --resume 续接会话,--output-format json 输出 JSONL,最后一条 result 含 sessionId,可传给 --resume。工作目录决定历史,可先用 -C 切换。会话文件在 ~/.copilot/session-state/,日志在 ~/.copilot/logs/。

技能与智能体:copilot skill list/add/remove 管理技能,技能名需为 ASCII 字母数字及 - _ . 空格,名称含 / 会加载失败;自定义智能体放在 ~/.copilot/agents/<name>.agent.md,用 --agent 指定。

限制:工具型 -p 必须加 --allow-all-tools(或 COPILOT_ALLOW_ALL=true、--yolo 等),纯问答不需要;-p 状态下斜杠命令会被当作普通文本;TUI 与 ACP 需要相应环境,--acp 是 Agent 客户端协议服务器,与 JSON-RPC SDK 不同。