SuperAPI AI 工具集

dx-org-snapshot-manage

数据与分析

查看项目

更新于 10-15 21:43

技能介绍

用途:协调 Salesforce scratch org 快照(snapshot)的完整生命周期,包括创建、查看状态、列出和删除。快照是 scratch org 在某一时间点的副本(含元数据与数据),可在 scratch org 定义文件中按名称引用,从而从已保存状态快速创建新 org。

主要能力:

  • 创建:sf org create snapshot --source-org <orgId|alias> --name <SnapshotName> --json,可选 --description 与 --target-dev-hub。
  • 查看状态:sf org get snapshot --snapshot <name|0Oo...> --json。
  • 列出:sf org list snapshot --json,返回数组;可按 ExpirationDate 客户端过滤,无服务端过滤。
  • 删除:sf org delete snapshot --snapshot <name|0Oo...> --json;非交互场景加 --no-prompt。无批量删除命令,每个快照需单独调用。

使用方式:仅用 Bash 工具执行上述命令,不使用 MCP 工具。所有命令均以 --json 输出。命令针对 Dev Hub(--target-dev-hub),若未指定则查配置 sf config get target-dev-hub,无法确定时停止并建议 sf org login web --set-default-dev-hub。有输出目录时需将完整未修改 JSON 写入 create-snapshot-result.json、get-snapshot-result.json、list-snapshots-result.json 或 delete-snapshot-result.json;否则在回复中逐字给出完整 JSON。

适用场景:需保存并复用 scratch org 状态、检查快照状态或到期时间、清理快照时。创建 scratch org(含从快照创建)、org shape 管理不在本技能范围,分别交给 dx-org-manage 与 dx-org-shape-manage。

限制:Dev Hub 必须启用 Scratch Org Snapshots;源 org 必须是 scratch org;快照名称在 Dev Hub 内唯一且不超过 15 字符;创建为异步,需轮询 sf org get snapshot 直至 Status 为 Active。无更新、重命名或延长到期时间的命令;删除默认需确认,不可恢复,批量删除前须列出并让用户确认。权限影响可见性与删除范围。