用途:为在拉取请求中执行任务的 GitHub Copilot 编码智能体提供统一的标准操作流程,通常由所有编码智能体自动加载。
主要能力与工作流要点: 分支与 PR 管理:当问题被指派给 @copilot 时,GitHub 会自动创建 copilot/* 分支和草稿 PR,智能体启动时已处于正确分支且 PR 已存在。不要运行 git checkout、git switch 或 git branch,也不要自行创建 PR;手动创建通常失败或产生重复 PR。 提交与推送:主智能体使用 report_progress 工具,自动完成 git add、git commit 与 git push,调用参数包括 commitMessage(约定式提交信息,如 "feat: add feature X")和 prDescription(Markdown 清单)。不要手动执行 git push,没有个人凭据会失败。 委派执行:通过 task 工具被编排器调用的子智能体处于隔离上下文,无法访问父 PR,report_progress 不可用;应使用 git add <changed files> 与 git commit -m "type: message" 提交,但不要 git push(会返回 HTTP 403)。本地提交会随后由父智能体调用 report_progress 时一并推送。子智能体不得创建 PR 评论,问题需写入返回文本由编排器转发。 提问方式:主智能体可在 PR 中评论向维护者提问并等待答复;委派场景则需等待编排器带回答案后重新调用。 总结评论:报告进度后发布 PR 评论,包含 Summary、Changes、Next Agent、Status(Ready 或 Blocked 及原因);委派模式则将总结写入响应文本。
关键原则:所有文件改动必须通过 edit/create 工具实际应用,不能只描述;必须使用 git commit 提交,避免仅存内存导致丢失;区分主智能体与子智能体行为;使用清单跟踪进度;清晰沟通状态与下一步。
适用场景:面向 GitHub Copilot 编码智能体的 PR 任务执行与多智能体编排协作。限制:具体仓库的智能体序列另见 docs/agents.md;其余细节资料暂未提供。