TraeWork 的 Commands:把重复任务固化成一条命令
如果你每周都要把同一段提示词敲进对话框——「看一下这个 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 桌面版」的限定。 文档在创建步骤里给这一步加了括号。网页版用户走创建流程时是否会看到这一步、创建出来的命令默认归到哪个环境——官方文档没有说明这一点。能确定的只有表格里那半句:云端环境的适用客户端包含网页版。
第三,命名规则是硬限制,不是建议。 「仅支持小写字母、数字和短横线(-)」写在字段表的「提示」里。大写字母、下划线、中文名,文档没有把它们列进允许集合。文档也没有说明命名冲突时会怎样、内置命令名(比如 plan、spec)能不能被自定义命令占用或覆盖。
第四,一大批你会关心的问题,文档在这一页里没有回答。 我们逐个核过,以下这些《命令》页都没有写:命令数量有没有上限;Instructions 有没有长度限制;命令能不能在团队或企业内共享、能不能纳入版本管理;命令支不支持参数占位符(文档只说了调用后再输入相关指令,没有任何关于变量替换的说明);一条命令能不能调用另一条命令;建好之后怎么编辑、怎么删除;执行一次命令在积分口径上怎么算。这些都属于「官方文档没有说明这一点」,别拿别家产品的同名功能去补齐想象。
第五,命令和「技能(Skills)」是文档目录里并列的两章,但《命令》这一页没有给出两者的分工说明。 唯一能看到的关联点是入口共用——创建路径里那个按钮叫「管理技能与命令」。两者在什么场景下各自更合适,需要去看 Skills 那一章,这一页不提供依据。
第六,效果不保证。 命令的本质是把一段 Instructions 固定下来交给模型执行,文档用的措辞是「建议清晰描述执行步骤、上下文来源以及输出内容,以便 AI 能够准确完成任务」——「以便……能够」是引导性表述,不是「一定会」。输出格式是否每次都严格一致,文档没有给出任何保证性说明。
什么时候值得建,什么时候不必
按上面这些边界倒推,判断标准其实挺清楚。
值得固化的,是那些「同一件事、同一种输出结构、会反复发生」的活。PR 变更总结、commit message 规范、Issue 模板、会议记录整理、文档摘要——文档自己举的这几个例子有共同点:输出结构比输入内容更重要。这类任务每次的素材都不一样,但你想要的那张表是固定的,把表的定义写进 Instructions 一次,后面就不用再复述。
尤其值得的一种情况是团队里不止你一个人干这件事。把输出项写成四条清单塞进 Instructions,等于给协作定了个最小契约。不过要提前把预期放对:文档没有说明命令能否共享,所以在核到相关说明之前,只能当成「每个人各自建一份、用同一段 Instructions 文本」来对待。
不必建的也有几类。一是一次性的任务,写命令的成本高过直接说话。二是每次要求都不同的探索型对话,硬塞进固定 Instructions 反而把自己框住。三是你还没想清楚要什么输出的时候——命令的价值来自那份清单写得够具体,清单本身模糊,固化下来的就是一份模糊的东西,重复执行只会让模糊稳定复现。
还有一条操作层面的提醒:建之前先决定这条命令服务的是本地任务还是云端任务。这个选择在桌面版创建时就要做,而两个环境按文档写的是互不生效的。先想清楚使用场景再动手,比建完发现用不上再回头返工划算。
本文依据 TraeWork 官方文档(docs.trae.cn)于 2026-08-17 的公开内容整理。
我们没有开通付费账号,也没有实际操作过该产品,因此不涉及界面外观、操作手感与生成质量的任何描述。
该产品仍在快速迭代,功能与计费口径随版本变动,文中涉及积分与套餐的表述均为复述官方文档原文,
请以官方最新公告与定价页为准。
安全与合规相关做法请结合自身环境评估,本文不构成安全方案建议。