Twenty同步实体校验构建
接收实体元数据与业务规则,生成无副作用的校验服务与迁移操作构建器代码,并自动编排进迁移服务中。
功能与用途
用于为 Twenty 开源 CRM 服务端新增或修改同步实体时编写第 3 阶段的校验与构建代码。开发者只需提供实体属性、唯一性要求和外键依赖,即可自动生成不抛异常且无副作用的校验服务、迁移操作构建器以及编排器接入代码。门槛要求熟悉 TypeScript、NestJS 依赖注入与 Twenty 核心架构。
适用场景
- 新建同步实体验证规则:为新实体编写必填字段、O(1)唯一性判断与外键有效性的无异常抛出校验逻辑。
- 编写迁移操作构建器:继承基础构建类,将实体更新、创建和删除意图封装为标准的通用迁移 Action。
- 接入工作区迁移编排器:在编排器中注册并注入构建器服务,确保新实体变更在工作区迁移过程中被统一处理。
适用人群
- Twenty 开源项目贡献者
- Twenty 核心后端开发工程师
- 企业级 CRM 架构开发者
使用步骤
- 编写实体验证服务,实现必填、唯一性与外键校验且返回错误数组。
- 实现迁移构建器,根据校验结果生成对应增删改通用 Action。
- 将新建的构建服务注入并注册进工作区迁移编排器服务中。
- 运行工作区迁移测试,确认错误聚合与 Action 生成逻辑正确。
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- 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. Create validation logic and migration action builders for syncable entities in Twenty. Use when implementing business rule validation, uniqueness checks, foreign key validation, or building workspace migration actions for syncable entities. Validators never throw and never mutate.
依赖与权限
- 读取用户主动提供的内容