跳到主内容
智客 ZICQ

技能库 智客分类:Agent 工作流 omnistudio-datamapper-generate

Omnistudio Datamapper Generate

OmniStudio Data Mapper(原为 DataRaptor) 以100分得分创建和验证. 在构建提取,变形,装入,或涡轮提取数据映射器,映射销售力对象字段,或审查已存在的数据映射器配置时使用. 当 TRIGGER : 用户创建 Data Mappers, 配置字段映射, 与 OmniData Transform 元数据合作, 或询问 DataRaptor/ Data Mapper 模式. 在下列情况下不要TRIGGER:构建融合程序(使用自成体-融合-程序-遗传),作者自成体(使用自成体-杂化-遗传),或分析交叉成份依赖(使用自成体-依赖-分析).

4688 安装量

官方网址:skills.sh

技能介绍

先看中文介绍;官方 description 原文单独保留,不改写 SKILL.md。

做什么

OmniStudio 数据映射器( 原 DataRaptor) 创建和校验, 并加分100分

何时用

构建解析器、变形器、装入器或涡轮解析器数据映射器,映射 Salesforce 对象字段,或审查现有的数据映射器配置。 TRIGGER 当 : 用户创建 Data Mappers, 配置字段映射, 与 OmniData Transform 元数据合作, 或询问 DataRapto

代理如何加载

按 Agent Skills 渐进披露:启动时只加载 name 与 description(约 100 token);任务匹配后才读入整份 SKILL.md 正文;scripts/、references/、assets/ 仅在需要时再读。 本文件正文结构:omnistudio-datamapper-generate: OmniStudio Data Mapper Creation and Validation、Scope、Core Responsibilities、CRITICAL: Orchestration Order、Key Insights、Workflow (5-Phase Pattern)。 其中含规范建议的小节:分步指令。

文件分析

文件分析:除 SKILL.md 外,正文引用了 assets/omni-data-transform-extract.json、assets/omni-data-transform-transform.json、assets/omni-data-transform-load.json、assets/omni-data-transform-item.json、assets/completion-summary-template.md、references/best-practices.md,属于带资源的技能包,这些文件按需再读。

官方 description(原文)

OmniStudio Data Mapper (formerly DataRaptor) creation and validation with 100-point scoring. Use when building Extract, Transform, Load, or Turbo Extract Data Mappers, mapping Salesforce object fields, or reviewing existing Data Mapper configurations. TRIGGER when: user creates Data Mappers, configures field mappings, works with OmniDataTransform metadata, or asks about DataRaptor/Data Mapper patterns. DO NOT TRIGGER when: building Integration Procedures (use omnistudio-integration-procedure-generate), authoring OmniScripts (use omnistudio-omniscript-generate), or analyzing cross-component dependencies (use omnistudio-dependencies-analyze).

omnistudio-datamapper-generate: OmniStudio Data Mapper Creation and ValidationScopeCore ResponsibilitiesCRITICAL: Orchestration OrderKey InsightsWorkflow (5-Phase Pattern)Phase 1: Requirements GatheringPhase 2: Design & Type SelectionPhase 3: Generation & ValidationGeneration Guardrails (MANDATORY)Phase 4: DeploymentPhase 5: Testing & Documentation

来源分类:skills.sh agent-skill

SKILL.md 与 Agent 调用

官方规范 ↗
name
omnistudio-datamapper-generate
description
OmniStudio Data Mapper (formerly DataRaptor) creation and validation with 100-point scoring. Use when building Extract, Transform, Load, or Turbo Extract Data Mappers, mapping Salesforce object fields, or reviewing existing Data Mapper configurations. TRIGGER when: user creates Data Mappers, configures field mappings, works with OmniDataTransform metadata, or asks about DataRaptor/Data Mapper patterns. DO NOT TRIGGER when: building Integration Procedures (use omnistudio-integration-procedure-generate), authoring OmniScripts (use omnistudio-omniscript-generate), or analyzing cross-component dependencies (use omnistudio-dependencies-analyze).
  1. 发现技能客户端向 Agent 提供名称与描述目录。
  2. 匹配与调用用户指定或任务匹配后,载入 SKILL.md 指令。
  3. 按需加载按步骤读取参考文档、使用脚本与素材。
指令中引用的文件 · 8
  • assets/omni-data-transform-extract.json
  • assets/omni-data-transform-transform.json
  • assets/omni-data-transform-load.json
  • assets/omni-data-transform-item.json
  • assets/completion-summary-template.md
  • references/best-practices.md
  • references/naming-conventions.md
  • assets/omni-data-transform-

以下路径提取自原文;文件是否齐全请以来源仓库中的完整目录为准。

具体调用语法与可用工具以目标 Agent 客户端为准。 查看调用机制说明 ↗

安装这个技能

Skills CLI ↗

先选择目标 Agent 和安装范围,保留技能包的附属文件,安装后检查客户端能否发现该技能。

该技能引用了附属文件,请从来源获取完整目录;仅复制 SKILL.md 可能缺少依赖。

交给 Agent 安装

复制安装指令给支持 Agent Skills 的代理,确认其中的目标目录与客户端匹配。

把 Agent Skill「omnistudio-datamapper-generate」安装到我的项目:SKILL.md 原文与官方 description 见 https://zicq.com/zh/skills/skl-f789f63d9968ad4c-Omnistudio-%E6%95%B0%E6%8D%AE%E9%A9%AC%E6%99%AE-%E7%94%9F%E6%88%90.html
请存为 .cursor/skills/omnistudio-datamapper-generate/SKILL.md 或 .claude/skills/omnistudio-datamapper-generate/SKILL.md,frontmatter 的 name 与 description 保持原样,不要改写。
该技能还带 scripts/、references/、assets/ 等文件,请从 https://github.com/forcedotcom/sf-skills 取完整目录,不要只建一个 SKILL.md。

GitHub 完整包 ↗

终端安装 · Skills CLI

需要 Node.js 与 npx。先查看仓库技能列表,确认实际名称。

npx skills add 'https://github.com/forcedotcom/sf-skills' --list

npx skills add 'https://github.com/forcedotcom/sf-skills' --skill 'omnistudio-datamapper-generate'

CLI 会交互选择目标 Agent,默认安装到项目;用户级安装使用 -g。先通过查看命令核对仓库内容,再用 npx skills list 检查已安装技能。

阅读排版
--- name: omnistudio-datamapper-generate description: "OmniStudio Data Mapper (formerly DataRaptor) creation and validation with 100-point scoring. Use when building Extract, Transform, Load, or Turbo Extract Data Mappers, mapping Salesforce object fields, or reviewing existing Data Mapper configurations. TRIGGER when: user creates Data Mappers, configures field mappings, works with OmniDataTransform metadata, or asks about DataRaptor/Data Mapper patterns. DO NOT TRIGGER when: building Integration Procedures (use omnistudio-integration-procedure-generate), authoring OmniScripts (use omnistudio-omniscript-generate), or analyzing cross-component dependencies (use omnistudio-dependencies-analyze)." metadata: cliTools: - tool: ["sf"] semver: ">=2.0.0" relatedSkills: - "omnistudio-dependencies-analyze" - "omnistudio-flexcard-generate" - "omnistudio-integration-procedure-generate" - "omnistudio-omniscript-generate" - "platform-custom-field-generate" - "platform-custom-object-generate" - "platform-metadata-deploy" - "platform-soql-query" version: "1.0" domains: ["OmniStudio"] minApiVersion: "60.0" --- # omnistudio-datamapper-generate: OmniStudio Data Mapper Creation and Validation Expert OmniStudio Data Mapper developer specializing in Extract, Transform, Load, and Turbo Extract configurations. Generate production-ready, performant, and maintainable Data Mapper definitions with proper field mappings, query optimization, and data integrity safeguards. --- ## Scope - **In scope**: Creating and validating OmniStudio Data Mapper configurations (Extract, Transform, Load, Turbo Extract); field mapping design; query optimization; FLS (Field-Level Security) validation; deployment via platform-metadata-deploy skill - **Out of scope**: Building Integration Procedures (use `omnistudio-integration-procedure-generate`), authoring OmniScripts (use `omnistudio-omniscript-generate`), designing FlexCards (use `omnistudio-flexcard-generate`), analyzing cross-component dependencies (use `omnistudio-dependencies-analyze`) --- ## Core Responsibilities 1. **Generation**: Create Data Mapper configurations (Extract, Transform, Load, Turbo Extract) from requirements 2. **Field Mapping**: Design object-to-output field mappings with proper type handling, lookup resolution, and null safety 3. **Dependency Tracking**: Identify related OmniStudio components (Integration Procedures, OmniScripts, FlexCards) that consume or feed Data Mappers 4. **Validation & Scoring**: Score Data Mapper configurations against 5 categories (0-100 points) --- ## CRITICAL: Orchestration Order **omnistudio-dependencies-analyze -> omnistudio-datamapper-generate -> omnistudio-integration-procedure-generate -> omnistudio-omniscript-generate -> omnistudio-flexcard-generate** (you are here: omnistudio-datamapper-generate) Data Mappers are the data access layer of the OmniStudio stack. They must be created and deployed before Integration Procedures or OmniScripts that reference them. Use omnistudio-dependencies-analyze FIRST to understand existing component dependencies. --- ## Key Insights | Insight | Details | |---------|---------| | **Extract vs Turbo Extract** | Extract uses standard SOQL with relationship queries. Turbo Extract uses server-side compiled queries for read-heavy, high-volume scenarios (10x+ faster). Turbo Extract does not support formula fields, related lists, or write operations. | | **Transform is in-memory** | Transform Data Mappers operate entirely in memory with no DML or SOQL. They reshape data structures between steps in an Integration Procedure. Use for JSON-to-JSON transformations, field renaming, and data flattening. | | **Load = DML** | Load Data Mappers perform insert, update, upsert, or delete operations. They require proper FLS checks and error handling. Always validate field-level security before deploying Load Data Mappers to production. | | **OmniDataTransform metadata** | Data Mappers are stored as OmniDataTransform and OmniDataTransformItem records. Retrieve and deploy using these metadata type names, not the legacy DataRaptor API names. | --- ## Workflow (5-Phase Pattern) ### Phase 1: Requirements Gathering **Ask the user** to gather: - Data Mapper type (Extract, Transform, Load, Turbo Extract) - Target Salesforce object(s) and fields - Target org alias - Consuming component (Integration Procedure, OmniScript, or FlexCard name) - Data volume expectations (record counts, frequency) **Then**: 1. Check existing Data Mappers: `Glob: **/OmniDataTransform*` 2. Check existing OmniStudio metadata: `Glob: **/omnistudio/**` 3. Create a task list --- ### Phase 2: Design & Type Selection | Type | Use Case | Naming Prefix | Supports DML | Supports SOQL | |------|----------|---------------|--------------|---------------| | **Extract** | Read data from one or more objects with relationship queries | `DR_Extract_` | No | Yes | | **Turbo Extract** | High-volume read-only queries, server-side compiled | `DR_TurboExtract_` | No | Yes (compiled) | | **Transform** | In-memory data reshaping between procedure steps | `DR_Transform_` | No | No | | **Load** | Write data (insert, update, upsert, delete) | `DR_Load_` | Yes | No | **Naming Format**: `[Prefix][Object]_[Purpose]` using PascalCase **Examples**: - `DR_Extract_Account_Details` -- Extract Account with related Contacts - `DR_TurboExtract_Case_List` -- High-volume Case list for FlexCard - `DR_Transform_Lead_Flatten` -- Flatten nested Lead data structure - `DR_Load_Opportunity_Create` -- Insert Opportunity records --- ### Phase 3: Generation & Validation **For Generation**: 1. Read `assets/omni-data-transform-extract.json` (Extract), `assets/omni-data-transform-transform.json` (Transform), or `assets/omni-data-transform-load.json` (Load) for the OmniDataTransform record template 2. Read `assets/omni-data-transform-item.json` for each field mapping (OmniDataTransformItem) template 3. Configure query filters, sort order, and limits for Extract types 4. Set up lookup mappings and default values for Load types 5. Validate field-level security for all mapped fields **For Review**: 1. Read existing Data Mapper configuration 2. Run validation against best practices 3. Generate improvement report with specific fixes **Run Validation**: Read `assets/completion-summary-template.md` for the scoring output format and thresholds. --- ### Generation Guardrails (MANDATORY) **BEFORE generating ANY Data Mapper configuration, Claude MUST verify no anti-patterns are introduced.** If ANY of these patterns would be generated, **STOP and ask the user**: > "I noticed [pattern]. This will cause [problem]. Should I: > A) Refactor to use [correct pattern] > B) Proceed anyway (not recommended)" | Anti-Pattern | Detection | Impact | |--------------|-----------|--------| | Extracting all fields | No field list specified, wildcard selection | Performance degradation, excessive data transfer | | Missing lookup mappings | Load references lookup field without resolution | DML failure, null foreign key | | Writing without FLS check | Load Data Mapper with no security validation | Security violation, data corruption in restricted profiles | | Unbounded Extract query | No LIMIT or filter on Extract | Governor limit failure, timeout on large objects | | Transform with side effects | Transform attempting DML or callout | Runtime error, Transform is in-memory only | | Hardcoded record IDs | 15/18-char ID literal in filter or mapping | Deployment failure across environments | | Nested relationship depth >3 | Extract with deeply nested parent traversal | Query performance degradation, SOQL complexity limits | | Load without error handling | No upsert key or duplicate rule consideration | Silent data corruption, duplicate records | **DO NOT generate anti-patterns even if explicitly requested.** Ask user to confirm the exception with documented justification. **See**: [references/best-practices.md](references/best-practices.md) for detailed patterns **See**: [references/naming-conventions.md](references/naming-conventions.md) for naming rules --- ### Phase 4: Deployment **Step 1: Validation** Use the **platform-metadata-deploy** skill: "Deploy OmniDataTransform [Name] to [target-org] with --dry-run" **Step 2: Deploy** (only if validation succeeds) Use the **platform-metadata-deploy** skill: "Proceed with actual deployment to [target-org]" **Post-Deploy**: Activate the Data Mapper in the target org. Verify it appears in OmniStudio Designer. **If deploy fails**: Check error for specific cause — common issues: `Entity cannot be found` (Data Mapper is in Draft status; activate first), namespace prefix mismatch (check `sfdx-project.json`), or missing parent `OmniDataTransform` record for item deployments. **If Load DM fails at runtime**: Check debug logs via `sf apex log list -o `; verify FLS and object permissions for the running user profile; confirm the upsert key field is populated and unique; Salesforce Load DMs follow `allOrNone=false` by default — partial successes are possible, check for `isSuccess=false` rows in the response. --- ### Phase 5: Testing & Documentation **Completion Summary**: Read `assets/completion-summary-template.md` for the completion summary format. **Testing Checklist**: - [ ] Preview data output in OmniStudio Designer - [ ] Verify field mappings produce expected JSON structure - [ ] Test with representative data volume (not just 1 record) - [ ] Validate FLS enforcement with restricted profile user - [ ] Confirm consuming Integration Procedure/OmniScript receives correct data shape --- ## Best Practices (100-Point Scoring) | Category | Points | Key Rules | |----------|--------|-----------| | **Design & Naming** | 20 | Correct type selection; naming follows `DR_[Type]_[Object]_[Purpose]` convention; single responsibility per Data Mapper | | **Field Mapping** | 25 | Explicit field list (no wildcards); correct input/output paths; proper type conversions; null-safe default values | | **Data Integrity** | 25 | FLS validation on all fields; lookup resolution for Load types; upsert keys defined; duplicate handling configured | | **Performance** | 15 | Bounded queries with LIMIT/filters; Turbo Extract for read-heavy scenarios; minimal relationship depth; indexed filter fields | | **Documentation** | 15 | Description on OmniDataTransform record; field mapping rationale documented; consuming components identified | **Thresholds**: [PASS] 90+ (Deploy) | [REVIEW] 67-89 (Review) | [BLOCK] <67 (Block - fix required) --- ## CLI Commands ### Query Existing Data Mappers ```bash sf data query -q "SELECT Id,Name,Type FROM OmniDataTransform LIMIT 200" -o ``` ### Query Data Mapper Field Mappings ```bash sf data query -q "SELECT Id,Name,InputObjectName,OutputObjectName,LookupObjectName FROM OmniDataTransformItem WHERE OmniDataTransformationId='' LIMIT 200" -o ``` ### Retrieve Data Mapper Metadata ```bash sf project retrieve start -m OmniDataTransform: -o ``` ### Deploy Data Mapper Metadata ```bash sf project deploy start -m OmniDataTransform: -o ``` --- ## Output Expectations Deliverables produced by this skill: - **OmniDataTransform record** — main Data Mapper record built from `assets/omni-data-transform-*.json` template - **OmniDataTransformItem records** — one per mapped field, built from `assets/omni-data-transform-item.json` template - **Validation score report** — 100-point score across 5 categories (format in `assets/completion-summary-template.md`) - **Deployment confirmation** — Data Mapper activated and visible in OmniStudio Designer --- ## Cross-Skill Integration | From Skill | To omnistudio-datamapper-generate | When | |------------|------------------|------| | omnistudio-dependencies-analyze | -> omnistudio-datamapper-generate | "Analyze dependencies before creating Data Mapper" | | platform-custom-object-generate / platform-custom-field-generate | -> omnistudio-datamapper-generate | "Describe target object fields before mapping" | | platform-soql-query | -> omnistudio-datamapper-generate | "Validate Extract query logic" | | From omnistudio-datamapper-generate | To Skill | When | |--------------------|----------|------| | omnistudio-datamapper-generate | -> omnistudio-integration-procedure-generate | "Create Integration Procedure that calls this Data Mapper" | | omnistudio-datamapper-generate | -> platform-metadata-deploy | "Deploy Data Mapper to target org" | | omnistudio-datamapper-generate | -> omnistudio-omniscript-generate | "Wire Data Mapper output into OmniScript" | | omnistudio-datamapper-generate | -> omnistudio-flexcard-generate | "Display Data Mapper Extract results in FlexCard" | --- ## Gotchas | Issue | Resolution | |-------|-----------| | Large data volume (>10K records) | Use Turbo Extract; add pagination via Integration Procedure; warn about heap limits | | Polymorphic lookup fields | Specify the concrete object type in the mapping; test each type separately | | Formula fields in Extract | Standard Extract supports formula fields; Turbo Extract does not — fall back to standard Extract | | Cross-object Load (master-detail) | Insert parent records first, then child records in a separate Load step; use Integration Procedure to orchestrate sequence | | Namespace-prefixed fields | Include namespace prefix in field paths (e.g., `ns__Field__c`); verify prefix matches target org | | Multi-currency orgs | Map CurrencyIsoCode explicitly; do not rely on default currency assumption | | RecordType-dependent mappings | Filter by RecordType in Extract; set RecordTypeId in Load; document which RecordTypes are supported | | Draft Data Mapper not retrievable | `sf project retrieve start -m OmniDataTransform:` only works for active DMs; activate before retrieving | | Foreign key field name wrong | The parent lookup on `OmniDataTransformItem` is `OmniDataTransformationId` (full word "Transformation"), not `OmniDataTransformId` | --- ## Notes - **Metadata Type**: OmniDataTransform (not DataRaptor — legacy name deprecated) - **API Version**: Requires OmniStudio managed package or Industries Cloud - **Scoring**: Block deployment if score < 67; read `assets/completion-summary-template.md` for score format - **Turbo Extract Limitations**: No formula fields, no related lists, no aggregate queries, no polymorphic fields - **Activation**: Data Mappers must be activated after deployment to be callable from Integration Procedures (see Gotchas for draft retrieval behavior) - **Creating via Data API**: Use `sf api request rest --method POST --body @file.json` to create OmniDataTransform and OmniDataTransformItem records. The `sf data create record --values` flag cannot handle JSON in textarea fields. Write the JSON body to a temp file first. --- ## Reference File Index | File | When to Read | |------|-------------| | `assets/omni-data-transform-extract.json` | Phase 3 Generation — template for Extract type OmniDataTransform records | | `assets/omni-data-transform-transform.json` | Phase 3 Generation — template for Transform type OmniDataTransform records | | `assets/omni-data-transform-load.json` | Phase 3 Generation — template for Load type OmniDataTransform records | | `assets/omni-data-transform-item.json` | Phase 3 Generation — template for each OmniDataTransformItem field mapping | | `assets/completion-summary-template.md` | Phase 3 & 5 — scoring output format and completion summary template | | `references/best-practices.md` | Phase 3 Guardrails — detailed patterns for field mapping, query optimization, null handling, and performance | | `references/naming-conventions.md` | Phase 2 Design — full naming rules for all Data Mapper types and field mapping conventions | ---

相关技能

Agent 工作流

Skill Creator

创造有效技能指南。 当用户想创造出新的技能(或更新现有的技能),以专业知识,工作流程,或工具集成来扩展克洛德的能力时,应该使用这种技能.

Agent 工作流

Clawdhub

使用ClawdHub CLI搜索,安装,更新并发布从taladhub.com的代理技能. 需要获取苍蝇上的新技能时使用,将安装的技能同步到最新版本或特定版本,或者发布 npm-instainddhub CLI 的新/更新的技能文件夹.

Agent 工作流

Agent Team Orchestration

管弦乐团多代理团队,任务设定周期,交接协议,审查工作流程. 使用时间: (1)建立2+特派员队伍,具有不同专业,(2)确定任务路线和生命周期(收录框_ spec_建设_审查_完成),(3)在特派员之间制定交接协议,(4)建立审查和质量关口,(5)管理特派员之间的交流和文物共享.

Agent 工作流

Superpowers

Spec-first,TDD,子代理驱动的软件开发工作流程. 当:(1)构建任何新功能或应用——触发脑暴_计划_子代理执行回路,(2)调试出一个bug或测试失败——触发系统性的根起过程,(3)用户说"让我们构建","帮助我计划","我想添加X",或"这个被打破",(4)完成一个功…