WorkBuddy 当前有三种工作模式:默认 Agent、计划 Plan、仅问答 Ask。模式决定“这一轮怎么工作”,工作空间决定“主要读写哪个目录”,权限决定“遇到高风险动作是否停下来确认”。三者解决的问题不同。
先用一张表选模式
| 模式 | 会不会执行 | 什么时候用 | 你要检查什么 |
|---|---|---|---|
| Ask(仅问答) | 不做执行 | 理解资料、确认需求、检查思路 | 回答有没有引用真实文件,是否承认不确定项 |
| Plan(计划) | 先不执行 | 多步骤、方向未定、成本较高或改动范围需要审查 | 文件范围、步骤、命令、输出、验收与回滚 |
| Agent(默认) | 可以执行和改文件 | 目标、范围和验收都已明确 | 实际工具、权限弹窗、产物和执行证据 |
官方当前入口在输入框左侧“+ → 模式”。Plan 与 Ask 互斥;关闭非默认模式后回到 Agent。输入框下方会显示当前非默认模式标识。
这三个名称不要再按旧教程理解
旧版内容常把执行阶段称为 Craft。2026-09-08 核读的官方 Task Bar 已改为“默认(Agent)/ 计划(Plan)/ 仅问答(Ask)”。因此:
- “确认 Plan 后开始执行”进入的是默认 Agent 执行流程。
- Ask 适合只读分析,不等于系统文件权限本身只读。
- Agent 能执行,不等于拥有计算机所有目录和操作权限。
当客户端名称与文章不同,以你当前界面和官方更新日志为准,同时把版本写进自己的验收记录。
模式选择用两个问题就够了
问题一:这一轮需要真实产物或修改吗?
- 不需要:Ask。
- 需要:继续问问题二。
问题二:执行方案是否已经清楚且可回滚?
- 否:Plan,先审方案。
- 是:Agent,可以直接执行小而明确的任务。
例如“解释这份会议记录有哪些决定”用 Ask;“先规划要生成哪三份文件”用 Plan;“按已确认字段生成 CSV”才进入 Agent。
工作空间不是一个装饰选项
官方把工作空间定义为当前任务主要读取和保存文件的文件夹。未指定路径时,WorkBuddy 也可能为新任务建立独立空间。
第一次任务建议建立:
task-name/
input/ # 输入副本
output/ # 新产物
不要把桌面根目录、下载目录、整个主目录或装有多项目的父目录设为一次小任务的工作空间。默认权限会降低风险,但不能替代目录边界和备份。
默认权限与完全访问的真实差别
| 项目 | 默认权限 | 完全访问 |
|---|---|---|
| 工作空间内常规操作 | 可执行 | 可执行 |
| 敏感路径、高风险删除、脚本等 | 会在风险点要求确认 | 多数不再逐步确认 |
| 生效范围 | 由沙箱与具体操作控制 | 当前客户端所有任务统一生效 |
| 适合 | 日常文档、代码、资料整理 | 隔离环境中的可信重复操作 |
完全访问不是“让这个任务临时多一步能力”。官方当前说明是全局开关,会影响当前客户端里的现有任务和新任务。使用完需要主动关闭;处理生产资料、客户资料、唯一副本或不理解的脚本时不要开启。
四个场景怎么组合
整理会议记录
- 独立工作空间和输入副本。
- Ask 提取事实。
- Plan 确认输出文件和缺失值规则。
- Agent 写入 output。
- 保持默认权限。
可直接跟做会议纪要完整练习。
修改一个代码规则
- Git 仓库先提交干净基线。
- Ask 读项目和跑基线。
- Plan 锁定文件与测试。
- Worktree Task 中由 Agent 修改。
- 默认权限下核对命令和路径。
可直接下载运费规则练习仓库。
只想问一个概念
使用 Ask,不需要为只读问题建立复杂 Plan,也不需要完全访问。若回答引用本地材料,仍要确认它实际读取了哪些文件。
批量移动或删除文件
先用 Ask 生成清单,再用 Plan 给出新旧路径预览和回滚方式,最后在默认权限下逐步确认。不要为了减少弹窗直接全局放开权限。
Worktree 解决的是代码目录隔离
Worktree Task 基于 Git worktree 创建独立目录和任务分支,适合并行开发或试验性修改。它与权限模式不是同一件事:
- Worktree 防止任务直接污染主工作目录。
- 默认权限在高风险操作前保留确认。
- Plan 在写入前让你审查方案。
三个可以同时使用。官方当前 V1 只支持桌面端 Git 项目;非 Git、云端 WorkBuddy、CodeBuddy 和跨仓库任务不适用。
开始任务前的 6 项检查
- 当前客户端版本是否与教程接近。
- 当前模式标识是 Ask、Plan 还是默认 Agent。
- 工作空间是否只覆盖本次任务。
- 输入是否为可恢复副本。
- 权限是否保持默认,完全访问是否关闭。
- 产物、测试、人工检查和回滚是否已经写清。
遇到权限弹窗怎么判断
不要只看按钮,先读操作内容、目标路径和执行理由:
- 路径超出工作空间:取消,要求改回 output 或 Worktree。
- 命令会安装依赖、删除文件或访问网络:要求解释必要性和影响。
- 与已确认 Plan 不同:取消并回到计划修正。
- 无法判断:让 Agent 先给出预览,不执行。
模式帮你安排任务节奏,权限帮你守住执行边界。真正的通过证据仍然来自文件、测试、diff 和人工核对。