镜像自 HugoXK/LaunchPad@5cfa983 · upstream · 在 GitHub 上编辑 docs/rules.md ↗

在角色配置里调整行为

本文写给安装了这套 bot 的代码仓的管理员。bot 在一个仓库里怎样检视、打标签、开发和准备虚拟电脑,都在控制台的项目配置里调整,只有这一处来源:

要调整的行为 在哪里改 管理命令
行为指南、检视 Issue、检视 PR、开发与跟进 bot PR、标签用法 「角色 → Manager」的 Manager 提示词,对应章节 guide、review.issue、review.pr、development、labels manager.update
各角色的提示词、模型、权限和预算 「角色」页的各个角色 roles.update
检视标签、开发标签的名字 「项目设置 → 基本 → 标签」 project.update 的 review_label、development_label
虚拟电脑的资源、软件包、环境变量和初始化脚本 「机器配置」 POST /api/environments/:id/configure
仓库自己的 skill 仓库默认分支的 .agents/skills/<名称>/SKILL.md 改仓库文件

章节没写时用内置原文,就是 docs/prompts/ 下的 Markdown,见项目 Manager 与工作类型。保存只影响之后新建的任务,已经开始的任务按开始时的配置做完。

仓库里的 .bot/ 文件不再读取

早期版本从仓库默认分支读取 .bot/guide.md、.bot/rules/*.md 和 .bot/computer.yaml,并允许管理员在控制台给它们加「控制台覆盖」。这三层已合并成上面的单一来源(#935):

仓库 skill

.agents/skills/ 下各级目录里的 SKILL.md 是仓库的 skill,bot 像普通 agent 一样读取并遵循:

边界:skill 只能指导与本仓库相关的工作,不能扩大权限或改变平台规则。系统提示词写明了这一点;下面这些照常由控制面拒绝并记录,不因 skill 的内容放开:

出错时任务在准备阶段停下,状态显示「配置待补」,原因归为「仓库内容或规则」:

错误码 原因
invalid_rule_content SKILL.md 含 NUL 字节
invalid_skill_file SKILL.md 是符号链接、子模块等,不是普通文件
unsafe_skill_file 检出的代码里 skill 路径上有符号链接
too_many_bot_skills .agents/skills/ 下的 SKILL.md 超过 32 份

修好默认分支上的文件后,等待中的任务会自动重试。规则章节原文和 skill 索引每个任务都直接交给模型,它们和任务摘要合计超过 2 MiB 时,任务停下并报 agent_context_too_large。早期版本因 .bot/ 文件停下的任务(invalid_bot_label、invalid_bot_computer、invalid_bot_rule_file、unsafe_bot_rule、bot_rule_too_large),点「重试」即可继续。

检视标签和开发标签

在「项目设置 → 基本 → 标签」里设置,或用 project.update 的 review_label、development_label:

自动开发什么时候开始

自动开发默认关闭。管理员把该项目的能力上限设为「可开发并开 PR」(develop,见项目能力上限)以后,开发别人开的 Issue 由项目 Manager 决定(#815)。它在 create_task 里写明依据,控制面在建任务时核对,并把依据记在任务上(任务详情的「开发依据」):

依据不成立时建任务被拒绝,拒绝原因返回给 Manager 并记在事件上;Manager 可以在 Issue 上回复缺什么。bot 自己(从 Actions 失败)提报的 Issue 不需要依据,但仍要检视确认是产品缺陷,见 Actions 失败处理。飞书群里建的、要开 PR 的任务记「群的授权档位」,私聊里建的记「请求人自己的权限」。

Issue 的打开、编辑、评论和提到 bot,以及有人加开发标签、标签在时检视发布,都会把「开发 Issue」作为可以新建的工作交给 Manager。Manager 读 Issue、评论、最近一次检视的结论和建议(recommendation)、指派人和同一 Issue 上已有的任务,决定现在开发,还是不开发并新建一次检视来回复。加标签需要仓库的 triage 或写权限,所以 Manager 把它当作维护者的决定:它能回答「bot 可不可以开始」「Issue 正文里保留或认领的工作要不要交给 bot」,回答不了还没定的行为、范围或设计问题。检视不再返回「是否需要改代码」「原句」「实现目标」「是否需要人决定」这些授权字段,也不再在评论里写「等开发标签」。

开发按 Manager 写的简要说明(目标和验收标准)进行。以开发标签为依据的开发在发布 PR 前会再查一次标签,被人去掉就停下(waiting_permission),这件事作为 development.stopped 事件交给 Manager,由它决定要不要在 Issue 上回复;有人重新加上标签时,Manager 续接这个开发,任务接着做,不用人点「重试」。以其他依据开始的不看标签。开发期间 Issue 的标题或正文被修改不会让开发停下:任务改用当前的文本,修改作为更新记下,之后开始的角色在任务事实(updates)里读到;Issue 的编辑、评论和提到 bot 的事件也可以由 Manager 续接到运行中的开发(内置常设规则 issue-update 就这样做)。已经在运行的会话实时收到更新,要等 Harness 会话层(#834)。同一 Issue 同时只有一个开发任务。development 章节里可以再写更严的条件(例如限定 type、size),由 bot 遵守。

bot 开的 PR 怎样跟进修改

bot 开出 PR 后,下面几种情况会让它在同一个分支上继续修改:

每次修改仍要通过项目的测试命令才会推送。这些修改只在 bot 分支上追加提交,不批准、不合并,也不会强推。

合并不在这个流程里,但不是只有人能做:GitHub 上合并 PR 属于 Contents 写,Manager 默认有 Pull Request 和 Contents 写权限,可以经 github_write 批准或合并 PR、写分支(包括默认分支);其他角色、群助手和管理助手按各自的 Contents 写权限。这类写入不经过控制面的合并校验,也不限制目标分支,能不能合入由仓库的分支保护(或规则集)和必需检查决定,所以接入的仓库应打开这两项,见接入指南。不希望 Manager 合并时,在「角色 → Manager」把 Contents 改成只读。人在控制台合并走带校验的 POST /api/tasks/:id/merge,见角色池。

机器配置

在项目的「机器配置」里设置,保存后按新配置重建虚拟电脑:

字段 含义与范围
cpus CPU 核数,0.25–16,没写时跟随全局默认(内置 2)
memory_mb 内存(MiB),256–65536,没写时跟随全局默认(内置 4096)
pids 进程数上限,64–16384,没写时跟随全局默认(内置 1024)
tmp_mb /tmp 大小(MiB),16–16384,没写时跟随全局默认(内置 1024)
egress 是否允许访问外网,布尔值,默认跟随部署设置
packages 要安装的 Debian 包名,最多 100 个
env 非机密环境变量,最多 64 个;PATH、HOME、BOT_*、GIT_* 等保留名会被拒绝
setup_script 初始化脚本,以项目用户身份运行;内容变化后重新运行

环境变量对仓库代码可见,不要填写密钥。