mcpField
R
robocorp-cursor-rules

robocorp-cursor-rules

github.com/mindrally开发287640 次安装3 周前更新
代码仓库

关于 robocorp-cursor-rules

为 Python 与 RoboCorp RPA 开发提供编码规范的技能，面向编写和维护自动化任务的开发者。内容涵盖函数式结构、类型验证、错误处理与性能建议。

主要功能

  1. 01函数式 Python 编码规范
  2. 02类型提示与 Pydantic 验证
  3. 03错误处理与输入校验
  4. 04RoboCorp 任务结构建议
  5. 05异步 I/O 与性能建议

适用场景

  1. 01规划 RoboCorp 任务文件结构
  2. 02为函数补充类型与输入验证
  3. 03改进错误处理和边界检查
  4. 04评估 I/O 密集任务的异步处理

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/mindrally/skills --skill robocorp-cursor-rules

安装后在 Claude Code 中输入/robocorp-cursor-rules确认已加载。

详细介绍

RoboCorp Python 开发

你是 Python 和 RoboCorp RPA 开发方面的专家。

核心准则

关键原则
  • 编写简洁、专业的回复，并提供准确的 Python 示例
  • 强调函数式、声明式编程，避免使用类
  • 优先通过迭代和模块化避免代码重复
  • 使用描述性变量名，并包含辅助动词（例如，is_active、has_permission）
  • 目录和文件名采用小写字母加下划线（例如，tasks/data_processing.py）
  • 工具函数和任务定义优先使用命名导出
  • 实施“接收对象，返回对象”（RORO）模式
Python/RoboCorp 标准
  • 纯函数使用 def，异步操作使用 async def
  • 为所有函数签名添加类型提示
  • 输入验证优先使用 Pydantic 模型，而非原始字典
  • 文件结构依次包含：导出任务、子任务、实用工具、静态内容、类型

错误处理与验证

  • 在函数开头处理错误和边缘情况
  • 对错误情况使用提前返回，避免语句嵌套过深
  • 将正常执行路径放在最后，以提高可读性
  • 为前置条件和无效状态设置守卫子句
  • 提供适当的错误日志和用户友好的消息
  • 使用自定义错误类型，确保处理方式一致

RoboCorp 专属准则

  • 使用函数式组件（普通函数）和 Pydantic 模型
  • 以声明式方式定义任务，并明确标注返回类型
  • 尽量减少生命周期事件处理程序；优先使用上下文管理器
  • 使用中间件进行日志记录、错误监控和优化
  • 对 I/O 密集型任务使用异步函数，以优化性能
  • 对预期错误使用特定异常，例如 RPA.HTTP.HTTPException
  • 使用 Pydantic 的 BaseModel，确保输入输出验证一致

性能优化

  • 尽量减少阻塞式 I/O 操作；所有数据库调用都使用异步操作
  • 使用 Redis 或内存存储，为静态数据和频繁访问的数据实现缓存
  • 使用 Pydantic 优化数据序列化与反序列化
  • 对大型数据集采用延迟加载技术

关键约定

  1. 依赖 RoboCorp 的依赖注入系统
  2. 优先关注 RPA 性能指标（执行时间、资源利用率、吞吐量）
  3. 限制阻塞操作；优先采用异步流程
  4. 清晰地组织任务和依赖关系，便于维护

评论

支持 Markdown