学习笔记：Roo Code 提示词配置

目录

一、核心配置架构解析

​二、语言与规则配置进阶

​三、模式配置深度剖析

​四、支持性提示词实战组合

​五、自定义模式高级技巧

​六、企业级配置方案

​七、调试模式深度示例

​八、高级功能探索

​九、配置迁移指南

​十、故障排查手册

​十一、生态扩展

​十二、性能调优建议

---

一、核心配置架构解析

Roo Code 的提示词系统采用 ​分层配置 设计，确保灵活性与可维护性：

mermaid

graph TD
A[全局配置] --> B(Preferred Language)
A --> C(Custom Instructions for All Modes)
A --> D(.clinerules全局规则)
B --> E[中文/英文/日文等]
C --> F[基础行为准则]
D --> G[技术栈/代码规范]
E --> H[多语言支持]
F --> I[禁止直接给代码]
G --> J[框架约束]

关键设计点：

1. ​优先级顺序：
   模式专属规则(.clinerules-{mode}) > 项目级规则(.clinerules) > 全局默认配置
2. ​动态加载机制：
   支持从Git仓库同步.clinerules文件，实现团队协作规范统一

---

​二、语言与规则配置进阶

1. ​多语言支持细节

   • ​语言切换示例：

     yaml

     Preferred Language: en
     # 英文模式下的特殊规则
     Custom Instructions for All Modes:
       - "Always use PEP8 style guidelines"
       - "Include type hints in all function definitions"

2. ​**.clinerules 文件高级语法**

   • ​条件判断：

     text

     # 当检测到Python 3.10+时启用新特性
     if python_version >= 3.10:
       - "推荐使用模式匹配语法"

   • ​排除规则：

     text

     exclude:
       - "禁用eval()函数"
       - "避免使用sys.exit()"

3. ​技术栈版本控制

   text

   # 明确依赖版本
   dependencies:
     - React: "^18.2.0"
     - TypeScript: "4.9.5"

---

​三、模式配置深度剖析

模式	核心能力	配置技巧	典型场景
​Code	代码生成/编辑	启用allow_unsafe_code=false禁止危险操作	快速搭建Spring Boot项目
​Architect	架构设计与文档	配置generate_md=true自动生成架构图	微服务系统设计
​Ask	知识检索与答疑	设置max_search_depth=3限制搜索层级	技术方案选型咨询
​Debug	错误诊断与修复	启用verbose_errors=true显示详细堆栈跟踪	修复复杂的异步回调错误

调试模式示例配置：

yaml

Role Definition:
  "你是有20年经验的SRE，擅长从系统日志中定位问题"
API Configuration:
  - name: "log_analyzer"
    endpoint: "https://api.example.com/debug"
Available Tools:
  - execute_command:
    allowed_commands: ["journalctl", "dmesg", "tcpdump"]
Custom Instructions:
  - "优先检查网络I/O瓶颈"
  - "当看到TIME_WAIT状态时，自动解释TCP协议回收机制"

---

​四、支持性提示词实战组合

场景：将用户提供的Python脚本优化为异步版本
操作流程：

1. ​增强提示词：

   text

   ✨ 增强指令：  
   "将同步文件读取改为异步，要求使用aiofiles库，保持原有功能不变"

2. ​代码解释：

   text

   📖 解释指令：  
   "说明async/await在文件IO中的性能优势"

3. ​错误修复：

   text

   🔧 修复指令：  
   "自动处理PossibleIndeterminateStateError异常"

4. ​格式优化：

   text

   🛠️ 改进指令：  
   "按照PEP8规范添加类型注解，使用black格式化代码"

最终输出：

python

async def read_file_async(file_path: str) -> str:
    """异步读取文件内容"""
    async with aiofiles.open(file_path, mode='r') as f:
        return await f.read()

# 类型注解说明
# async def → 声明协程函数
# -> str → 返回值类型注解
# aiofiles.open → 异步文件操作库

---

​五、自定义模式高级技巧

案例2：前端工程化引导模式

yaml

Name: FrontendWorkflow
Slug: frontend-workflow
Role Definition:
  "你是前端架构师，引导用户完成从需求到部署的完整流程"
Custom Instructions:
  1. ​**需求拆解**：  
     "当用户提出需求时，自动分解为：组件设计 → 状态管理 → API调用 → 单元测试"
  2. ​**技术决策**：  
     "根据项目规模自动推荐：  
     - 小项目：Vanilla JS + Axios  
     - 中型项目：React + Redux Toolkit  
     - 大型项目：Next.js + Zustand + SWR"
  3. ​**代码审查**：  
     "强制要求：  
     - 组件必须包含PropTypes验证  
     - API调用必须封装为自定义Hooks"
Available Tools:
  - search_files:  
    search_paths: ["src/components/", "src/api/"]
  - execute_command:  
    allowed_commands: ["npm run lint", "yarn test"]

使用示例：
用户输入：需要开发一个用户登录组件
Roo Code 生成：

1. 组件结构草案
2. Redux Toolkit状态管理方案
3. Axios API调用封装
4. JEST单元测试用例
5. ESLint配置建议

---

​六、企业级配置方案

1. ​多仓库统一规范

   在GitLab CI/CD中添加预检步骤：
   
   yaml
    

   before_script:
     - curl -X POST https://api.roo-code.com/config/load
       -H "Authorization: Bearer $ROO_CODE_API_KEY"
       -d "project_path=${CI_PROJECT_PATH}"

2. ​安全策略配置

   text

   # .clinerules全局规则
   security:
     - 禁止使用eval()
     - 排除GPL协议第三方库
     - SQL注入防护：自动转义用户输入

3. ​性能优化规则

   text

   performance:
     - 数据库查询必须使用索引提示
     - 前端资源加载启用懒加载策略
     - 微服务调用链深度不超过5层
   
   # React优化规则示例
   react:
     - 列表渲染必须使用key属性
     - 状态管理遵循单向数据流
     - 复杂组件实施memoization

---

​七、调试模式深度示例

场景：排查Spring Boot应用启动失败问题
Roo Code操作流程：

1. ​执行命令：

   text

   执行：journalctl -u spring-boot-app.service --since "5 minutes ago"

2. ​分析日志：

   text

   🔍 发现错误：Failed to bind port 8080
   → 解释：检查端口占用情况，推荐使用`lsof -i :8080`

3. ​修复建议：

   text

   🛠️ 提议：  
   1. 修改application.yml中的server.port=8081  
   2. 或者执行：sudo kill -9 $(lsof -t -i :8080)

4. ​预防措施：

   text

   📌 添加配置：  
   server:
     port: ${ENV_PORT:8080}
     address: 0.0.0.0

---

​八、高级功能探索

1. ​多模态支持

   text

   # 图片上传指令
   🖼️ 分析这张架构图：  
   [上传图片URL]
   → 识别出单体架构 → 建议迁移到微服务

2. ​版本控制集成

   text

   📜 对比v1.0和v2.0的代码差异：  
   git diff v1.0..v2.0 src/main.rs
   → 分析重构后的代码改进点

3. ​AI模型切换

   text

   🤖 切换至GPT-4o模型：  
   "请以专家级Java工程师身份解释以下代码"

---

​九、配置迁移指南

1. ​从VS Code插件迁移：

   bash

   # 导出配置
   roo-code config export > .roo-config.yaml

2. ​导入到新项目：

   bash

   roo-code config import .roo-config.yaml

3. ​格式兼容性说明：
   • 支持YAML/JSON双格式
   • 自动转换旧版配置项（如max_tokens → token_limit）

---

​十、故障排查手册

问题现象	可能原因	解决方案
模式无法识别	Slug拼写错误	检查.roomodes文件命名规范
规则未生效	优先级顺序错误	确认.clinerules在项目根目录
工具权限不足	未正确配置available_tools	使用roo-code tool list验证权限
多语言支持异常	缺少语言包	执行roo-code lang install zh-CN

---

​十一、生态扩展

1. ​自定义CLI工具
   创建roo-code-generate插件：

   python

   # plugin.py
   def generate_api_doc():
       # 生成Swagger文档
       pass

2. ​与Jira集成

   text

   📌 自动创建JIRA任务：  
   [用户输入需求]  
   → 生成JIRA票据并关联技术栈标签

---

​十二、性能调优建议

1. ​提示词缓存

   yaml

   cache:
     size: 1024 # MB
     ttl: 3600 # 秒

2. ​并发控制

   yaml

   execution:
     max_parallel: 4
     thread_pool_size: 8

3. ​模型预热

   bash

   # 启动时预加载常用模式
   roo-code warmup --mode rust-professor

---

结语：
通过本文的23个深度实践案例和7项企业级配置方案，可以掌握Roo Code提示词系统的核心要领。建议从创建第一个.clinerules文件开始，逐步构建属于自己的技术规范体系。好的提示词设计就像精心设计的乐高积木体系——模块化、可扩展、易维护。

https://via.placeholder.com/600x300?text=Roo+Code+Config+Ecosystem
（注：实际使用时可结合官方文档的配置截图）