workflows-list

Zapier 工作流列表

使用公开 SDK CLI 实验性命令界面。不要使用 zapier-sdk-code-substrate。

兼容性检查

使用此技能前，先运行 workflows-doctor 套件兼容性检查。如果未安装或无法加载 workflows-doctor，请运行 workflows-install，或从 zapier/agent-skills 安装 workflows-doctor，然后再继续。如果 workflows-doctor 报告 SDK／技能存在差异，请按照其刷新说明操作，停止此次技能调用；如有需要，重新加载 Agent 工作区，并让用户重新运行原始请求。

检查前提条件

zapier-sdk --version
zapier-sdk get-profile --json
zapier-sdk --stability experimental --help

如果身份验证失败，请让用户在交互式终端中运行 zapier-sdk login，然后重试。

列出工作流

zapier-sdk --stability experimental list-workflows --json

解析 JSON 输出，并按用户要求的格式整理内容。常见的有用字段可能包括 id、name、enabled、is_private、created_by_user_id、created_at、updated_at、description、current_version，以及存在时的触发器相关元数据。

对于每个包含 id 的工作流，请提供 Zapier 编辑器链接：

https://zapier.com/workflow/<workflow-id>

将 trigger_url 视为与账户相关的敏感信息：访问该链接会以已验证账户的身份触发工作流，因此，虽然 URL 中的令牌不再是独立凭据，但仍不应随意打印。除非用户明确要求，否则不要打印 trigger_url。

检查 triggers[] 中每个条目的 details.webhook_url，无论触发器类型是什么——只要该字段存在，就表示有一个接收 URL。与 trigger_url 不同，webhook_url 是用于分享的 URL，也就是用户粘贴到外部服务中的 URL，因此存在时应直接展示。大多数触发器都没有 webhook_url，这很正常；除非用户明确期待该字段（例如提到“Webhooks by Zapier”），否则不要将其缺失标记为问题。在这种情况下，已安装的 SDK 可能早于此字段。

打开草稿

工作流的已发布状态并不能说明全部情况——它也可能有打开的服务端草稿，而打开的草稿始终包含尚未发布的更改（发布时会消耗草稿）。当用户询问未发布的更改、进行中的工作，或为什么编辑器显示的内容与线上版本不同时，请检查：

zapier-sdk --stability experimental list-workflow-drafts <workflow-id> --json

展示每个打开草稿的 slug、last_edited_at 和 last_edited_by_user_id，并说明其 base_version_id 是否与最新的已发布版本匹配（如果基于更早版本，则表示该草稿早于当前线上版本）。请包含草稿的编辑器链接：https://zapier.com/workflow/<workflow-id>/draft/<draft-slug>/workflow.ts——最后一段是草稿 source_files 的一个键（此套件的工作流中为 workflow.ts）。不要在普通列表中为每个工作流都获取草稿——每个工作流都需要单独请求；仅在用户提出要求或讨论相关工作流时获取。

所有权范围

list-workflows 可能会返回已验证用户可查看的所有工作流，包括团队工作流。如果用户询问“我的工作流”，请先展示可能匹配的工作流，并说明存在的不确定性，不要默默按错误的 ID 进行筛选。

已知问题：zapier-sdk get-profile 返回的 UUID 可能与 list-workflows[].created_by_user_id 不匹配，后者可能是单独的数字用户 ID。如果无法可靠地对应这些 ID，请如实说明，并提供未筛选的列表及足够的上下文，供用户选择。

最近运行时间

如果用户询问近期活动，请获取每个相关工作流的运行记录：

zapier-sdk --stability experimental list-workflow-runs <workflow-id> --json

使用最近一次运行记录。对于大型账户，请注意 API 请求量。