AgentSkillsCN

cirra-ai-sf

Salesforce管理员套件——通过Cirra AI MCP服务器，协同Apex、流程与数据插件。当用户需要跨越代码、流程与数据操作的跨域Salesforce工作时使用此功能。

SKILL.md
--- frontmatter
name: cirra-ai-sf
description: >
  Salesforce admin suite — orchestrates Apex, Flow, and Data plugins
  with Cirra AI MCP Server. Use when the user needs cross-domain Salesforce
  work spanning code, flows, and data operations.
license: MIT
metadata:
  version: '1.0.0'
  author: 'Cirra AI'

cirra-ai-sf: Salesforce Admin Suite

Orchestrates three independent Salesforce plugins into a unified development workflow. Each plugin works standalone; this meta-skill coordinates them when all three are active.

CRITICAL: Dependency Check on Session Start

When this skill is loaded, you MUST check whether the sub-plugins listed below are also installed and available. Check by looking for their SKILL.md files or skill names in the current session.

If any sub-plugin is missing, warn the user immediately:

"cirra-ai-sf is an orchestration layer for three sub-plugins. I can see that [missing plugin(s)] is not installed. This means I won't have access to [what it provides]. You can install it with claude /plugin install github:cirra-ai/skills/[plugin-name], or I can proceed on a best-effort basis without it."

Then proceed with whatever plugins ARE available. Do not silently fall back to generic knowledge — the user should know what they're missing so they can make an informed choice.

If plugins are available you MUST use them! Don't make up your own methodology

Sub-Plugins

PluginDomainScoring
cirra-ai-sf-apexApex classes, triggers, tests, batch jobs150 points / 8 categories
cirra-ai-sf-flowRecord-triggered, screen, autolaunched, scheduled flows110 points / 6 categories
cirra-ai-sf-dataSOQL queries, DML operations, test data factoriesPass/fail pre-flight checks

Each plugin includes its own MCP deployment validator — no cross-plugin dependencies.

Routing Rules

When a user request arrives, route to the appropriate plugin:

Request TypeRoute ToExamples
Write/review Apex codecirra-ai-sf-apex"Create a trigger handler", "Review this Apex class"
Create/validate a Flowcirra-ai-sf-flow"Build a record-triggered flow", "Score this flow XML"
Query/insert/update datacirra-ai-sf-data"Query all Accounts", "Create 200 test records"
Mixed (code + data)Both"Deploy the trigger and create test data"

Orchestration Order

When building a complete feature:

code
1. cirra-ai-sf-metadata  →  Create custom objects/fields (if needed)
2. cirra-ai-sf-apex      →  Deploy Apex classes/triggers
   cirra-ai-sf-flow      →  Deploy Flows (parallel with Apex if independent)
3. cirra-ai-sf-data      →  Create test data, verify with SOQL

Objects and fields must exist before code that references them can be deployed.

Validation Flow

Each plugin validates its own domain independently:

  • •cirra-ai-sf-data: Pre-flight checks on soql_query / sobject_dml params (missing sObject, PII detection, syntax errors) — pass/fail
  • •cirra-ai-sf-apex: 150-point scoring on metadata_create / metadata_update for ApexClass/ApexTrigger — delegates to ApexValidator
  • •cirra-ai-sf-flow: 110-point scoring on metadata_create / metadata_update for Flow/FlowDefinition — delegates to EnhancedFlowValidator

No plugin needs to import from another plugin's codebase.

Prerequisites

CRITICAL: Call cirra_ai_init() once per session before using any Cirra AI MCP tools.

python
cirra_ai_init(sf_user="your-username")

Related Skills

These plugins complement the core three but are independent:

SkillPurpose
cirra-ai-sf-metadataCustom objects, fields, Permission Sets
cirra-ai-sf-lwcLightning Web Components
cirra-ai-sf-soqlAdvanced SOQL optimization
cirra-ai-sf-ai-agentscriptAgentforce agent authoring