用途：shortcuts-generator 用于生成 macOS 与 iOS 的快捷指令（Shortcuts），通过创建 plist 文件产出有效的 .shortcut 文件，可签名后导入 Apple 快捷指令应用。适用于被要求创建快捷指令、自动化工作流、构建 .shortcut 文件或生成快捷指令的场景。
主要能力：快捷指令本质是二进制 plist，根结构包含 WFWorkflowActions（动作数组）、WFWorkflowClientVersion、WFWorkflowIcon（图标字形编号与起始颜色）、WFWorkflowMinimumClientVersion、WFWorkflowName、WFWorkflowTypes 等键。每个动作包含标识符（如 is.workflow.actions.gettext）、参数（WFWorkflowActionParameters）和 UUID。还支持变量引用与重复、条件、菜单等控制流。
必要用法：编写 XML plist 保存为 .shortcut，再用 macOS shortcuts CLI 签名，例如 shortcuts sign --mode anyone --input MyShortcut.shortcut --output MyShortcut_signed.shortcut，或 --mode people-who-know-me。签名会附加约 19KB 的加密签名，签名后文件即可打开或导入快捷指令应用。
引用变量时：源动作需带 UUID 参数，在 attachmentsByRange 中用 OutputUUID 引用，字符串中以占位符 （U+FFFC）标记插入位置，并将 WFSerializationType 设为 WFTextTokenString。控制流动作使用 GroupingIdentifier 连接起止动作，WFControlFlowMode 取 0=开始、1=中间（else/case）、2=结束。
常见动作包括：Text（is.workflow.actions.gettext）、Show Result、Ask for Input、Use AI Model、Comment、URL、Get Contents of URL、Get Weather、Open App、Open URL、Alert、Notification、Set/Get Variable、Number、List、Dictionary、Repeat（count/each）、If/Otherwise、Choose from Menu、Find Photos、Delete Photos 等。
限制与规则：UUID 必须大写；WFControlFlowMode 为整数；范围键格式为 {位置, 长度}；占位符字符为 （U+FFFC）；每个控制流开始都需有同 GroupingIdentifier 的结束动作。官方资料还列出 PLIST_FORMAT.md、ACTIONS.md（含 427 个 WF*Action 标识符）、APPINTENTS.md（728 个 AppIntent 动作）、PARAMETER_TYPES.md、VARIABLES.md、CONTROL_FLOW.md、FILTERS.md、EXAMPLES.md 等详细参考文件。签署模式、动作参数细节及具体平台收费与效果暂未提供。