3分钟打造专属AI编码助手：Roo Code自定义模式全攻略

2026-02-05 04:37:15作者：殷蕙予

你是否还在为重复编写相同类型的代码而烦恼？是否希望AI能完全按照你的团队规范生成代码？Roo Code的自定义模式功能正是为解决这些问题而生。本文将带你从零开始创建专属开发流程，通过3个实战案例掌握自定义模式核心技巧，让AI助手真正成为你的团队成员。

自定义模式基础：打破固定思维的AI助手

Roo Code提供的默认模式（Code、Architect、Ask、Debug）已能满足大部分开发需求，但每个团队都有独特的工作流和规范。自定义模式允许你构建专属AI助手角色，通过预设指令、工具权限和交互流程，让AI严格遵循团队最佳实践。

核心价值

统一团队规范：将代码风格、文档标准编码为模式，新人上手速度提升40%
自动化重复任务：测试生成、注释完善、代码检查等流程一键触发
领域知识沉淀：把架构经验、业务规则转化为可复用的AI指令

官方文档：README.md
模式系统源码：src/core/config/CustomModesManager.ts

快速上手：5步创建你的第一个自定义模式

1. 模式文件结构

自定义模式通过YAML格式定义，支持全局模式（用户级）和项目模式（工作区级）：

# .roo/modes/security-review.yaml
name: "Security Reviewer"
description: "代码安全审计专家，检测常见漏洞并提供修复建议"
instructions: |
  作为安全审计专家，请遵循以下步骤检查代码：
  1. 识别输入验证问题（SQL注入、XSS等）
  2. 检查认证授权逻辑
  3. 验证敏感数据处理
  4. 提供符合OWASP标准的修复方案
tools:
  - search_files
  - read_file
  - write_file
allowedCommands: []

2. 关键配置项解析

配置项	作用	示例值
`name`	模式名称（显示在UI上）	"API文档生成器"
`instructions`	AI行为准则和工作流程	"优先使用TypeScript类型定义..."
`tools`	允许使用的工具列表	["read_file", "search_files"]
`allowedCommands`	可执行的终端命令	["npm run lint", "git status"]
`filePatterns`	关注的文件模式	[".ts", ".js", "!node_modules/**"]

配置详解：src/shared/modes.ts

3. 安装与激活

将模式文件保存到以下位置之一：
- 全局模式：~/.roo/modes/
- 项目模式：项目根目录/.roomodes/
在Roo Code面板中点击模式选择器，找到你的自定义模式并点击激活

实战案例：三个提升开发效率的自定义模式

案例1：RESTful API自动生成器

痛点：手动编写API CRUD接口时重复劳动，参数验证和错误处理代码冗余。

模式设计：

name: "API Generator"
description: "根据数据模型自动生成RESTful API接口"
instructions: |
  1. 分析用户提供的TypeScript接口定义
  2. 生成符合REST规范的CRUD端点
  3. 添加Joi参数验证和错误处理
  4. 生成Swagger文档注释
tools:
  - read_file
  - write_file
filePatterns: ["src/models/*.ts", "src/routes/*.ts"]

使用效果：输入数据模型接口后，自动生成完整的路由文件、控制器和测试用例，平均节省30分钟/接口。

案例2：遗留代码现代化助手

痛点：将旧JavaScript项目迁移到TypeScript时，类型定义编写耗时且易出错。

模式设计：

name: "TS Migration Assistant"
description: "将JavaScript代码转换为TypeScript并添加类型定义"
instructions: |
  执行以下步骤迁移代码：
  1. 将.js文件重命名为.ts
  2. 为函数参数和返回值添加类型注解
  3. 识别并定义接口类型
  4. 解决any类型，优先使用具体类型
tools:
  - read_file
  - write_file
  - search_files
allowedCommands: ["tsc --noEmit"]

使用技巧：配合search_files工具批量处理：

@Roo 使用TS Migration Assistant处理src/utils/**/*.js

案例3：合规文档生成器

痛点：金融项目需要生成符合PCI-DSS规范的文档，手动编写易遗漏。

模式设计：

name: "合规文档生成器"
description: "自动生成符合PCI-DSS标准的安全文档"
instructions: |
  根据代码实现生成以下安全文档：
  1. 数据流程图（标记敏感数据流向）
  2. 加密算法使用清单
  3. 访问控制矩阵
  4. 安全审计日志规范
tools:
  - read_file
  - search_files
  - write_file
filePatterns: ["src/services/**/*.ts", "src/middleware/auth.ts"]

文档模板源码：src/core/prompts/instructions/create-mode.ts

高级技巧：打造智能协作型自定义模式

1. 模式组合与继承

通过extends属性继承其他模式的配置，实现模式复用：

extends: "code"  # 继承基础Code模式
name: "React Component Generator"
instructions: |
  在基础编码模式上增加：
  - 使用React函数组件和TypeScript
  - 遵循Atomic Design原则
  - 自动生成Storybook文档

继承逻辑实现：src/core/config/CustomModesManager.ts

2. 动态工具权限控制

根据文件类型动态调整工具权限，增强安全性：

name: "安全模式"
tools:
  - read_file
conditionalTools:
  - tool: write_file
    condition: "file.path.includes('docs/') || file.path.includes('tests/')"

安全检查实现：src/core/tools/tests/validateToolUse.spec.ts

3. 多模态交互设计

结合Roo Code的Roomote Control功能，实现模式间协作：

name: "Full Stack Developer"
instructions: |
  当需要前端实现时：
  <roomote mode="react-component-generator">生成UI组件</roomote>
  
  当需要后端API时：
  <roomote mode="api-generator">创建数据接口</roomote>

跨模式通信：src/shared/mcp.ts