AI Skill 大全

Twenty同步实体迁移执行器开发

解析Twenty通用迁移操作并转换为扁平结构,编写增删改动作执行器以直接更新工作区元数据库。

功能与用途

面向Twenty开源项目内核开发者,用于在工作区数据迁移的Runner层实现特定同步实体的动作处理程序。使用者输入实体类型和元数据定义,即可生成创建、更新与删除三类动作执行器服务,并配套通用实体到扁平实体的转译与外键标识符解析逻辑。使用者需要掌握NestJS和TypeORM架构,并已完成迁移构建器及缓存定义。

适用场景

  • 新建同步实体创建执行器:转译通用创建动作为扁平格式,调用批量插入方法将新实体持久化至元数据库中。
  • 处理实体属性及关联更新:将跨环境的通用关联标识符解析为工作区本地ID,并执行字段差异更新。
  • 实现实体级联物理删除:通过基础转译方法提取被删除实体的扁平ID列表,并在元数据库中安全执行清理。

适用人群

  • Twenty核心贡献者
  • 开源CRM后端开发工程师
  • 全栈架构师

使用步骤

  1. 继承基类实现 CreateActionHandler 并注入元数据仓储
  2. 编写 UpdateActionHandler 并调用外键解析工具映射实体ID
  3. 继承基类实现 DeleteActionHandler 处理通用动作转译与物理删除
  4. 编写 Universal 到 Flat 实体的格式转换函数
  5. 对照检查清单核对元数据操作与工作区Schema方法

开始使用

将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。

查看 MCP 接入说明

技术信息

分类
编程
适用工具
Codex、Claude Code、OpenClaw、Hermes、国内 Agent
使用难度
专业
版本
main
最近更新
2026-09-28
文件数
3
安装包大小
自动生成 ZIP
安全检查
基础检查通过

Contributing to the Twenty codebase itself (twentyhq/twenty server internals), not for building apps on top of Twenty. Implement action handlers for executing workspace migrations in Twenty. Use when creating database operations for syncable entities, implementing universal-to-flat entity transpilation, or handling create/update/delete actions in the runner layer.

依赖与权限

  • 读取用户主动提供的内容

同类 Skill