SuperAPI AI 工具集

gh-agent-task

智能体与模型

查看项目

更新于 10-16 05:49

技能介绍

用途:通过 GitHub CLI 创建 GitHub Copilot 编码智能体任务。此类任务是以自然语言指令编写的 GitHub issue,会触发 Copilot 自主执行改动并生成拉取请求,便于评审和合并自动代码修改。

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

主要命令:创建任务 gh agent-task create "描述",也可用 --from-file 从文件读取、--base 指定基础分支、--repo 指定目标仓库,创建后输出任务 URL;列出任务 gh agent-task list,可用 --state open/closed/all 过滤;查看 gh agent-task view 编号或 URL;更新 gh agent-task update 编号 "描述"(或 --from-file)。

任务描述应清晰具体,涉及相关文件路径、验收标准、约束和测试要求。

与 GitHub Agentic Workflows 集成:通过安全输出 create-agent-task 配置,支持 base 基础分支和 target-repo 跨仓库创建,并可在 staged 模式预览。相关环境变量包括 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 不支持,COPILOT_CLI_TOKEN 和 GH_AW_COPILOT_TOKEN 自 v0.26+ 起不再支持。安全输出可产出 task_number 和 task_url 供后续作业使用。

适用场景:由 issue 标签触发实现任务、定时代码改进、跨仓库任务委派等。

限制:需正确配置 PAT 及仓库 Copilot 设置;任务失败或未触发 Copilot 时需检查令牌、权限、仓库可访问性及任务描述清晰度;生成的拉取请求应始终人工评审。