Roo Code 如何导出与导入自定义模式 YAML 文件以备份和团队共享【免费下载链接】Roo-CodeRoo Code gives you a whole dev team of AI agents in your code editor.项目地址: https://gitcode.com/GitHub_Trending/ro/Roo-Code当你在 Roo Code 中调好一个自定义模式Custom Mode后经常会遇到两类需求一是备份自己的模式配置防止丢失二是把模式连同它的规则文件一起交给团队成员让对方在一个新项目中一键还原。Roo Code 的Import/Export Modes功能自 v3.22.6 起提供见 v3.22.6 更新说明可以把任意一个模式及其关联规则打包进单个可移植的.yaml文件再导入到任意项目中自动完成配置。本文基于官方文档 Customizing Modes 的 Import/Export Modes 章节给出导出、导入项目级/全局级以及导入前修改 slug 的完整操作路径。前置条件确认模式及其规则存放位置Roo Code 的自定义模式分两种作用域导出前先确认你要导出的模式属于哪一种全局模式Global在所有项目中可用配置存放在settings/custom_modes.yaml推荐YAML或custom_modes.json项目模式Project只在单个项目中定义配置存放在项目根目录的.roomodes文件可为 YAML 或 JSON。打开 Modes 视图的入口在 Roo Code 面板中点击聊天框下方的 Mode 菜单再点击设置齿轮图标settings-gear。模式的规则文件指令内容存放在与模式 slug 对应的目录中项目模式{workspace}/.roo/rules-{slug}/全局模式~/.roo/rules-{slug}/导出功能会把模式配置和该目录下的规则文件一起打包因此团队共享时对方不需要再手动复制.roo/rules-{slug}/文件夹。导出模式为 YAML 文件在 Modes 视图中按以下步骤操作打开Modes视图选中要导出的模式点击Export Mode按钮下载图标选择保存位置生成一个.yaml文件。导出时 Roo Code 会把模式的配置和项目中.roo/rules-{slug}/目录里找到的所有规则打包进 YAML 文件。如果该模式带有规则导出时所有文件路径都会被规范化为正斜杠forward slashes以便在不同操作系统之间共享。导出文件的格式如下文档示例字段值来自官方文档中的示例customModes: - slug: my-custom-mode name: My Custom Mode roleDefinition: You are a helpful assistant. groups: [read, edit] rulesFiles: - relativePath: rules-my-custom-mode/rules.md content: These are the rules for my custom mode.各字段含义与 自定义模式文档 的属性表一致slug模式唯一内部标识必须匹配/^[a-zA-Z0-9-]$/只允许字母、数字和连字符nameRoo Code 界面中显示的名称roleDefinition放在系统提示词开头的模式角色定义groups该模式可访问的工具组可用字符串为read、edit、command、mcprulesFiles规则文件列表每项含relativePath与content即被打包进 YAML 的指令文件。内置模式如 Code、Architect、Ask、Debug如果被你定制过例如修改了指令同样可以导出定制内容会包含在导出结果中方便把个人化的内置模式版本分享给他人。导入 YAML 文件选择 Project 或 Global导入入口在同一个 Modes 视图点击Import Mode按钮上传图标选择要导入的模式 YAML 文件在弹出的对话框中选择导入级别Project模式只在当前工作区可用。它会被写入项目根目录的.roomodes文件规则保存到项目内的.roo/rules-{slug}/目录Global模式在你的所有项目中可用。它会被写入全局设置规则存放到全局 Roo 配置目录例如~/.roo/rules-{slug}/。选择依据很简单要随某个项目分发给团队就用 Project 级导入让.roomodes和规则目录跟项目一起进版本库要装到个人环境长期使用就用 Global。导入前修改 slug如果需要把导入的模式换个身份避免与本地已有模式冲突可以直接编辑 YAML 文件里的slug再导入导出一个 slug 为original-mode的模式编辑 YAML 文件把slug改为new-mode导入该文件——导入过程会创建带新 slug 的模式并自动把规则文件路径更新为匹配新 slug无需手动改路径。注意修改后的 slug 仍须符合/^[a-zA-Z0-9-]$/的格式约束。验证导入结果导入完成后按以下方式核对模式应出现在 Roo Code 的模式选择器mode selector中。如果创建或导入模式后模式没有出现重新加载 VS Code 窗口reload即可——这是官方文档 Troubleshooting 部分列出的已知情况检查落盘位置Project 级导入后项目根目录的.roomodes中应出现该模式项目内.roo/rules-{slug}/目录中应有规则文件Global 级导入后全局设置中出现该模式规则位于~/.roo/rules-{slug}/全局导入同样保留规则只是存放位置从项目.roo目录变为用户主目录下的全局目录。导入冲突与优先级边界以下几点来自文档 FAQ 与 Configuration Precedence 章节团队共享前需要明确同 slug 导入会覆盖导入的模式slug与现有模式相同时现有模式会被导入文件中的配置覆盖。团队分发前建议先核对 slug或在导入前按上一节修改 slug。项目级配置完全覆盖全局当.roomodes与全局设置中存在同 slug 的模式时.roomodes版本会完全取代全局版本适用于所有属性不会做属性合并。因此如果某成员既全局导入了该模式其项目中.roomodes又有同名 slug实际生效的是项目版本。source属性由系统自动添加不应手动设置。如果导入的 YAML 中fileRegex模式无效Roo Code 会报 “Invalid regular expression pattern” 错误需要先修正正则再使用。完成上述步骤后团队成员只需在各自项目或环境中执行一次导入就能得到与你相同的行为配置和规则集后续模式变更只需重新导出 YAML 并再次分发。更多模式属性细节可参考 Customizing Modes 全文。【免费下载链接】Roo-CodeRoo Code gives you a whole dev team of AI agents in your code editor.项目地址: https://gitcode.com/GitHub_Trending/ro/Roo-Code创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考