Ask、Code 与角色
输入框有两种模式:Ask 和 Code。每种模式背后是一个角色,决定 Agent 拿到哪些指令、工具、知识源和 MCP 连接。
Ask
Ask 回答关于仓库的问题,不做任何修改。
- Agent 只有 view、grep、glob 三个工具,只读仓库里的文件。指向仓库外面的符号链接会被拒绝。
- 没有终端,不能改文件,也不能用外部 MCP 工具。
- 回答会给出文件路径。
- 不做验证。验证结果显示「未验证」,原因是「Ask 为只读问答,本轮未运行修改验证。」
- 每轮最长 15 分钟。
适合用来熟悉代码、找某个逻辑在哪里,或者在花一轮 Code 之前先想清楚怎么改。新任务页上的「解释这个仓库的结构」就是一个 Ask 请求。
Code
Code 按你的描述改代码。
- Agent 在沙箱里有终端和文件编辑器,可以读写文件、执行命令。它不是 root,也没有网络。
- 它被要求不改动无关的行为,并说明验证结果。
- 仓库里找到的测试命令在改动前后各跑一次,见验证。
- 结果是一份待审阅的差异。点「创建 Draft PR」之前,什么都不会到 GitHub。
- 每轮最长 60 分钟。
Code 请求写得越具体越好。说清楚要改什么、什么不能变,比如「把整个包里的 UserRepo 改名为 UserStore,api/ 的公开接口不要动」。
新任务页上的「修复一个问题」和「补充测试」都是 Code 请求。
在会话里切换模式
每一轮自己选模式。常见用法是先用 Ask 弄清楚代码,再用 Code 改,最后再用 Ask 检查一下结果。Code 之后的 Ask 能看到会话目前为止的改动。
只有 Code 轮次能创建或更新 Draft PR,所以发布时最新一轮必须是成功的 Code。
角色
每个组织都有下面这些角色:
| 角色 | 谁在用 | 做什么 | 工具 |
|---|---|---|---|
ask | Ask 模式 | 回答关于仓库的问题,给出文件路径 | view、grep、glob |
code | Code 模式 | 完成要求的修改,说明验证结果 | 终端、文件编辑器 |
refactor | 早期的任务接口 | 保持行为不变地重构,改动聚焦,跑项目的验证 | 终端、文件编辑器 |
rewrite | 早期的任务接口 | 实现行为变更,说明兼容性变化,验证新旧行为 | 终端、文件编辑器 |
test | 早期的任务接口 | 补测试覆盖,不改生产代码的行为 | 终端、文件编辑器 |
review | 早期的任务接口 | 审查代码,给出带文件位置的问题,不改文件 | 无(只读) |
输入框只用 ask 和 code。另外四个来自早期按任务提交的流程,那条流程里仍然可用,聊天界面里不提供选择。
修改角色
所有者和管理员可以在「设置」的「角色模板」里修改角色。用已有的名字保存,就是发布一个新版本。已经开始的轮次继续用开始时的版本,新的轮次用最新版本。
一个角色版本包括:
- 「角色指令」,附加在每次请求上。
- 「工具(逗号分隔)」,Agent 的内置工具。
- 「知识源」,每一轮开始时检索(见知识库)。
- 「自定义工具连接」,Agent 可以调用的 MCP 工具(见 MCP 工具)。
- 「只读角色(仅允许 view、grep、glob)」。
ask 角色必须保持只读,工具不能超出 view、grep、glob,也不能挂 MCP 连接。code 角色不能是只读。违反任何一条,这个模式的新轮次都会被拒绝,直到管理员把角色改回来。
只读角色永远拿不到外部 MCP 工具。
记忆按角色分开
项目记忆按项目、按角色分开保存。Ask 读 ask 角色已发布的记忆,Code 读 code 角色的。见项目记忆。