WorkBuddy 的指令是在对话框里输入斜杠「/」就能唤起的快捷命令,系统内置 12 条常用命令,还能按自己的活儿自建自定义指令。这篇把系统命令、自定义方法、生效规则和排错点一次说清,照着用就能把重复动作收成一条命令。 workbuddy指令是什么
指令是 WorkBuddy 里以「/」开头的快捷命令,在对话框敲一个斜杠就会弹出命令选择器,继续输入名称还能过滤。它和你可能听过的「技能」「模式」是三件不同的事:技能是封装好的能力模块,在技能市场安装或用「@名称」调用;模式是发送前选的 Craft、Ask、Plan,控制 Agent 动手的程度;指令则是更轻的一层,把一段固定说法存成一个短命令,随调随用。命令选择器里内置命令排在前,自定义和项目命令紧随其后,一眼能分清来源。
日常入口就一个:在任意对话的输入框敲「/」,选择器列出当前可用的全部指令。内置命令开箱就有,自己建的、项目里的、企业下发的也会一起出现,按统一优先级合并后展示。要是某条命令记不全,敲「/」后直接打关键词,比如输入「comm」就能把 /commit 和 /commit-push-pr 一起筛出来,找命令不用背全名。
12 条系统命令速查
下面这张表把客户端内置的 12 条命令逐条列出来,每条都对应一个高频动作。记不住全名也不要紧,输入「/」后边敲边过滤就能定位。这 12 条覆盖会话管理、状态查看、代码协作和出稿留档四类,基本是日常用得最勤的入口。
| | |
|---|
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | 导出成 Word、PDF 或 Markdown 留档转发 |
| | |
这 12 条里,/clear、/rename、/resume、/skills、/status、/model、/help 偏会话与状态管理;/commit、/commit-push-pr 偏代码协作;/web、/file、/export 偏取数与出稿。新手先把 /clear、/skills、/web、/export 四条用熟,日常效率就能明显上来。熟练之后可以把 /clear 放在每天收工前,把上下文清零,第二天开工更干净;/status 则适合在发现回答变慢或额度异常时先查一眼,再决定要不要换模型或排查连接。
自定义指令怎么建
内置命令是通用的,真正拉开差距的是自建指令。个人用法最简单:打开设置,进快捷指令管理,点新建,填两样东西,名称(比如「周报」)和提示词模板(把那段每次都要打的长描述写进去),保存之后在对话框输入「/周报」,系统会自动把模板填充好,后面贴内容就行。模板里可以用占位写法预留待填位置,比如「把以下内容整理成周报:{待填记录}」,调用时只补花括号里的内容,格式始终统一。
企业场景由管理员在管理后台建「自定义指令」,给团队定义可复用的标准提示词模板,成员在企业组织下直接调用,不用每人都配一遍。还有一条偏开发的路:在项目工作目录的 .codebuddy/commands 文件夹里放一个 .md 命令文件,会话创建后输入框就能补全这条命令,适合把团队规范固化进仓库。自建指令的好处是跨会话保留,配一次之后每次新对话都能直接调,不用重复粘贴那段长提示。
指令的优先级与生效范围
命令不是平铺在一起,而是分来源、按优先级合并。搞清楚谁覆盖谁,才不会出现「我明明建了却没生效」。
| | |
|---|
| 放项目目录 .codebuddy/commands 下的 .md 文件 | |
| | |
| | |
| | 只在当前企业组织下出现,建完常需重启客户端或重开会话 |
合并规则的关键一句是「项目级大于用户级、当前项目只认当前项目的命令」。所以同一台机器上给 A 项目建的指令,切到 B 项目默认看不到,这是有意的设计,不是失误,避免不同项目的命令互相串场。如果你同时装了同名的企业指令和个人指令,以企业管理后台下发的为准,这是为了让团队动作统一,个人同名指令会被覆盖。
指令技能模式三者区别
很多人把指令、技能、模式混着说,这三者的触发写法和适合干的活都不一样。
一个直观的分工:用指令把「每周整理教研纪要」收成一条 /纪要;用技能让 Agent 去读网页、做 PPT;用 Plan 模式先让它在动手前把方案摆给你确认。三者叠加,重复活可以交给指令,专业活交给技能,高风险活先过 Plan。反过来也容易记:指令管「怎么说」,技能管「怎么做专长」,模式管「动不动手」。
不同任务该用哪条指令
按活儿选命令最省心。清上下文用 /clear,忘了装了什么用 /skills,要最新信息加 /web,出稿留档用 /export,写代码落库用 /commit,协作走 /commit-push-pr。把一段长描述存成自定义指令,比每次手敲省下的不只是打字时间。
有个判断标准:凡是你一周要重复三次以上的固定说法,都值得做成一条指令。比如「把本周工作记录整理成周报:完成项、进行中、下周计划、待协调」,存成 /周报 之后,每次只贴记录即可。教研、运营、自媒体都能照这个思路配几条常用指令。举个教研场景:把「梳理这节课的重难点,按知识点列讲解思路和易错点」存成 /备课,课前一键生成草稿,老师只需补案例;运营同学把「把这篇推文改成三个平台的标题和摘要」存成 /改写,多发几版也不累。指令越贴合你的实际流程,省下的动作越明显。
手机端与团队里的指令
指令不只在桌面端好使。手机上用 WorkBuddy 的小助理(微信或 App)也能调指令,差别在任务跑在哪:云端工作是在服务器执行、不直接碰你电脑文件;连接电脑模式才是远程操作本机。团队里管理员下发的指令,成员在企业组织下开箱就能调用,同样不串项目。云端模式适合临时问问题、查资料,连电脑模式才适合批量改本地文档、跑命令,手机上远程连本机时注意网络要稳。
多成员协作时,把团队的命名规范、汇报格式写成企业指令统一下发,比每个人各建一套更稳,也方便新人照搬老员工的用法。项目级命令随仓库走,换人接手同一项目时指令也跟着过来。团队管理员还能在后台看指令的调用情况,哪条用得多、哪条没人用一目了然,方便后续调整下发的模板。
workbuddy指令使用注意事项
- 指令只在对话输入框生效:别在别处粘贴斜杠命令,它要在 WorkBuddy 的输入框里才会被识别。
- 自定义名称避开内置命令:不要用 /clear、/help 这类内置名当自己的指令名,会触发同名覆盖,行为变得不可预期。
- 项目级命令要重开会话:在 .codebuddy/commands 里新增或修改命令后,补全列表会自动刷新,但切换项目时要新建或重开会话才认得到。
- 企业指令需在企业组织下:后台下发的指令只在当前企业组织出现,若列表里没有,确认是否处于对应组织,必要时重启客户端。
- 提交类先连仓库:/commit、/commit-push-pr 要先在连接器里授权 GitHub 或 GitLab,没连仓库时命令无法落库。
- 复杂活先走 Plan 模式:让 Agent 动手前,先用 Plan 看它打算怎么改,确认了再进 Craft,别一上来就直接执行。
- 模板里别写敏感信息:自定义指令的提示词模板随账号保存,含密钥、内部地址的写法有泄露风险,敏感内容放项目配置更稳妥。
- 长活交给自动化:每天固定时点的重复指令,用自动化任务定时跑比手动调更省心,也不必守着时间点。
- 命令清单以版本为准:客户端会随版本增删命令,本文列的 12 条是当前内置集合,新版本以你客户端实际显示为准。
常见问题
Q:指令和技能是一回事吗?
A:不是。指令是「/」开头的快捷命令,存一段固定说法;技能是封装好的能力模块,用「@名称」或技能市场调用,两者触发方式和适合干的活都不同。
Q:怎么新建自己的指令?
A:个人在设置里的快捷指令管理点新建,填名称和提示词模板即可;开发者也可在项目 .codebuddy/commands 放 .md 文件;企业由管理员在后台统一建。
Q:指令文件应该放哪?
A:项目级放项目目录的 .codebuddy/commands 文件夹,会话创建后自动补全;用户级放用户主目录配置,两者同名时项目级优先。
Q:为什么我建的指令在列表里看不到?
A:多半是项目不对或会话没刷新。切换项目只显当前项目命令,新建后重开会话或重启客户端一般就能看到;企业指令还要确认处于对应组织。
Q:项目级和用户级命令谁优先?
A:同名时项目级优先,用户级被覆盖。合并按统一优先级,内置命令不覆盖你的自定义,所以重名主要发生在自定义之间。
Q:手机上能用这些指令吗?
A:能。微信小助理或 App 里同样可以调指令,只是任务跑在云端还是连本机要分清,连电脑模式才能直接操作本地文件。
Q:/commit 提交代码前要做什么?
A:先在连接器里授权 GitHub 或 GitLab,让仓库可读可写。没连仓库时提交命令无法落库,连上后让 Agent 列一下 PR 就能验证通不通。
Q:指令能带参数吗?
A:可以。很多命令支持在名称后补内容,比如 /rename 后面跟新名字、/commit 后面跟提交说明,按提示填补充信息再发送即可。
Q:指令和自动化任务有什么区别?
A:指令是手动调的一条命令,自动化是定时或触发后自动跑的流程。每天固定时点的重复活,用自动化比反复手敲指令更省事。
指令这套机制的妙处,在于把「你会反复说的话」收成一个短命令,用得越久越顺手。把本文的 12 条系统命令摸熟,再按自己的活儿配几条自定义指令,workbuddy指令大全 这套用法就基本齐了。想看更多实战搭配,可以关注本站的 AI 工具栏目,有新命令和用法我们会同步更新。