Skip to content
agent-CI-InfraPublic

About

No description, website, or topics provided.

Resources

Stars

4 stars

Watchers

0 watching

Forks

Latest commit

 

History

1,287 Commits

Folders and files

Repository files navigation

launchpad

launchpad 是一个 GitHub App,负责检视 Issue 和 PR。仓库启用后,新开的 Issue 会收到一次检视评论;PR 在打开、标为可检视(Ready for review)以及 head 更新(推送新提交)时检视,草稿 PR 不检视;管理员可以按仓库关掉其中某种触发。bot 只发评论,不批准、不请求变更,也不合并。管理员为仓库打开开发后,bot 才会按 Issue 改代码并开 PR。许可证为 Apache-2.0。

安装到你的仓库

App 已经创建好了,不需要自己再建。安装地址只用这一个:

https://github.com/apps/agent-ci-infra-bot/installations/select_target

  1. 打开上面的地址,选择仓库所在的组织或个人账号,再选要安装的仓库。
  2. 安装之后,找这套 bot 的管理员审核并启用该仓库。
  3. 启用后就可以开始使用。启用前收到的 Issue 和 PR 事件不会补跑。

自动改代码

项目能力上限是开关:低于「可开发并开 PR」(develop)时 bot 不开发,新项目默认是「可评论和打标签」。能力上限为 develop 时,问题清晰的 Issue 默认由 bot 自己判断并开 PR:最近一次检视结论为「可开发」、问题已确认、推荐方案范围明确、没有留给人决定的问题、没有人被指派时,项目 Manager 按内置提示词里的这条规则开始开发,不需要开发标签。有人(不是 App)加开发标签(默认 bot-develop)、triage 以上权限的维护者在评论里提出要求,仍然是开发的依据,但不是默认前提;外人的评论不算。仓库 README 或 CONTRIBUTING 里只要求「必须由人加开发标签」的句子不否决这条默认,这样的说明应该改掉;仓库自己的 skill、测试方式和已有标签的用法仍然遵守。bot 不自行合并 PR,人明确要求时除外。不能开发时 bot 在 Issue 上回复缺什么。完整条件见自动开发什么时候开始。bot 开出的 PR 上,仓库成员评论要求修改时,bot 判断后照做(只是提问就回答);其他检视机器人提出合理意见时,最多据此修改一次,见bot 开的 PR 怎样跟进修改。

在角色配置里调整行为

bot 在一个仓库里的检视、标签、开发规则和虚拟电脑配置都在控制台的项目配置里调整(Manager 提示词、项目设置和机器配置),仓库里只读取 .agents/skills/ 下的 skill;早期版本使用的 .bot/ 文件已在升级时导入,不再读取。见在角色配置里调整行为。

手动发版本

超级管理员或对应项目的管理员可在项目页的「发版本」填写 v1.2.3、v1.2.3-beta.1 等版本,检查并确认完整提交 SHA。仓库需要有发布用的 CI(.github/ci-gates.json 和运行它的 ci.yml),并有版本标签触发的 .github/workflows/release.yml。控制面使用 GitHub App 安装令牌创建注释标签,跟踪该标签的 Release 工作流;全部 job 成功后准备 GitHub Release 草稿,由人编辑并点击「正式发布」。预发布版本正式发布后仍保留预发布标记。仓库工作流自行发布的 Release 会显示为外部已发布。

发行说明只使用本次提交历史范围内的提交和已合并 PR。仓库存在 .agents/skills/release-notes/SKILL.md 时,控制面固定读取本次 SHA 的文件,并使用项目配置的模型按该规则组织真实来源;否则使用内置来源清单。整理发行说明和运行分析都先交给项目 Manager 分派,Manager 不安排整理时同样使用内置来源清单。可选的运行分析可以主动申请本仓库的 Actions 只读令牌,按需读取本次 run/attempt 的 job 日志;令牌只保留在工具执行端,日志先脱敏再交给模型,分析结束后撤销令牌。页面保留读取的日志行段和来源链接,分析不参与发布状态判定。失败不会自动重跑,同名标签不会被移动或删除。

相对上一枚可达的合法版本标签,没有新增提交时,页面说明跳过,服务端拒绝确认,不创建发布记录、标签或 Release;还没有这样的版本标签时,现有历史可作为首次发布。填写的版本按 SemVer 不高于上一枚可达版本标签时(例如已有 v1.2.0 却填 v1.1.0,或已有 v1.2.3 却填 v1.2.3-rc.1),页面提示可填写的更高版本,服务端同样拒绝确认。已有发布记录仍可查看和按原规则恢复,同名标签始终不会移动或删除。

发版本的写入只看 GitHub App 安装权限:控制台授权(超级管理员或该项目的管理员)决定谁能操作,不另外核对操作者本人在 GitHub 仓库上的权限。

CI 改动以 bot PR 交付:项目管理员在「新建任务」写明要改的 CI、确认允许修改 .github/workflows/,bot 在项目电脑里按仓库自己的情况改 workflow、测试并开 PR,人检视合并后才生效。没有这样确认的任务和 github_write 都改不了 .github/workflows/,见接入说明。

部署和管理

部署、项目管理和升级都在部署这套 bot 和管理员面板;仓库管理员接入一个新仓库走控制台的接入向导:助手只读分析仓库、提问并给出方案,确认后启动,见接入指南。项目的事件来源和自动处理范围在「监听与触发」页统一配置,Manager 提示词和角色在「角色」页配置:通过过滤的事件由 Manager 决定新建任务、续接已有任务还是不处理,检视、开发、发行等工作的开关、写入和模型是项目配置,见项目 Manager 与工作类型。

角色池可按角色选择 Pi(默认推荐)、Native、Process,或容器内 Claude Code、Codex(app-server)执行器;后两者在项目容器及每运行隔离容器内执行原生终端、文件编辑与平台 MCP 工具,经容器内模型中转调用平台模型,会话与任务记录持续关联,交付仍经独立 QA;启用方式与边界见 Harness Runtime。每次角色运行经版本化的 RoleRun 协议准入、留痕和恢复:租约 epoch、短时运行令牌、受控任务工具网关、可选的每运行独立容器以及跨恢复累计的预算,见 RoleRun 协议。

仓库快照与运行日志

控制面为每个仓库保留一份 Git 镜像,任务开始前只拉取这次要用的提交,已缓存的提交不再访问 GitHub。每个任务从镜像把固定提交的文件拷进自己的工作目录,之后镜像的更新不影响已拷出的副本。镜像不可用时回到 GitHub API 逐文件准备;GitHub 的递归 tree 被截断时,按目录非递归列举文件。子模块和不支持的 Git mode 条目不下载,子模块仓库不克隆。GitHub 因文件过大而拒绝返回的 blob 会跳过。跳过项的路径和原因记入日志,数量记入覆盖说明;发布时保留这些上游条目。大文件保存在工作区中,由工具读取。哈希不一致、路径越界或工作区被替换时,任务会停止并显示原因。

在「检视」「开发」页点开任务,可查看运行记录和准备日志。失败或暂停的任务详情显示故障说明、原因类别(外部服务或网络波动、GitHub 权限或配置、GitHub 拒绝请求、模型、项目电脑、仓库内容、任务条件变化、GitHub 写入结果未知、Bot 自身问题)和下一步怎么做,准备日志记录固定提交、文件来自 Git 缓存还是 GitHub API、已接收文件数和字节数、跳过路径及原因。

同时运行多个任务

每个仓库一台虚拟电脑,默认一次运行一个任务。超级管理员在「全局设置」设置默认并发数(1–32),项目可以在「机器配置」里单独设置,留空跟随全局默认;超出的任务继续排队。同时运行的任务各用自己的工作目录,共用这台电脑的 CPU、内存和进程数上限。「全局设置」还显示当前运行的镜像标签。

反馈

用起来有问题或有建议,欢迎到本仓库提 issue:https://github.com/agent-CI-Infra/bot/issues

About

No description, website, or topics provided.

Resources

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages