mirror of
https://github.com/forcedotcom/afv-library.git
synced 2026-08-09 00:42:46 +08:00
Scaffolds the explaining-batch-data-transform skill directory and delivers
the full, production-grade SKILL.md body. 194 lines.
Directory layout established (skills/explaining-batch-data-transform/):
- SKILL.md — the entry point this commit adds
- scripts/ — parser lands in commit 2
- references/, assets/ — reference docs + samples land in commit 3
- tests/ — unit tests + fixtures land in commit 4
SKILL.md frontmatter:
- name, description, tier, and owner fields matching the library's CI
validator schema.
- Description covers the full production surface: "Explain, audit, and
trace Salesforce Data Cloud Batch Data Transform (BDT) JSON — sources,
sinks, stages, lineage, field traces, formulas, multi-definition
payloads, and dual input shapes (editor export + Connect API)."
SKILL.md body (12 sections):
1. When to use this skill
2. Inputs you accept (editor export, Connect API single-definition,
Connect API multi-definition payloads)
3. Mode A — structural survey (summary / sources / outputs / stages)
4. Mode B — per-node explanation (nodes / node)
5. Mode C — lineage + field trace
6. Mode D — formulas and windows
7. Question routing table (user phrasing -> CLI subcommand)
8. Multi-definition payload handling (--definition flag semantics)
9. Troubleshooting (malformed JSON, unknown node refs, broken upstream)
10. Non-goals as explicit "Do not" directives (no execution, no schema
inference beyond what the JSON states, no speculation about runtime)
11. References + sample BDTs index
12. Exit-code + error-class contract surfaced from bdt_analyze.py
Structure passes the repo's skill-validator (npm run validate:skills):
single top-level H1, required sections present, frontmatter schema
aligned, no broken internal links.
@W-22196528@
|
||
|---|---|---|
| .. | ||
| applying-slds | ||
| building-ui-bundle-app | ||
| building-ui-bundle-frontend | ||
| creating-b2b-commerce-store | ||
| deploying-ui-bundle | ||
| developing-agentforce | ||
| explaining-batch-data-transform | ||
| generating-apex | ||
| generating-apex-test | ||
| generating-custom-application | ||
| generating-custom-field | ||
| generating-custom-lightning-type | ||
| generating-custom-object | ||
| generating-custom-tab | ||
| generating-experience-lwr-site | ||
| generating-flexipage | ||
| generating-flow | ||
| generating-fragment | ||
| generating-lightning-app | ||
| generating-list-view | ||
| generating-permission-set | ||
| generating-ui-bundle-features | ||
| generating-ui-bundle-metadata | ||
| generating-ui-bundle-site | ||
| generating-validation-rule | ||
| implementing-ui-bundle-agentforce-conversation-client | ||
| implementing-ui-bundle-file-upload | ||
| observing-agentforce | ||
| searching-media | ||
| switching-org | ||
| testing-agentforce | ||
| trigger-refactor-pipeline | ||
| uplifting-components-to-slds2 | ||
| using-ui-bundle-salesforce-data | ||
| validating-slds | ||