SuperAPI AI 工具集

flow-audit

测试与质量

查看项目

更新于 10-15 10:54

技能介绍

用途

flow-audit 用于回答一个明确的问题:这个 Flow Builder 流程是否已准备好上生产环境。它给出的不是一份关于流程的清单,而是一个结论——可以发布,或不可发布及原因——并附上按优先级排序的发现项,每项都带有具体修复建议。一个阻断项就是回答“否”的理由。

主要能力

该技能为只读操作,从不调用流程配置更新、产品创建或流程创建等写入命令。它会将流程配置与线上后台(目录、访问等级)进行交叉核对,以捕捉离线检查器在结构上无法发现的问题,例如绑定的产品不存在、产品没有商店绑定、卡片文案声称的周期与产品实际周期不符。

审计脚本 audit-flow.py 检查六个完整性类别:触发器、商店合规、产品、变量、本地化、占位符。此外还运行六项商店审查检查(试用开关、未展示计费金额、派生的价格更突出、未披露周期、试用条款不完整、外部购买链接),这些检查为建议性质,不改变最终结论,仅作为风险/疑问单独列出。

verify-config.py 属于 flow-generator 技能,是结构检查器(形状、不变量、引用完整性);flow-audit 运行并报告其输出,不重复实现它已负责的检查。

使用方式

流程分为五个阶段:

  1. 解析和认证:解析 $ADAPTY(npx --yes adapty@latest),检查 adapty auth status。本技能不安装任何东西,也不以版本号为门禁。若无会话,需用户运行 adapty auth login。随后通过 apps list 解析应用。

  2. 选择流程:通过 flows list 列出流程。从不审计用户未指定或未选择的流程。

  3. 获取数据:通过 flows config get 获取流程配置信封并提取其中的 config;通过 products list 获取目录;获取每个 placement(placement 不含受众,需逐个用 placements get 读取);读取应用其他已发布流程提供的语言,以便判断当前流程是否缺少应用其余部分支持的语言。

  4. 检查:按顺序运行三条命令——verify-config.py、audit-flow.py、flows config validate。顺序重要:两个本地检查先在一次遍历中命名所有缺陷,而 validate 是网络往返,放最后可先让本地检查捕获所能捕获的一切。

  5. 报告:audit-flow.py --report 输出报告,作为回答的内容与顺序。保留全部内容,不增删、合并或重新编号。翻译为用户的语言,但用户在其它工具屏幕上看到的内容(如构建器标签、App Store Connect 字段名、屏幕名、产品标题、placement ID、指南编号)保持原样。

适用场景

当客户询问某个 Flow Builder 流程是否已就绪、想要审计或检查,或问类似“我是否遗漏了什么”时使用。

限制

  • 该技能只读,不修复任何问题;需要修复时移交给 flow-generator(其负责备份、审批门和写入)。
  • 本技能不实现变换,除为检查而获取的工作副本外不触碰磁盘上的配置。
  • 无法验证应用是否实际获取该 placement(原文在此处中断,具体内容暂未提供)。
  • 若无法检查某项,应说明用户如何自行检查,绝不猜测答案。

结论规则

仅当零阻断项且所有未决问题都已向用户提出并得到回答时,才输出“可以发布”。未回答的问题不算通过。有阻断项时输出“暂不可发布:有 n 项需先修复”;无阻断项但仍有未解决问题时输出“几乎就绪:有 n 项我无法检查”,并列出。绝不认证无法看到的内容。