/plan、/spec、/docs、/clear、/agent、/builder、/commit用途

这些指令就像是给 Trae 下达的“专业分工令”，每一个都对应着软件开发中的一个特定角色。为了让你一眼看懂，我把它们整理成了一张速查表：

📊 Trae 核心指令速查表

指令	角色定位	核心用途 (一句话总结)
/spec	📝 产品经理	定需求：把模糊的想法转化为详细的规格说明书（做什么）。
/plan	🏗️ 技术主管	做计划：将需求拆解为具体的执行步骤和文件结构（怎么做）。
/docs	📚 资料员	给依据：投喂官方文档或外部资料，让 AI 有据可依地写代码。
/agent	🤖 模式切换	换人格：在“纯聊天问答”和“动手写代码”等模式间切换。
/builder	🔨 施工队长	去干活：直接指挥 AI 动手修改、创建文件或构建项目。
/clear	🧹 清洁工	清记忆：清空当前对话上下文，让 AI “失忆”并重新开始。
/commit	💾 运维专员	交作业：自动分析代码改动，生成 Git 提交信息并完成 Commit。

---

🛠️ 详细使用场景解析

/spec (Specification - 规格说明)

• 什么时候用：当你只有一个大概的想法（比如“我想做个记账软件”），但不知道具体细节时。

• 它的作用：强迫 AI 停下来，先不写代码，而是和你确认功能点、边界条件和验收标准。它会生成一份 spec.md 文档。

• 好处：防止 AI 理解偏差，避免做出来的东西“货不对板”。

/plan (Planning - 任务规划)

• 什么时候用：当需求已经明确（或者写好了 spec），准备正式动工时。

• 它的作用：AI 会把大任务拆解成 Step 1, Step 2, Step 3，规划好需要创建哪些文件、用什么技术栈。

• 好处：让复杂的开发过程变得有条理，AI 会按部就班地执行，不容易写到一半逻辑崩坏。

/docs (Documentation - 引入文档)

• 什么时候用：当你需要使用某个特定的第三方库（如 Stripe 支付、Next.js 新特性），或者公司内部有特定的开发规范时。

• 它的作用：你可以把文档链接或内容发给它，让它基于这份资料来写代码，而不是瞎编（减少幻觉）。

• 好处：保证代码符合最新的 API 规范，提高准确率。

/agent (Agent Mode - 智能体模式)

• 什么时候用：当你觉得当前的 AI 太“话痨”只想聊天，或者太“死板”不会变通时。

• 它的作用：用于切换 AI 的工作状态。比如在“仅回答问题的 Chat 模式”和“可以直接修改文件的 Builder/SOLO 模式”之间切换。

• 好处：灵活控制 AI 的权限和行为风格。

/builder (Builder Mode - 构建者模式)

• 什么时候用：当你明确需要 AI 跨文件进行代码编写、重构或直接动手搭建项目时。

• 它的作用：这是 Trae 的核心工作模式之一。与只动嘴不动手的 Chat 模式不同，Builder 拥有直接操作你本地文件的权限，能根据上下文主动完成编码任务。

• 好处：真正解放双手，让 AI 成为你的结对编程伙伴，直接产出可运行的代码。

/clear (Clear Context - 清除上下文)

• 什么时候用：当对话太长导致 AI 反应变慢，或者之前的讨论把你带沟里去了，你想换个话题重新开始时。

• 它的作用：一键清空 AI 的短期记忆（对话历史）。

• 注意：它不会删除你硬盘上已经写好的代码文件，只是让 AI 忘掉之前的聊天记录。

/commit (Git Commit - 提交代码)

• 什么时候用：当你完成了一个小功能的开发，准备把代码保存到 Git 仓库时。

• 它的作用：AI 会自动分析你改了哪些代码，然后帮你写一条清晰、规范的 Git Commit Message（比如 feat: add user login api），并执行提交操作。

• 好处：省去自己绞尽脑汁想提交信息的麻烦，保持代码仓库整洁。

---

💡 最佳工作流建议

在实际开发中，你可以这样串联使用它们：

1. 遇到复杂需求，先用 /spec 厘清思路。

2. 确认后，用 /plan 制定开发路线图。

3. 开发过程中，如果需要查特定库的用法，随时调用 /docs。

4. 如果发现聊偏了或卡住了，果断用 /clear 重启。

5. 写完一个功能后，用 /commit 优雅地保存进度。