TraeWork 的 Commands:把重复任务固化成一条命令

2026-08-17

如果你每周都要把同一段提示词敲进对话框——「看一下这个 PR 改了什么,按核心改动点、涉及文件、潜在风险三段输出」——敲到第五次的时候,你多半会开始怀疑:这段话我到底还要再打多少遍。更麻烦的不是打字,是每次打得都不一样。这次多写了一句「顺便列出影响范围」,下次忘了写,两次拿到的东西格式对不上,想合并进同一份周报还得手动改。

TraeWork 官方文档里的「命令(Commands)」这一章,处理的就是这个问题。文档开篇给的定义很朴素:命令是一种快捷方式,用于在对话中快速执行重复性任务;通过创建自定义命令,把常用的指令或操作封装起来。换句话说,它不是让 AI 变聪明的开关,而是让你自己的输入不再飘的一个约束装置。

文档自己列了三类使用场景,原文分别是「复用常用 Prompt」「规范输出格式」「自动化常见开发流程」。第二类值得单独拎出来看一眼——文档给的例子是「生成符合 Conventional Commits 规范的 commit message、PR 描述或 Issue 模板」。这句话透露的信息量比第一类大:命令在这里的作用不是省事,是把团队约定的输出结构钉死在一个地方,而不是散落在每个人各自的输入习惯里。

需要先说清楚的是,TraeWork 仍在快速迭代,官方文档页面上挂着「重磅更新:以积分为核心的计费模式正式上线」这条更新提示,该产品的功能与计费口径都可能随版本变动。下面所有描述都以我们核对当日的官方文档原文为准,涉及具体口径请以官方最新公告为准。

官方文档写明的用法

先看内置命令。文档列了三条,一条不多一条不少:

内置命令官方文档的说明
/plan调用 “Plan” 模式
/spec调用 “Spec” 模式
/browser_use使用 browser_use 工具来操作内置浏览器,并获取上下文,辅助智能体进行功能验证

前两条对应文档里另有专章的「工作流:Spec & Plan」,第三条对应「浏览器控制(Browser Use)」。也就是说,斜杠命令这个入口不只用来喊自定义的提示词,它同时是几个重型能力的触发口。特别提醒一句:/browser_use 触发的是让智能体去操作浏览器的能力,这属于高权限动作,《命令》这一页只写了上面那一句功能描述,没有展开权限边界,具体条件要去看「浏览器控制(Browser Use)」那一章,不能默认「命令面板里有它」就等于「随便用没风险」。

再看创建自定义命令。文档给出的路径是这样几步:登录 TraeWork;进入技能与命令管理面板(文档写了两条路,一是通过头像进入「设置」,在左侧导航栏中选择「命令」,二是在对话框内左下方点击命令图标,再点菜单底部的「管理技能与命令」按钮);然后是一步带括号限定的操作——(仅 TraeWork 桌面版)选择命令的运行环境:本地 / 云端;最后在「命令」面板点「创建」,填完配置点「确认」。

配置只有三个字段,文档的字段表原文如下:

字段文档描述要点
命令名称 / Command Name命令的唯一标识,用于在对话中触发该命令。文档明确提示:仅支持小写字母、数字和短横线(-)。示例为 summarize-pr-info
描述 / Description对命令用途的简要说明。示例为「总结 PR 信息。」
说明 / Instructions定义触发命令时 AI 应执行的具体操作。文档建议清晰描述执行步骤、上下文来源以及输出内容

字段少到这个程度,意味着命令的全部表达力都压在 Instructions 那一栏里。文档给的 Instructions 示例本身就是一份小型规格书:查看当前 Pull Request 的代码变更内容,对比修改前后的代码,总结本次 PR 的主要变更,输出包括核心改动点、主要修改的文件或模块、关键逻辑变化或新增功能、可能影响的功能或潜在风险。四条输出项,写得像验收清单。这是文档自己给的写法示范,照着这个颗粒度写,比写「帮我总结一下 PR」要靠谱得多。

调用侧很简单:在对话框中输入 / 或点击左下方的命令图标,从菜单中选择一个命令,然后——注意文档这句——「输入与该命令作用相关的指令,然后发起对话」。命令不是按一下就跑完的按钮,它后面还要跟你这次的具体指令。

边界在哪

这一节是本篇真正要交付的东西。逐条说。

第一,本地与云端是两套互不越界的环境。 文档的运行环境表写得很直白:「本地」环境仅对本地任务生效,适用客户端只有 TraeWork 桌面版;「云端」环境仅对云端任务(及从 GitHub 拉取的项目)生效,适用客户端是 TraeWork 网页版、桌面版。两个「仅」字是文档原文。这意味着一条建在本地环境下的命令,在云端任务里不会生效;反过来也一样。你在桌面版建了一堆命令,切到云端任务发现命令菜单里找不到,先回头看当初创建时选的是哪个环境,而不是怀疑没保存上。

第二,选择运行环境这一步本身带「仅 TraeWork 桌面版」的限定。 文档在创建步骤里给这一步加了括号。网页版用户走创建流程时是否会看到这一步、创建出来的命令默认归到哪个环境——官方文档没有说明这一点。能确定的只有表格里那半句:云端环境的适用客户端包含网页版。

第三,命名规则是硬限制,不是建议。 「仅支持小写字母、数字和短横线(-)」写在字段表的「提示」里。大写字母、下划线、中文名,文档没有把它们列进允许集合。文档也没有说明命名冲突时会怎样、内置命令名(比如 planspec)能不能被自定义命令占用或覆盖。

第四,一大批你会关心的问题,文档在这一页里没有回答。 我们逐个核过,以下这些《命令》页都没有写:命令数量有没有上限;Instructions 有没有长度限制;命令能不能在团队或企业内共享、能不能纳入版本管理;命令支不支持参数占位符(文档只说了调用后再输入相关指令,没有任何关于变量替换的说明);一条命令能不能调用另一条命令;建好之后怎么编辑、怎么删除;执行一次命令在积分口径上怎么算。这些都属于「官方文档没有说明这一点」,别拿别家产品的同名功能去补齐想象。

第五,命令和「技能(Skills)」是文档目录里并列的两章,但《命令》这一页没有给出两者的分工说明。 唯一能看到的关联点是入口共用——创建路径里那个按钮叫「管理技能与命令」。两者在什么场景下各自更合适,需要去看 Skills 那一章,这一页不提供依据。

第六,效果不保证。 命令的本质是把一段 Instructions 固定下来交给模型执行,文档用的措辞是「建议清晰描述执行步骤、上下文来源以及输出内容,以便 AI 能够准确完成任务」——「以便……能够」是引导性表述,不是「一定会」。输出格式是否每次都严格一致,文档没有给出任何保证性说明。

什么时候值得建,什么时候不必

按上面这些边界倒推,判断标准其实挺清楚。

值得固化的,是那些「同一件事、同一种输出结构、会反复发生」的活。PR 变更总结、commit message 规范、Issue 模板、会议记录整理、文档摘要——文档自己举的这几个例子有共同点:输出结构比输入内容更重要。这类任务每次的素材都不一样,但你想要的那张表是固定的,把表的定义写进 Instructions 一次,后面就不用再复述。

尤其值得的一种情况是团队里不止你一个人干这件事。把输出项写成四条清单塞进 Instructions,等于给协作定了个最小契约。不过要提前把预期放对:文档没有说明命令能否共享,所以在核到相关说明之前,只能当成「每个人各自建一份、用同一段 Instructions 文本」来对待。

不必建的也有几类。一是一次性的任务,写命令的成本高过直接说话。二是每次要求都不同的探索型对话,硬塞进固定 Instructions 反而把自己框住。三是你还没想清楚要什么输出的时候——命令的价值来自那份清单写得够具体,清单本身模糊,固化下来的就是一份模糊的东西,重复执行只会让模糊稳定复现。

还有一条操作层面的提醒:建之前先决定这条命令服务的是本地任务还是云端任务。这个选择在桌面版创建时就要做,而两个环境按文档写的是互不生效的。先想清楚使用场景再动手,比建完发现用不上再回头返工划算。


本文依据 TraeWork 官方文档(docs.trae.cn)于 2026-08-17 的公开内容整理。 我们没有开通付费账号,也没有实际操作过该产品,因此不涉及界面外观、操作手感与生成质量的任何描述。 该产品仍在快速迭代,功能与计费口径随版本变动,文中涉及积分与套餐的表述均为复述官方文档原文, 请以官方最新公告与定价页为准。

安全与合规相关做法请结合自身环境评估,本文不构成安全方案建议。

想系统学会用 AI?报名体系课或加入会员,照着学、照着用。