@salesforce/afv-skills 1.16.0 → 1.17.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/package.json +1 -1
- package/skills/activating-datacloud/SKILL.md +2 -2
- package/skills/analyzing-omnistudio-dependencies/SKILL.md +1 -1
- package/skills/building-ui-bundle-app/SKILL.md +1 -1
- package/skills/connecting-datacloud/SKILL.md +2 -2
- package/skills/creating-b2b-commerce-store/SKILL.md +0 -1
- package/skills/developing-agentforce/SKILL.md +0 -1
- package/skills/generating-apex/SKILL.md +1 -0
- package/skills/generating-mermaid-diagrams/assets/datamodel/b2b-commerce-erd.md +1 -1
- package/skills/generating-mermaid-diagrams/assets/datamodel/campaigns-erd.md +1 -1
- package/skills/generating-mermaid-diagrams/assets/datamodel/consent-erd.md +1 -1
- package/skills/generating-mermaid-diagrams/assets/datamodel/files-erd.md +1 -1
- package/skills/generating-mermaid-diagrams/assets/datamodel/forecasting-erd.md +1 -1
- package/skills/generating-mermaid-diagrams/assets/datamodel/fsl-erd.md +1 -1
- package/skills/generating-mermaid-diagrams/assets/datamodel/party-model-erd.md +1 -1
- package/skills/generating-mermaid-diagrams/assets/datamodel/quote-order-erd.md +1 -1
- package/skills/generating-mermaid-diagrams/assets/datamodel/revenue-cloud-erd.md +1 -1
- package/skills/generating-mermaid-diagrams/assets/datamodel/sales-cloud-erd.md +1 -1
- package/skills/generating-mermaid-diagrams/assets/datamodel/salesforce-erd.md +1 -1
- package/skills/generating-mermaid-diagrams/assets/datamodel/scheduler-erd.md +1 -1
- package/skills/generating-mermaid-diagrams/assets/datamodel/service-cloud-erd.md +1 -1
- package/skills/generating-mermaid-diagrams/assets/datamodel/territory-management-erd.md +1 -1
- package/skills/generating-mermaid-diagrams/references/erd-conventions.md +1 -1
- package/skills/generating-mermaid-diagrams/references/preview-guide.md +2 -5
- package/skills/harmonizing-datacloud/SKILL.md +2 -2
- package/skills/implementing-ui-bundle-agentforce-conversation-client/SKILL.md +1 -2
- package/skills/investigating-agentforce-d360/SKILL.md +1 -1
- package/skills/observing-agentforce/SKILL.md +0 -1
- package/skills/observing-agentforce/references/stdm-queries.md +3 -11
- package/skills/orchestrating-datacloud/README.md +5 -7
- package/skills/orchestrating-datacloud/SKILL.md +3 -3
- package/skills/orchestrating-datacloud/references/feature-readiness.md +2 -2
- package/skills/orchestrating-datacloud/references/plugin-setup.md +6 -8
- package/skills/orchestrating-datacloud/scripts/diagnose-org.mjs +1 -1
- package/skills/orchestrating-datacloud/scripts/verify-plugin.sh +2 -2
- package/skills/preparing-datacloud/SKILL.md +2 -2
- package/skills/retrieving-datacloud/SKILL.md +3 -3
- package/skills/reviewing-lwc-mobile-offline/SKILL.md +0 -1
- package/skills/testing-agentforce/SKILL.md +0 -1
- package/skills/using-mobile-native-capabilities/SKILL.md +0 -1
package/package.json
CHANGED
|
@@ -40,7 +40,7 @@ Ask for or infer:
|
|
|
40
40
|
## Core Operating Rules
|
|
41
41
|
|
|
42
42
|
- Verify the upstream segment or insight is healthy before creating downstream delivery assets.
|
|
43
|
-
- Run the shared readiness classifier before mutating activation assets: `node
|
|
43
|
+
- Run the shared readiness classifier before mutating activation assets: `node ../orchestrating-datacloud/scripts/diagnose-org.mjs -o <org> --phase act --json`.
|
|
44
44
|
- Inspect available platforms and targets before mutating activation setup.
|
|
45
45
|
- Keep destination definitions deterministic and reusable where possible.
|
|
46
46
|
- Treat downstream credential and platform constraints as separate validation concerns.
|
|
@@ -52,7 +52,7 @@ Ask for or infer:
|
|
|
52
52
|
|
|
53
53
|
### 1. Classify readiness for act work
|
|
54
54
|
```bash
|
|
55
|
-
node
|
|
55
|
+
node ../orchestrating-datacloud/scripts/diagnose-org.mjs -o <org> --phase act --json
|
|
56
56
|
```
|
|
57
57
|
|
|
58
58
|
### 2. Inspect destinations first
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: analyzing-omnistudio-dependencies
|
|
3
|
-
description: "Cross-cutting OmniStudio analysis skill for namespace detection, dependency visualization, and impact analysis across OmniScripts, FlexCards, Integration Procedures, and Data Mappers.
|
|
3
|
+
description: "Cross-cutting OmniStudio analysis skill for namespace detection, dependency visualization, and impact analysis across OmniScripts, FlexCards, Integration Procedures, and Data Mappers. TRIGGER when: user asks about OmniStudio dependencies, wants namespace detection (Core vs vlocity_cmt vs vlocity_ins), needs impact analysis, requests dependency graphs or Mermaid diagrams, or asks which components are affected by a change. DO NOT TRIGGER when: authoring OmniScripts (use building-omnistudio-omniscript), building FlexCards (use building-omnistudio-flexcard), creating Integration Procedures (use building-omnistudio-integration-procedure), or configuring Data Mappers (use building-omnistudio-datamapper)."
|
|
4
4
|
metadata:
|
|
5
5
|
version: "1.0"
|
|
6
6
|
---
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: building-ui-bundle-app
|
|
3
|
-
description: "MUST activate when the user wants to build, create, or generate a React application, React app, web application, single-page application (SPA), or frontend application — even if no project files exist yet. MUST also activate when the project contains a uiBundles/*/src/ directory or sfdx-project.json and the prompt says create, build, construct, or generate a new app, site, or page from scratch — even if the prompt also describes visual styling. MUST also activate when the task spans more than one ui-bundle skill. Use this skill when building a complete app end-to-end.
|
|
3
|
+
description: "MUST activate when the user wants to build, create, or generate a React application, React app, web application, single-page application (SPA), or frontend application — even if no project files exist yet. MUST also activate when the project contains a uiBundles/*/src/ directory or sfdx-project.json and the prompt says create, build, construct, or generate a new app, site, or page from scratch — even if the prompt also describes visual styling. MUST also activate when the task spans more than one ui-bundle skill. Use this skill when building a complete app end-to-end. Do NOT use for Lightning Experience apps with custom objects (use generating-lightning-app). Do NOT use for single-concern edits to an existing page (use building-ui-bundle-frontend)."
|
|
4
4
|
metadata:
|
|
5
5
|
version: "1.0"
|
|
6
6
|
related-skills: generating-ui-bundle-metadata, generating-ui-bundle-features, using-ui-bundle-salesforce-data, building-ui-bundle-frontend, implementing-ui-bundle-agentforce-conversation-client, implementing-ui-bundle-file-upload, deploying-ui-bundle, generating-ui-bundle-site, generating-ui-bundle-custom-app
|
|
@@ -43,7 +43,7 @@ Ask for or infer:
|
|
|
43
43
|
## Core Operating Rules
|
|
44
44
|
|
|
45
45
|
- Verify the plugin runtime first; see [../orchestrating-datacloud/references/plugin-setup.md](../orchestrating-datacloud/references/plugin-setup.md).
|
|
46
|
-
- Run the shared readiness classifier before mutating connections: `node
|
|
46
|
+
- Run the shared readiness classifier before mutating connections: `node ../orchestrating-datacloud/scripts/diagnose-org.mjs -o <org> --phase connect --json`.
|
|
47
47
|
- Prefer read-only discovery before connection creation.
|
|
48
48
|
- Suppress linked-plugin warning noise with `2>/dev/null` for standard usage.
|
|
49
49
|
- Remember that `connection list` requires `--connector-type`.
|
|
@@ -59,7 +59,7 @@ Ask for or infer:
|
|
|
59
59
|
|
|
60
60
|
### 1. Classify readiness for connect work
|
|
61
61
|
```bash
|
|
62
|
-
node
|
|
62
|
+
node ../orchestrating-datacloud/scripts/diagnose-org.mjs -o <org> --phase connect --json
|
|
63
63
|
```
|
|
64
64
|
|
|
65
65
|
### 2. Discover connector types
|
|
@@ -1,7 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: creating-b2b-commerce-store
|
|
3
3
|
description: "Interactive workflow to create Commerce B2B Stores and retrieve storefront metadata. Use when users want to: create B2B Commerce stores, build Commerce storefronts, set up B2B stores from Vibes, retrieve Commerce metadata, deploy Commerce experiences, work with DigitalExperienceBundle for Commerce."
|
|
4
|
-
Critical: "Agents must follow the interactive flow and NEVER create storefront metadata from scratch."
|
|
5
4
|
compatibility: "Requires Commerce licenses, Experience Cloud, Salesforce CLI"
|
|
6
5
|
metadata:
|
|
7
6
|
version: "1.0"
|
|
@@ -3,6 +3,7 @@ name: generating-apex
|
|
|
3
3
|
description: "Primary Apex authoring skill for class generation, refactoring, and review. ALWAYS ACTIVATE when the user mentions Apex, .cls, triggers, or asks to create/refactor a class (service, selector, domain, batch, queueable, schedulable, invocable, DTO, utility, interface, abstract, exception, REST resource). Use this skill for requests involving SObject CRUD, mapping collections, fetching related records, scheduled jobs, batch jobs, trigger design, @AuraEnabled controllers, @RestResource endpoints, custom REST APIs, or code review of existing Apex."
|
|
4
4
|
metadata:
|
|
5
5
|
version: "1.0"
|
|
6
|
+
minApiVersion: "66.0"
|
|
6
7
|
---
|
|
7
8
|
|
|
8
9
|
# Generating Apex
|
|
@@ -22,7 +22,7 @@ Pre-built data model for Salesforce B2B Commerce using `flowchart LR` format wit
|
|
|
22
22
|
Enrich diagram with live org data:
|
|
23
23
|
|
|
24
24
|
```bash
|
|
25
|
-
python3
|
|
25
|
+
python3 ../../scripts/query-org-metadata.py \
|
|
26
26
|
--objects WebStore,WebCart,CartItem,BuyerGroup,BuyerAccount \
|
|
27
27
|
--target-org myorg
|
|
28
28
|
```
|
|
@@ -21,7 +21,7 @@ Pre-built data model for Salesforce Campaigns using `flowchart LR` format with c
|
|
|
21
21
|
Enrich diagram with live org data:
|
|
22
22
|
|
|
23
23
|
```bash
|
|
24
|
-
python3
|
|
24
|
+
python3 ../../scripts/query-org-metadata.py \
|
|
25
25
|
--objects Campaign,CampaignMember,CampaignInfluence,Lead,Contact,Opportunity \
|
|
26
26
|
--target-org myorg
|
|
27
27
|
```
|
|
@@ -24,7 +24,7 @@ Pre-built data model for Salesforce Consent Management (GDPR/Privacy) using `flo
|
|
|
24
24
|
Enrich diagram with live org data:
|
|
25
25
|
|
|
26
26
|
```bash
|
|
27
|
-
python3
|
|
27
|
+
python3 ../../scripts/query-org-metadata.py \
|
|
28
28
|
--objects Individual,ContactPointEmail,ContactPointPhone,DataUsePurpose,ContactPointConsent \
|
|
29
29
|
--target-org myorg
|
|
30
30
|
```
|
|
@@ -21,7 +21,7 @@ Pre-built data model for Salesforce Files (Content) using `flowchart LR` format
|
|
|
21
21
|
Enrich diagram with live org data:
|
|
22
22
|
|
|
23
23
|
```bash
|
|
24
|
-
python3
|
|
24
|
+
python3 ../../scripts/query-org-metadata.py \
|
|
25
25
|
--objects ContentDocument,ContentVersion,ContentDocumentLink,ContentWorkspace \
|
|
26
26
|
--target-org myorg
|
|
27
27
|
```
|
|
@@ -21,7 +21,7 @@ Pre-built data model for Salesforce Collaborative Forecasts using `flowchart LR`
|
|
|
21
21
|
Enrich diagram with live org data:
|
|
22
22
|
|
|
23
23
|
```bash
|
|
24
|
-
python3
|
|
24
|
+
python3 ../../scripts/query-org-metadata.py \
|
|
25
25
|
--objects ForecastingItem,ForecastingQuota,Opportunity,OpportunitySplit \
|
|
26
26
|
--target-org myorg
|
|
27
27
|
```
|
|
@@ -25,7 +25,7 @@ Pre-built data model for Salesforce Field Service (formerly Field Service Lightn
|
|
|
25
25
|
Enrich diagram with live org data:
|
|
26
26
|
|
|
27
27
|
```bash
|
|
28
|
-
python3
|
|
28
|
+
python3 ../../scripts/query-org-metadata.py \
|
|
29
29
|
--objects WorkOrder,WorkOrderLineItem,ServiceAppointment,ServiceResource,ServiceTerritory \
|
|
30
30
|
--target-org myorg
|
|
31
31
|
```
|
|
@@ -20,7 +20,7 @@ Pre-built data model for Salesforce Party Model used in Industry Clouds (Financi
|
|
|
20
20
|
Enrich diagram with live org data:
|
|
21
21
|
|
|
22
22
|
```bash
|
|
23
|
-
python3
|
|
23
|
+
python3 ../../scripts/query-org-metadata.py \
|
|
24
24
|
--objects Account,Contact,AccountContactRelation,AccountContactRole \
|
|
25
25
|
--target-org myorg
|
|
26
26
|
```
|
|
@@ -23,7 +23,7 @@ Pre-built data model for Salesforce Quotes and Orders using `flowchart LR` forma
|
|
|
23
23
|
Enrich diagram with live org data:
|
|
24
24
|
|
|
25
25
|
```bash
|
|
26
|
-
python3
|
|
26
|
+
python3 ../../scripts/query-org-metadata.py \
|
|
27
27
|
--objects Opportunity,Quote,QuoteLineItem,Order,OrderItem,Product2,Contract \
|
|
28
28
|
--target-org myorg
|
|
29
29
|
```
|
|
@@ -22,7 +22,7 @@ Pre-built data model for Salesforce Revenue Cloud (CPQ, Billing, Subscription Ma
|
|
|
22
22
|
Enrich diagram with live org data:
|
|
23
23
|
|
|
24
24
|
```bash
|
|
25
|
-
python3
|
|
25
|
+
python3 ../../scripts/query-org-metadata.py \
|
|
26
26
|
--objects ProductCatalog,ProductCategory,ProductSellingModel,PriceAdjustmentSchedule \
|
|
27
27
|
--target-org myorg
|
|
28
28
|
```
|
|
@@ -22,7 +22,7 @@ Pre-built data model for Salesforce Sales Cloud using `flowchart LR` format with
|
|
|
22
22
|
Enrich diagram with live org data:
|
|
23
23
|
|
|
24
24
|
```bash
|
|
25
|
-
python3
|
|
25
|
+
python3 ../../scripts/query-org-metadata.py \
|
|
26
26
|
--objects Account,Contact,Lead,Opportunity,Product2,Campaign \
|
|
27
27
|
--target-org myorg
|
|
28
28
|
```
|
|
@@ -56,7 +56,7 @@ Use `flowchart LR` (left-to-right) for data model diagrams. This format supports
|
|
|
56
56
|
Enrich diagrams with live org data:
|
|
57
57
|
|
|
58
58
|
```bash
|
|
59
|
-
python3
|
|
59
|
+
python3 ../../scripts/query-org-metadata.py \
|
|
60
60
|
--objects Account,Contact,Opportunity,Case \
|
|
61
61
|
--target-org myorg
|
|
62
62
|
```
|
|
@@ -23,7 +23,7 @@ Pre-built data model for Salesforce Scheduler (Lightning Scheduler) using `flowc
|
|
|
23
23
|
Enrich diagram with live org data:
|
|
24
24
|
|
|
25
25
|
```bash
|
|
26
|
-
python3
|
|
26
|
+
python3 ../../scripts/query-org-metadata.py \
|
|
27
27
|
--objects ServiceAppointment,ServiceResource,ServiceTerritory,WorkType \
|
|
28
28
|
--target-org myorg
|
|
29
29
|
```
|
|
@@ -23,7 +23,7 @@ Pre-built data model for Salesforce Service Cloud using `flowchart LR` format wi
|
|
|
23
23
|
Enrich diagram with live org data:
|
|
24
24
|
|
|
25
25
|
```bash
|
|
26
|
-
python3
|
|
26
|
+
python3 ../../scripts/query-org-metadata.py \
|
|
27
27
|
--objects Account,Contact,Case,Entitlement,ServiceContract,Asset \
|
|
28
28
|
--target-org myorg
|
|
29
29
|
```
|
|
@@ -20,7 +20,7 @@ Pre-built data model for Salesforce Enterprise Territory Management (Territory2)
|
|
|
20
20
|
Enrich diagram with live org data:
|
|
21
21
|
|
|
22
22
|
```bash
|
|
23
|
-
python3
|
|
23
|
+
python3 ../../scripts/query-org-metadata.py \
|
|
24
24
|
--objects Territory2Model,Territory2,Territory2Type,UserTerritory2Association,ObjectTerritory2Association \
|
|
25
25
|
--target-org myorg
|
|
26
26
|
```
|
|
@@ -210,7 +210,7 @@ style std fill:#f0f9ff,stroke:#0369a1,stroke-dasharray:5
|
|
|
210
210
|
Use the provided Python script for efficient metadata queries:
|
|
211
211
|
|
|
212
212
|
```bash
|
|
213
|
-
python3
|
|
213
|
+
python3 ../scripts/query-org-metadata.py \
|
|
214
214
|
--objects Account,Contact,Lead,Opportunity,Case \
|
|
215
215
|
--target-org myorg \
|
|
216
216
|
--output table
|
|
@@ -14,10 +14,7 @@ After generating the diagram, offer the user a localhost preview for real-time i
|
|
|
14
14
|
2. Start preview server (runs in background):
|
|
15
15
|
```bash
|
|
16
16
|
# From installed skill folder:
|
|
17
|
-
python
|
|
18
|
-
|
|
19
|
-
# Or from project folder (if working locally):
|
|
20
|
-
python [project-root]/skills/generating-mermaid-diagrams/scripts/mermaid_preview.py start --file /tmp/mermaid-preview.mmd
|
|
17
|
+
python ../scripts/mermaid_preview.py start --file /tmp/mermaid-preview.mmd
|
|
21
18
|
```
|
|
22
19
|
|
|
23
20
|
3. Provide URL to user:
|
|
@@ -37,7 +34,7 @@ After generating the diagram, offer the user a localhost preview for real-time i
|
|
|
37
34
|
|
|
38
35
|
When user is done:
|
|
39
36
|
```bash
|
|
40
|
-
python
|
|
37
|
+
python ../scripts/mermaid_preview.py stop
|
|
41
38
|
```
|
|
42
39
|
|
|
43
40
|
## Preview Server Features
|
|
@@ -40,7 +40,7 @@ Ask for or infer:
|
|
|
40
40
|
## Core Operating Rules
|
|
41
41
|
|
|
42
42
|
- Inspect DMO schema before creating mappings.
|
|
43
|
-
- Run the shared readiness classifier before mutating harmonization assets: `node
|
|
43
|
+
- Run the shared readiness classifier before mutating harmonization assets: `node ../orchestrating-datacloud/scripts/diagnose-org.mjs -o <org> --phase harmonize --json`.
|
|
44
44
|
- Prefer `dmo list --all` when browsing the catalog, but use first-page `dmo list` for fast readiness checks.
|
|
45
45
|
- Use `query describe` or `dmo get --json` instead of inventing unsupported describe flows.
|
|
46
46
|
- Treat identity resolution runs as asynchronous and verify results after execution.
|
|
@@ -52,7 +52,7 @@ Ask for or infer:
|
|
|
52
52
|
|
|
53
53
|
### 1. Classify readiness for harmonize work
|
|
54
54
|
```bash
|
|
55
|
-
node
|
|
55
|
+
node ../orchestrating-datacloud/scripts/diagnose-org.mjs -o <org> --phase harmonize --json
|
|
56
56
|
```
|
|
57
57
|
|
|
58
58
|
### 2. Inspect the catalog
|
|
@@ -1,8 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: implementing-ui-bundle-agentforce-conversation-client
|
|
3
|
-
description: "Use this skill when the user asks to add, embed, integrate, configure, style, or remove an agent, chatbot, chat widget, conversation client, or AI assistant in a UI Bundle project.
|
|
3
|
+
description: "Use this skill when the user asks to add, embed, integrate, configure, style, or remove an agent, chatbot, chat widget, conversation client, or AI assistant in a UI Bundle project. TRIGGER when: project contains a uiBundles/*/src/ directory and the task involves adding or modifying a chat widget, chatbot, or conversational AI; files under uiBundles/*/src/ import AgentforceConversationClient; user asks to add any chat or agent functionality to a page. DO NOT TRIGGER when: user wants to create a custom agent, chatbot, or chat widget component from scratch; the project has no uiBundles directory."
|
|
4
4
|
metadata:
|
|
5
|
-
author: ACC Components
|
|
6
5
|
version: "1.1"
|
|
7
6
|
package: "@salesforce/ui-bundle-template-feature-react-agentforce-conversation-client"
|
|
8
7
|
sdk-package: "@salesforce/agentforce-conversation-client"
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: investigating-agentforce-d360
|
|
3
|
-
description: "Data Cloud 360° view of a single Agentforce session.
|
|
3
|
+
description: "Data Cloud 360° view of a single Agentforce session. TRIGGER when user asks to trace, inspect, summarize, or describe a specific Agentforce session by session id (Agent Session UUID `019d…` or MessagingSession id `0Mw…`). Also triggers on session discovery — find/list/search sessions by time, agent, channel, outcome, or conversation text — when the user has no session id yet. DO NOT TRIGGER for design-time architecture questions (use investigating-agentforce-architecture instead) or for runtime perf/latency/SLO questions that require platform telemetry beyond Data Cloud."
|
|
4
4
|
metadata:
|
|
5
5
|
version: "1.0"
|
|
6
6
|
---
|
|
@@ -4,7 +4,6 @@ description: "Analyze production Agentforce agent behavior using session traces
|
|
|
4
4
|
allowed-tools: Bash Read Write Edit Glob Grep
|
|
5
5
|
metadata:
|
|
6
6
|
version: "1.0"
|
|
7
|
-
last_updated: "2026-04-08"
|
|
8
7
|
argument-hint: "<org-alias> [--agent-file <path>] [--session-id <id>] [--days <n>]"
|
|
9
8
|
compatibility: claude-code
|
|
10
9
|
---
|
|
@@ -23,18 +23,10 @@ Methods:
|
|
|
23
23
|
# Ensure the classes directory exists
|
|
24
24
|
mkdir -p <project-root>/force-app/main/default/classes
|
|
25
25
|
|
|
26
|
-
# Copy from the
|
|
27
|
-
cp
|
|
26
|
+
# Copy from the skill's apex directory
|
|
27
|
+
cp ../apex/AgentforceOptimizeService.cls \
|
|
28
28
|
<project-root>/force-app/main/default/classes/
|
|
29
|
-
cp
|
|
30
|
-
<project-root>/force-app/main/default/classes/
|
|
31
|
-
```
|
|
32
|
-
|
|
33
|
-
If the skill is installed globally via the installer, use the installed path:
|
|
34
|
-
```bash
|
|
35
|
-
cp ~/.claude/skills/observing-agentforce/apex/AgentforceOptimizeService.cls \
|
|
36
|
-
<project-root>/force-app/main/default/classes/
|
|
37
|
-
cp ~/.claude/skills/observing-agentforce/apex/AgentforceOptimizeService.cls-meta.xml \
|
|
29
|
+
cp ../apex/AgentforceOptimizeService.cls-meta.xml \
|
|
38
30
|
<project-root>/force-app/main/default/classes/
|
|
39
31
|
```
|
|
40
32
|
|
|
@@ -63,14 +63,12 @@ These are intentionally generic and should be adapted to the target org.
|
|
|
63
63
|
|
|
64
64
|
## Quick start
|
|
65
65
|
|
|
66
|
-
> The script examples below assume the skill is installed under `~/.claude/skills/` via the full Claude Code installer. If you are working from a repo checkout, run the same scripts from that checkout path.
|
|
67
|
-
|
|
68
66
|
### 1. Verify the runtime
|
|
69
67
|
|
|
70
68
|
```bash
|
|
71
|
-
bash
|
|
69
|
+
bash ./scripts/verify-plugin.sh
|
|
72
70
|
# or with an org alias
|
|
73
|
-
bash
|
|
71
|
+
bash ./scripts/verify-plugin.sh myorg
|
|
74
72
|
```
|
|
75
73
|
|
|
76
74
|
The helper treats `sf data360 doctor` as advisory and falls back to additional read-only smoke checks when an org is only partially provisioned.
|
|
@@ -78,9 +76,9 @@ The helper treats `sf data360 doctor` as advisory and falls back to additional r
|
|
|
78
76
|
### 2. Diagnose feature readiness before mutating
|
|
79
77
|
|
|
80
78
|
```bash
|
|
81
|
-
node
|
|
79
|
+
node ./scripts/diagnose-org.mjs -o myorg --json
|
|
82
80
|
# optional retrieve-plane probe, only when you know the table is real
|
|
83
|
-
node
|
|
81
|
+
node ./scripts/diagnose-org.mjs -o myorg --phase retrieve --describe-table MyDMO__dlm --json
|
|
84
82
|
```
|
|
85
83
|
|
|
86
84
|
Use the diagnose helper to distinguish between:
|
|
@@ -94,7 +92,7 @@ Use the diagnose helper to distinguish between:
|
|
|
94
92
|
```bash
|
|
95
93
|
python3 ~/.claude/sf-skills-install.py --with-datacloud-runtime
|
|
96
94
|
# or run the helper script directly
|
|
97
|
-
bash
|
|
95
|
+
bash ./scripts/bootstrap-plugin.sh
|
|
98
96
|
```
|
|
99
97
|
|
|
100
98
|
### 4. Start with read-only inspection
|
|
@@ -92,7 +92,7 @@ Recommended checks:
|
|
|
92
92
|
```bash
|
|
93
93
|
sf data360 man
|
|
94
94
|
sf org display -o <alias>
|
|
95
|
-
bash
|
|
95
|
+
bash ./scripts/verify-plugin.sh <alias>
|
|
96
96
|
```
|
|
97
97
|
|
|
98
98
|
Treat `sf data360 doctor` as a broad health signal, not the sole gate. On partially provisioned orgs it can fail even when read-only command families like connectors, DMOs, or segments still work.
|
|
@@ -100,12 +100,12 @@ Treat `sf data360 doctor` as a broad health signal, not the sole gate. On partia
|
|
|
100
100
|
### 2. Classify readiness before changing anything
|
|
101
101
|
Run the shared classifier first:
|
|
102
102
|
```bash
|
|
103
|
-
node
|
|
103
|
+
node ./scripts/diagnose-org.mjs -o <org> --json
|
|
104
104
|
```
|
|
105
105
|
|
|
106
106
|
Only use a query-plane probe after you know the table name is real:
|
|
107
107
|
```bash
|
|
108
|
-
node
|
|
108
|
+
node ./scripts/diagnose-org.mjs -o <org> --phase retrieve --describe-table MyDMO__dlm --json
|
|
109
109
|
```
|
|
110
110
|
|
|
111
111
|
Use the classifier to distinguish:
|
|
@@ -27,13 +27,13 @@ Examples:
|
|
|
27
27
|
Run the shared readiness classifier before mutation-heavy work:
|
|
28
28
|
|
|
29
29
|
```bash
|
|
30
|
-
node
|
|
30
|
+
node ../scripts/diagnose-org.mjs -o myorg --json
|
|
31
31
|
```
|
|
32
32
|
|
|
33
33
|
For retrieve/query work, only add a table probe when you already know the table name is real:
|
|
34
34
|
|
|
35
35
|
```bash
|
|
36
|
-
node
|
|
36
|
+
node ../scripts/diagnose-org.mjs -o myorg --phase retrieve --describe-table MyDMO__dlm --json
|
|
37
37
|
```
|
|
38
38
|
|
|
39
39
|
## Signal matrix
|
|
@@ -18,8 +18,6 @@ The orchestrating-datacloud family uses a **community `sf data360` CLI runtime**
|
|
|
18
18
|
|
|
19
19
|
## Recommended setup path
|
|
20
20
|
|
|
21
|
-
The command examples below assume the skill is installed under `~/.claude/skills/` via the full Claude Code installer. If you are working from a cloned sf-skills repo instead, run the same scripts from that checkout path.
|
|
22
|
-
|
|
23
21
|
If you use the Python installer, it can install this optional runtime for you:
|
|
24
22
|
|
|
25
23
|
```bash
|
|
@@ -29,7 +27,7 @@ python3 ~/.claude/sf-skills-install.py --with-datacloud-runtime
|
|
|
29
27
|
Or use the helper script directly:
|
|
30
28
|
|
|
31
29
|
```bash
|
|
32
|
-
bash
|
|
30
|
+
bash ../scripts/bootstrap-plugin.sh
|
|
33
31
|
```
|
|
34
32
|
|
|
35
33
|
By default it clones the plugin into `~/.sf-community-tools/datacloud/sf-cli-plugin-data360`, installs dependencies, compiles it, and links it into the local Salesforce CLI.
|
|
@@ -41,7 +39,7 @@ git clone https://github.com/Jaganpro/sf-cli-plugin-data360.git
|
|
|
41
39
|
cd sf-cli-plugin-data360
|
|
42
40
|
yarn install
|
|
43
41
|
npx tsc
|
|
44
|
-
node
|
|
42
|
+
node ../scripts/generate-manifest.mjs .
|
|
45
43
|
sf plugins link .
|
|
46
44
|
```
|
|
47
45
|
|
|
@@ -49,9 +47,9 @@ sf plugins link .
|
|
|
49
47
|
|
|
50
48
|
```bash
|
|
51
49
|
sf data360 man
|
|
52
|
-
bash
|
|
53
|
-
bash
|
|
54
|
-
node
|
|
50
|
+
bash ../scripts/verify-plugin.sh
|
|
51
|
+
bash ../scripts/verify-plugin.sh myorg
|
|
52
|
+
node ../scripts/diagnose-org.mjs -o myorg --json
|
|
55
53
|
```
|
|
56
54
|
|
|
57
55
|
For newer command families such as `sf data360 query hybrid` and recent pagination fixes, update the community runtime to the latest upstream commit by re-running the bootstrap helper.
|
|
@@ -80,7 +78,7 @@ sf data360 segment list -o myorg 2>/dev/null
|
|
|
80
78
|
If you see `Warning: @gthoppae/sf-cli-plugin-data360 is a linked ESM module and cannot be auto-transpiled`, generate the oclif command manifest:
|
|
81
79
|
|
|
82
80
|
```bash
|
|
83
|
-
node
|
|
81
|
+
node ../scripts/generate-manifest.mjs ~/.sf-community-tools/datacloud/sf-cli-plugin-data360
|
|
84
82
|
```
|
|
85
83
|
|
|
86
84
|
This tells oclif to use pre-compiled output directly instead of attempting auto-transpilation. The `npx oclif manifest` alternative may fail on newer Node.js versions due to `@oclif/core` version mismatches.
|
|
@@ -257,7 +257,7 @@ function guidanceFromProbe(scope, probe) {
|
|
|
257
257
|
if (probe.state === 'runtime_missing') {
|
|
258
258
|
return [
|
|
259
259
|
'Install or relink the community sf data360 runtime before attempting Data Cloud work.',
|
|
260
|
-
'Use python3 ~/.claude/sf-skills-install.py --with-datacloud-runtime or bash
|
|
260
|
+
'Use python3 ~/.claude/sf-skills-install.py --with-datacloud-runtime or bash ./scripts/bootstrap-plugin.sh.',
|
|
261
261
|
];
|
|
262
262
|
}
|
|
263
263
|
|
|
@@ -10,7 +10,7 @@ fi
|
|
|
10
10
|
|
|
11
11
|
if ! sf data360 man >/dev/null 2>&1; then
|
|
12
12
|
echo "The community 'sf data360' runtime is not available." >&2
|
|
13
|
-
echo "Run bash
|
|
13
|
+
echo "Run bash ./scripts/bootstrap-plugin.sh first." >&2
|
|
14
14
|
exit 1
|
|
15
15
|
fi
|
|
16
16
|
|
|
@@ -54,5 +54,5 @@ fi
|
|
|
54
54
|
|
|
55
55
|
echo "Verification complete."
|
|
56
56
|
if [[ -n "${ORG}" ]]; then
|
|
57
|
-
echo "Next: node
|
|
57
|
+
echo "Next: node ./scripts/diagnose-org.mjs -o '${ORG}' --json"
|
|
58
58
|
fi
|
|
@@ -44,7 +44,7 @@ Ask for or infer:
|
|
|
44
44
|
## Core Operating Rules
|
|
45
45
|
|
|
46
46
|
- Verify the external plugin runtime before running Data Cloud commands.
|
|
47
|
-
- Run the shared readiness classifier before mutating ingestion assets: `node
|
|
47
|
+
- Run the shared readiness classifier before mutating ingestion assets: `node ../orchestrating-datacloud/scripts/diagnose-org.mjs -o <org> --phase prepare --json`.
|
|
48
48
|
- Prefer inspecting existing streams and DLOs before creating new ingestion assets.
|
|
49
49
|
- Suppress linked-plugin warning noise with `2>/dev/null` for normal usage.
|
|
50
50
|
- Treat DLO naming and field naming as Data Cloud-specific, not CRM-native.
|
|
@@ -59,7 +59,7 @@ Ask for or infer:
|
|
|
59
59
|
|
|
60
60
|
### 1. Classify readiness for prepare work
|
|
61
61
|
```bash
|
|
62
|
-
node
|
|
62
|
+
node ../orchestrating-datacloud/scripts/diagnose-org.mjs -o <org> --phase prepare --json
|
|
63
63
|
```
|
|
64
64
|
|
|
65
65
|
### 2. Inspect existing ingestion assets
|
|
@@ -39,7 +39,7 @@ Ask for or infer:
|
|
|
39
39
|
## Core Operating Rules
|
|
40
40
|
|
|
41
41
|
- Treat Data Cloud SQL as its own query language, not SOQL.
|
|
42
|
-
- Run the shared readiness classifier before relying on query/search surfaces: `node
|
|
42
|
+
- Run the shared readiness classifier before relying on query/search surfaces: `node ../orchestrating-datacloud/scripts/diagnose-org.mjs -o <org> --phase retrieve --json`.
|
|
43
43
|
- Use describe before guessing columns.
|
|
44
44
|
- Prefer `sqlv2` or async query flows for larger result sets.
|
|
45
45
|
- Use vector search or hybrid search only when the search index lifecycle is healthy.
|
|
@@ -51,9 +51,9 @@ Ask for or infer:
|
|
|
51
51
|
|
|
52
52
|
### 1. Classify readiness for retrieve work
|
|
53
53
|
```bash
|
|
54
|
-
node
|
|
54
|
+
node ../orchestrating-datacloud/scripts/diagnose-org.mjs -o <org> --phase retrieve --json
|
|
55
55
|
# optional query-plane probe, only with a real table name
|
|
56
|
-
node
|
|
56
|
+
node ../orchestrating-datacloud/scripts/diagnose-org.mjs -o <org> --phase retrieve --describe-table MyDMO__dlm --json
|
|
57
57
|
```
|
|
58
58
|
|
|
59
59
|
### 2. Choose the smallest correct query shape
|
|
@@ -4,7 +4,6 @@ description: "Write, run, and analyze structured test suites for Agentforce agen
|
|
|
4
4
|
allowed-tools: Bash Read Write Edit Glob Grep
|
|
5
5
|
metadata:
|
|
6
6
|
version: "1.0"
|
|
7
|
-
last_updated: "2026-04-08"
|
|
8
7
|
argument-hint: "<org-alias> --authoring-bundle <AgentName> [--utterances <file>] | run <org> --target <flow://Name>"
|
|
9
8
|
compatibility: claude-code
|
|
10
9
|
---
|