SuperAPI AI 工具集

gh-agent-session

智能体与模型

查看项目

更新于 10-15 21:52

技能介绍

用途:通过 GitHub CLI 扩展 github/agent-task 管理 Copilot 编码智能体会话。会话是包含自然语言指令的 GitHub issue,触发 Copilot 自主执行任务并创建拉取请求,便于审查与合并自动代码修改。

安装:gh extension install github/agent-task。需使用具备创建 issue 和 PR 权限的个人访问令牌(PAT)认证。

主要命令:gh agent-task create "描述" 创建会话,支持 --from-file、--base、--repo;gh agent-task list 列出会话,支持 --state open/closed/all;gh agent-task view 123 或按 URL 查看;gh agent-task update 123 "新描述" 更新。创建后输出会话 URL。

任务描述应具体,包含文件路径、验收标准、测试要求与约束。

与 GitHub Agentic Workflows 集成:通过 safe-outputs 的 create-agent-session 配置 base 与 target-repo,工作流读取结构化输出、写入临时文件并执行 gh agent-task create --from-file <file> --base <branch>,捕获任务 URL 与编号。相关环境变量包括 GITHUB_AW_AGENT_TASK_BASE、GITHUB_AW_TARGET_REPO、GITHUB_AW_SAFE_OUTPUTS_STAGED。

认证要求:需 contents: write、issues: write、pull-requests: write 权限。令牌优先级为 COPILOT_GITHUB_TOKEN(推荐)、GH_AW_GITHUB_TOKEN(旧版兼容)、自定义 github-token。默认 GITHUB_TOKEN 不支持;COPILOT_CLI_TOKEN 与 GH_AW_COPILOT_TOKEN 自 v0.26+ 起不再支持。

限制与注意:需将 PAT 存为仓库密钥;使用最小权限;跨仓库任务需验证目标仓库可访问;staged 模式仅预览不创建;常见错误包括认证失败、403 权限不足、仓库未找到。应始终审查智能体生成的 PR,并监控会话创建与完成情况。具体平台支持与收费信息暂未提供。