SuperAPI AI 工具集

workflows-doctor

部署与运维

查看项目

更新于 10-15 16:40

技能介绍

用途:诊断已安装的 Zapier SDK CLI 能否支撑 Zapier Workflows 技能包(workflows-install、workflows-create、workflows-list、workflows-history、workflows-modify),把整个技能包作为一个单元检查兼容性。

主要能力与步骤:先执行每日技能新鲜度检查 bash scripts/skill-freshness-check.sh(相对本技能自身目录解析脚本),每日约一次、非阻塞,仅在真正更新时提示;随后检查 SDK CLI 版本:which zapier-sdk、zapier-sdk --version、npm view @zapier/zapier-sdk-cli version;低于 sdk_cli_min 时用 npm install -g @zapier/zapier-sdk-cli@latest 更新,权限问题应修复 Node/npm 环境而非使用 sudo。之后用 zapier-sdk --experimental --help 及 zapier-sdk --experimental <candidate-command> --help 发现当前命令面,确认创建 workflow、发布版本/草稿、列出与新建(fork)草稿、读取、带 draft-revision 并发更新、丢弃草稿、本地/合成运行 durable workflow、列出 workflow 与运行、检视运行、发现触发器、触发 workflow、控制可见性、绑定连接与 app 版本、传输入、控制启用状态等必要能力。命令名与标志以当前 help 输出为准,资料中的示例命令与标志仅为已验证版本示例。

刷新决策:全部能力确认则无需刷新;若缺失或无法确认兼容性,优先用 npx skills update workflows-install workflows-doctor workflows-create workflows-list workflows-history workflows-modify -y 更新整包,失败时回退到 npx skills add zapier/agent-skills --skill <名称> --yes 逐个安装。更新后需停止当前技能调用,提示用户重载工作区并重跑原请求。

限制:命令面检查只验证所需能力是否存在,不证明 workflow 正确性或 JSON 载荷语义未变;技能包以 sdk_cli_min / sdk_cli_validated = 0.74.0 为门槛,因发布路径需 publish-workflow-draft --manual(COSUB-1076);publish-workflow-version --manual 早在 0.72.0(COSUB-1023)出现,但技能包以最新依赖标志为准。已打开草稿时不得越过草稿发布。可设 ZAPIER_WORKFLOWS_DEBUG=1 在 stderr 查看新鲜度检查决策。