用于审核流程的 Agent 技能

flow-audit 技能只回答一个问题：这个流程是否已准备好投入生产？将你的 AI 编码工具指向某个流程，它会通过 Adapty CLI 读取配置，并与你的产品目录进行比对，最终给出一个明确的结论——而不是一份需要你自己解读的清单。

一个流程可以通过所有现有的发布检查，但对用户来说仍然是不安全的。Flow & Paywall Builder 自身的发布检查和 flows config validate 都只问”这个文档格式是否正确？“——两者都不会问”真实用户会不会卡住，或者看到错误的内容？“处于 publication_failed 状态的流程可以通过这两个检查；而 flow-audit 正是用来发现其余问题的。

Note

flow-audit 从不对流程进行写入操作。它读取配置和你的产品目录，运行检查，并将发现的所有问题交给你——或者交给 flow-generator skill——来修复。

安装技能

flow-audit 包含在 adapty-skills 插件中（adaptyteam/adapty-skills），与 flow-generator 一同提供——安装一次即可获得插件内的所有技能，目前共七个，其中包括 flow-audit。

适用于 Claude Code：

claude plugin marketplace add adaptyteam/adapty-skills
claude plugin install adapty-skills@adapty

然后运行 /reload-plugins 激活技能。对于其他 AI 编码工具，请参照 flow-generator 的安装步骤——同一仓库，同样的命令。

Then ask for it — /flow-audit in tools that map slash commands to skills, or “Use the flow-audit skill” in the ones that don’t. Name the flow, or let it list your flows and ask which one.

工作原理

全程只读，共五个阶段：

解析与认证。 确认 CLI 版本是否符合要求，以及 Adapty 登录状态是否有效。
选择流程。 列出所有流程（adapty flows list），并询问要检查哪一个。
获取数据。 拉取该流程的配置和产品目录——每次检查都基于这份快照进行。
执行检查。 所有检查仅针对该快照运行。
生成报告。 输出一个最终结论，而非逐条列表。

检查内容

触发器：某个元素的文案承诺了一个操作，但在其整个祖先链上都没有任何交互绑定。它的外观和正常控件完全一样，但点击后什么也不发生。
商店合规性：流程中某处可访问的恢复购买操作、指向服务条款的链接、指向隐私政策的链接，以及允许用户不购买就离开付费墙的方式。
产品：已绑定但在您目录中缺失的产品、没有商店绑定的产品、卡片声明的计费周期与产品实际不符，或在应使用价格变量的地方写死了价格。
变量：流程中已设置但从未读取的变量，导致某个页面收集了答案，却没有任何地方使用它。
本地化：空白翻译、未翻译的值以及各语言区域的覆盖情况。
占位符：从未完成填写的文案——Lorem ipsum、TODO、Your headline here——以及仍命名为 Untitled 的流程。

严重程度

每个发现都会被归入以下三个等级之一：

等级	含义
阻断	该流程对真实用户无法正常运行，或会向用户展示虚假信息——一个凭空捏造的价格即便显示正常，也仍然是谎言。
风险	可以运行，但很可能并非预期效果：占位文本、与默认语言区域相同的值、无人读取的变量。
待确认	根据现有数据无法判断。报告会说明所见内容、无法获取的信息，以及唯一需要核查的事项——而不是凭空猜测。

示例报告

Flow: Nimbus onboarding  ·  publication_failed
7 screens · 3 locales · 2 products

NOT READY FOR PRODUCTION — 2 blockers: no restore action, no way off the paywall

BLOCKERS

1. This row is dead text.
   scr_paywall / el_089T reads "Restore purchase · Terms · Privacy" and carries no
   interaction at all. It renders exactly like a working row, and none of the following work:
     · no restorePurchases action anywhere in the flow    → App Store 3.1.1
     · no link to terms/EULA                              → App Store 3.1.2
     · no link to a privacy policy                        → App Store 3.1.2

2. a user who does not buy cannot leave this screen: no closeFlow or navigateBack is
   reachable from it.

该流程的状态为 publication_failed，付费墙编辑工具的发布检查和 flows config validate 均已通过——两者都不会读取屏幕上的文案内容，也不会遍历其交互逻辑。报告本身以结论开头，随后列出带编号的阻塞项，并精确指出需要打开的元素和屏幕。

无问题流程的结论行显示为 READY FOR PRODUCTION，其后不附加任何内容。如果 flow-audit 未发现阻塞项或风险，但仍存在无法自行确认的待查项，则结论行显示为 READY, PENDING n CHECKS I CANNOT MAKE，而非对其无法核实的内容作出认证。

无法检查的内容

flow-audit 无法检查流程是否已关联到版位。adapty flows get 仅返回流程的 id、name、status 和 updated_at，且 CLI 没有任何命令可以列出流程所在的版位。这是每份报告中固定显示的提示，而非检查项：请在版位页面自行确认版位配置，或参阅创建版位。

谁来修复什么

每份报告最后都有一个 WHAT TO DO NEXT 章节，按责任方拆分：哪些内容由智能体在流程中自行修改、哪些只能由你在 Adapty 看板中修改、哪些需要在上线前自行确认。

flow-audit 本身不做任何修改——它被设计为只读模式，因此未通过审核的流程会保持原样。请将报告交给 flow-generator skill，由它负责备份、获取你的确认并执行实际写入操作。