Skip to content

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。

角色 ​

每个组织都有下面这些角色:

角色谁在用做什么工具
askAsk 模式回答关于仓库的问题,给出文件路径view、grep、glob
codeCode 模式完成要求的修改,说明验证结果终端、文件编辑器
refactor早期的任务接口保持行为不变地重构,改动聚焦,跑项目的验证终端、文件编辑器
rewrite早期的任务接口实现行为变更,说明兼容性变化,验证新旧行为终端、文件编辑器
test早期的任务接口补测试覆盖,不改生产代码的行为终端、文件编辑器
review早期的任务接口审查代码,给出带文件位置的问题,不改文件无(只读)

输入框只用 ask 和 code。另外四个来自早期按任务提交的流程,那条流程里仍然可用,聊天界面里不提供选择。

修改角色 ​

所有者和管理员可以在「设置」的「角色模板」里修改角色。用已有的名字保存,就是发布一个新版本。已经开始的轮次继续用开始时的版本,新的轮次用最新版本。

一个角色版本包括:

  • 「角色指令」,附加在每次请求上。
  • 「工具(逗号分隔)」,Agent 的内置工具。
  • 「知识源」,每一轮开始时检索(见知识库)。
  • 「自定义工具连接」,Agent 可以调用的 MCP 工具(见 MCP 工具)。
  • 「只读角色(仅允许 view、grep、glob)」。

ask 角色必须保持只读,工具不能超出 view、grep、glob,也不能挂 MCP 连接。code 角色不能是只读。违反任何一条,这个模式的新轮次都会被拒绝,直到管理员把角色改回来。

只读角色永远拿不到外部 MCP 工具。

记忆按角色分开 ​

项目记忆按项目、按角色分开保存。Ask 读 ask 角色已发布的记忆,Code 读 code 角色的。见项目记忆。