06 安装 luatos-docs-code 智能体、规则和技能
作者：朱天华 | 最后修改：2026-05-03
重要提醒：
1、当你安装配置好智能体、规则和技能后，最终一定要参考验证智能体、规则和技能是否安装成功来验证安装配置是否正确；
2、Trae中内置的免费大模型，会经常排队，并且性能不可控，容易出问题，所以推荐参考：001 发送会话请求时，提示排队，如何解决？的方法，订阅收费的大模型（目前每月40元）；这样可以大大提高AI性能；如果不想使用收费模型，在非正常工作时间段内，使用内置的免费模型也能勉强凑合；
3、选择收费大模型时，经过我们的实际测试，根据工作任务的不同，可以按照如下建议选择（仅供参考，具体情况还需要根据你自己的实际使用情况来定）：
- 代码开发任务，优先选择GLM（可能是使用的人数太多，有时候处理较慢）；如果GLM处理太慢，再考虑切换到MiniMax；
- 其他任务，可以首先选择ark-code-latest，其次选择MiniMax，最后选择GLM（可能是使用的人数太多，有时候处理较慢）；
一、什么是 luatos-docs-code 智能体
在上一篇文章中，我们已经了解到：Trae 中的智能体分为 内置智能体 和 自定义智能体 两大类；
luatos-docs-code智能体 就是一种自定义智能体，从本篇文章开始，我们接下来的内容都会围绕 luatos-docs-code智能体 来介绍；
为了简化文章内容的篇幅，后续我们会把 luatos-docs-code智能体 简称为 luatos-docs-code；
再来看下为什么命名为 luatos-docs-code 这个名字？从以下三方面来理解：
- LuatOS 既是上海合宙推出的一款开源轻量级嵌入式操作系统，也是合宙的商标，所以用 LuatOS 表示合宙；
- 合宙所有产品的资料都在 https://docs.openluat.com/这个网站，所以用 docs 表示合宙所有产品的资料；
- code 是代码的意思，所以用 code 表示合宙的产品支持软件二次开发；这些产品的 demo 和项目源码都在 https://gitee.com/openLuat/LuatOS/tree/master/module 中；
所以我们命名为 luatos-docs-code；
另外，luatos-docs-code 这个智能体，通过名字就可以很直观地看出，它可以实时访问合宙最新的 docs 资料以及 code 代码来和用户交流；
虽然我们把它命名为 luatos-docs-code，但是如果你觉得不好听，你在 Trae 中可以随便修改为任意名字；
为了后续文章描述统一，所以在整个教程中，我们都使用 luatos-docs-code 这个名字，如果你觉得这个名字不好，自己修改为了其他名字，例如 my-ai-agent，在阅读我们的文章时，只需要记住一点：
将文章内容中的 luatos-docs-code 替换为 my-ai-agent 来理解即可；
二、导入 luatos-docs-code 智能体
在导入安装 luatos-docs-code 智能体之前，确保你已经参考Trae 的安装和智能体概念理解在你的电脑上成功安装了 Trae；
可以通过三种方式来创建 luatos-docs-code：
- 直接导入：这种方式最简单，合宙创建并且调试配置好
luatos-docs-code，然后分享一个链接出来，用户可以直接点击这个链接，可以在 Trae 中自动导入这个luatos-docs-code - 智能配置：在 Trae 中一步步的自主创建并且配置
luatos-docs-code，和直接导入的方式相比，此方式比较繁琐，所以在本章节就不再讲解；大家有兴趣可以访问 Trae 官方教程智能生成自定义智能体学习； - 手动配置：仍然是在 Trae 中一步步的自主创建并且配置
luatos-docs-code，和智能配置的方式相比，此方式又繁琐了一些，所以在本章节就不再讲解；大家有兴趣可以访问 Trae 官方教程手动创建自定义智能体学习；
现在我们来看下，使用直接导入的方式，如何创建 luatos-docs-code；
2.1 点击合宙官方分享的 luatos-docs-code 链接
点击这里，可以看到 luatos-docs-code 版本列表 ；
在 luatos-docs-code 后面有 xxx 格式的版本号，xxx 的取值范围从 100 到 999；
例如 luatos-docs-code-101 表示 101 版本，也就是第二个版本；
分享链接有国内版和国际版两种，根据你使用的 Trae 来选择；
国内版和国际版的 Trae 使用方法基本一致，所以从本文开始，若无特别说明，都会以国内版的 Trea 来举例说明；
在编写本文章时，最新版本号为 101，因此我们以 101 版本为例来说明，点击这里，可以看到 101版本链接 ；
重要注意事项：当你阅读到此处时，一定要使用最新版本的智能体分享链接，因为101版本很可能已经不是最新的版本，最新版本的智能体安装方式和101版本的安装方式完全一样，只是分享链接不同；例如最新版本如果是103，你只需要点击103版本的分享链接即可，不需要再点击安装小于103的版本的分享链接；
2.2 在 PC 端浏览器页面允许打开 Trae CN
此时在 PC 端浏览器页面，会弹出如下图所示的小窗口，点击 打开Trae CN 按钮
2.3 自动打开 Trae，并且手动确认获取 luatos-docs-code
此时会自动打开 Trae 工具，并且弹出如下图所示的小窗口，可以看到智能体的名称为 luatos-docs-code-101；
点击 立即获取 按钮
显示如下窗口，可以看到这个智能体的详细配置信息，不用修改任何配置，直接点击 保存 按钮即可
此时会弹出下图所示的 变更已保存 小窗口，点击 立即使用 按钮
此时在聊天会话窗口就会自动切换为 luatos-docs-code-101，如下图所示；
如果没有选择 luatos-docs-code-101，点击箭头位置，在弹出列表中手动选择 luatos-docs-code-101
三、更新 luatos-docs-code 智能体
3.1 为什么需要更新 luatos-docs-code
为什么需要更新 luatos-docs-code？
带着这个问题，我们来看下 luatos-docs-code-101 的配置；
按照下图操作
此时会打开 luatos-docs-code-101 的配置界面，如下图所示
提示词
提示词的作用是：用于规范和指导智能体完成任务的方式；可以规定智能体的人设、回答口吻、工作流程、使用工具的时机和需要遵守的规范等；- 在
luatos-docs-code中，我们配置了这个智能体的提示词； - 在实际使用过程中，可能会发现某些提示词不合适，或者需要新增提示词内容；
- 所以说，
luatos-docs-code中的提示词需要修改的概率就会比较高；
工具
工具的作用是：配置智能体处理需求时可以调用的工具；- 在
luatos-docs-code中，我们默认配置了 luatos-code 和 luatos-docs 这两个 MCP Server 工具 - luatos-code 会基于合宙的代码仓库 https://gitee.com/openLuat/LuatOS/tree/master/module 和 https://gitee.com/openLuat/LuatOS/tree/master/script 提供服务；
- 一般来说，如果需要修改，也是 MCP Server 端去修改，而
luatos-docs-code做为 MCP Client 端不需要修改； - 所以，一般情况下，
luatos-docs-code中的工具配置项保持目前的默认状态即可，不需要修改；
3.2 更新 luatos-docs-code 的本质是什么
点击这里，可以看到 luatos-docs-code 版本列表 ；
我们可以看到：
- 每个
luatos-docs-code智能体版本都有它对应的提示词； - 每个
luatos-docs-code智能体版本的更新记录就是更新它对应的提示词；
所以说，更新 luatos-docs-code 智能体，实际上就是更新它的 提示词；
3.3 如何更新 luatos-docs-code
3.3.1 如果需要和合宙官方的配置保持一致
点击这里，可以看到 luatos-docs-code 版本列表
如果合宙官方有最新版本，可以通过以下两种方式（二选一即可；推荐使用第一种，因为更简单，不会出错）进行更新：
- 参考本文第二章节的内容，操作步骤完全一样；更新为新版本之后，可以在 Trae 中手动删除旧版本；
- 根据合宙官方最新版本的
提示词内容，直接在 Trae 中复制为最新版本的官方提示词，然后名称和英文标识名都修改为最新的版本号，最后点击保存按钮即可；如下图所示
3.3.2 如果不需要和合宙官方的配置保持一致
如果你觉得合宙官方的配置不合适，或者官方更新的太慢，你也可以随时修改 luatos-docs-code 的 提示词，修改之后，点击 保存 按钮保存即可；
如果你修改了提示词之后，luatos-docs-code 可以工作得更好，我们真诚地希望你可以把修改记录分享给我们，我们可以合入到官方后续版本的配置中。
四、什么是 luatos-docs-code 智能体使用的规则和技能
点击右方的链接，大家自行看下 Trae 官方对规则和技能的解释：规则 技能
luatos-docs-code 智能体使用的规则和技能，总结下来，作用如下：
- 通过规则来规范
luatos-docs-code在 Trae 内的行为，使luatos-docs-code输出内容更符合要求； - 通过技能为
luatos-docs-code提供可复用、面向特定场景的专业能力；
编写本文章时，我们提供了一项规则和三项技能给 luatos-docs-code 智能体使用
luatos-project-rules规则：定义了luatos-docs-code智能体工作时，全程需要遵守的基本规则；luatos-query-route-skill技能：定义了luatos-docs-code智能体工作时，全程需要遵守的基本流程；luatos-new-project-skill技能：定义了luatos-docs-code智能体工作时，开发一个全新的 LuatOS 应用项目代码时需要遵守的基本流程；luatos-update-project-skill技能：定义了luatos-docs-code智能体工作时，在已经存在的 LuatOS 应用项目中修改代码时需要遵守的基本流程；
编写本文章的日期是 2026 年 3 月 21 日，支持的规则和技能如上所述，后续随着版本的演进，规则和技能的内容可能会做修改，以最新版本的内容为准；
五、手动导入 luatos-docs-code 智能体使用的规则和技能
导入规则和技能，有两种方法：手动导入和智能导入；
手动导入的方法：顾名思义，就是需要你一步步的操作，来导入规则和技能；本章节描述的就是手动导入的方法；
智能导入的方法：在 Trae 中的智能体中输入一段命令，智能体会自动访问合宙的仓库，下载并且安装规则技能；
无论是手动导入还是智能导入，安装好的规则和技能都和Trae打开的项目文件夹绑定在一起；当Trae切换到一个新的项目文件夹时，还需要重新安装规则和技能；如果你不确定是否需要安装规则和技能，也没关系，当你使用 luatos-docs-code 智能体时，Trae 会自动提示你是否需要安装规则和技能；
在本章节我们仅仅讲解手动导入的方法；在下一章节我们会讲解智能导入的方法；如果你不想手动导入，可以跳过本章节，直接进入下一章节；
5.1 下载合宙官方的规则和技能
点击这里，可以看到 luatos-docs-code 版本列表 ；
编写本文章时，最新版本号为 101，因此我们以 101 版本为例来说明，点击 101 版本中的规则和技能完整压缩包，如下图中红框所示：
5.2 将规则和技能压缩包放到 Trae 项目目录下
如果你不知道 Trae 的项目目录在哪里，有以下两种方法可以获取：
1、参考运行 Trae 并且新建一个项目，找到当初使用的项目目录
2、在 SOLO 模式下，如下图所示操作
在我的电脑上，当前项目目录为 E:\Trae_LuatOS_Projects，所以我把下载下来的 luatos-docs-code-101_rules&skills.zip 压缩包文件，直接放到 E:\Trae_LuatOS_Projects 目录中，如下图所示
5.3 将规则和技能压缩包解压到当前位置
此时在 luatos-docs-code-101_rules&skills.zip 点击鼠标右键，直接 解压到当前位置，如下图所示
解压缩之后，在当前目录下可以看到有一个.trae 文件夹，文件夹中的子文件夹和子文件如下图所示，红框中所标注的四个文件，即为 1 个规则文件和 3 个技能文件：
相对路径依次为：
- .trae\rules\luatos-project-rules.md
- .trae\skills\luatos-query-route-skill\SKILL.md
- .trae\skills\luatos-new-project-skill\SKILL.md
- .trae\skills\luatos-update-project-skill\SKILL.md
六、智能导入 luatos-docs-code 智能体使用的规则和技能
导入规则和技能，有两种方法：手动导入和智能导入；
手动导入的方法：顾名思义，就是需要你一步步的操作，来导入规则和技能；本章节描述的就是手动导入的方法；
智能导入的方法：在 Trae 中的智能体中输入一段命令，智能体会自动访问合宙的仓库，下载并且安装规则技能；
无论是手动导入还是智能导入，安装好的规则和技能都和Trae打开的项目文件夹绑定在一起；当Trae切换到一个新的项目文件夹时，还需要重新安装规则和技能；如果你不确定是否需要安装规则和技能，也没关系，当你使用 luatos-docs-code 智能体时，Trae 会自动提示你是否需要安装规则和技能；
在本章节我们仅仅讲解智能导入的方法；如果你通过上一章节的手动导入方式，已经成功安装了规则和技能，那么你可以忽略本章节，直接进入下一章节；
6.1 在Trae的SOLO模式下打开项目文件夹和luatos-docs-code智能体
参考本文第二章节，你已经打开了一个项目文件夹和 luatos-docs-code 智能体；
例如打开的项目文件夹是Trae_LuatOS_Projects，智能体是luatos-docs-code-103，安装项目和规则前项目文件夹下的内容为空，如下图所示：
6.2 输入智能导入规则和技能的提示词
在 Trae 的聊天会话窗口中，输入下面一段话，并且点击发送按钮;
访问： https://gitee.com/openLuat/luatos-ai-agent/tree/master/Trae/luatos-docs-code/.trae ，帮我安装这个url下的项目规则和项目技能到本项目中，如果同名，则覆盖安装
如下图所示：
6.3 智能体自动下载并且安装规则和技能到当前项目文件夹
接下来，智能体会自动下载并且安装规则和技能到当前项目文件夹，在安装过程中，如果弹出对话框请求权限，需要手动点击按钮允许一些权限才能完成安装；
完整的自动安装过程如下图所示：
安装完成后，项目文件夹下会出现一个.trae文件夹，此文件夹下存在的就是安装好的项目规则和技能文件，内容如下图所示：
七、 验证智能体、规则和技能是否安装成功
接下来我们在聊天会话窗口，使用 luatos-docs-code 智能体（本章节以 luatos-docs-code-103 智能体为例），输入提示词：完整并且详细地告诉我，我给你配置了哪些提示词、规则和技能？，并且点击发送按钮
看 luatos-docs-code-103 的返回，如果返回的内容如下图中红框所示，正确识别到了智能体的核心工作机制，2 个规则和 5个技能，就表示智能体、规则和技能已经安装成功；
注意：不同模型给出的回复内容可能会有差异，只要识别到的工作机制、规则和技能，和你配置的智能体提示词、规则和技能基本一致就可以；
八、更新 luatos-docs-code 智能体使用的规则和技能
8.1 为什么需要更新 luatos-docs-code 智能体使用的规则和技能
在实际使用过程中，如果发现了新的问题或者新的需求，旧的规则和技能无法解决这些问题和需求；
此时就可以修改规则和技能描述文件，来解决这些新的问题和需求；
8.2 如何更新 luatos-docs-code 智能体使用的规则和技能
8.2.1 如果需要和合宙官方的配置保持一致
推荐大家使用这种方式，因为操作简单，不容易出错；
点击这里，可以看到 luatos-docs-code 版本列表
如果合宙官方有最新版本的规则和技能文件，可以参考本文第五章节或者第六章节，导入新版本的规则和技能文件即可；
8.2.2 如果不需要和合宙官方的配置保持一致
如果你觉得合宙官方的配置不合适，或者官方更新的太慢，你也可以随时修改规则和技能描述；
前提是你对 Trae 的配置非常熟悉，并且了解规则和技能文件的格式，如果不熟悉，会很容易出错；
配置过程如下图所示：
如果你修改了规则和技能之后，luatos-docs-code 可以工作得更好，我们真诚地希望你可以把修改记录分享给我们，我们可以合入到官方后续版本的配置中。
九、luatos-docs-code 智能体提供哪些服务
luatos-docs-code 可以提供哪些服务？
在总结回答这个问题之前，我们可以直接在聊天会话窗口问一下 luatos-docs-code，看它如何回答这个问题；
luatos-docs-code 总结的还可以，它可以提供合宙产品的代码相关的服务以及文档相关的服务；
再进一步说明就是：
- 可以提供合宙产品的知识资讯类的服务，例如方案选型、产品知识、硬件知识、LuatOS 软件知识、AT 软件知识、web 知识、上位机工具知识等；
- 可以提供 LuatOS 软件项目开发类的服务，例如总体设计，详细设计，代码开发，代码改错，代码运行日志分析等;
在接下来的文章中，我们将列举很多示例，来详细说明如何使用 luatos-docs-code；