用于处理流程的 Agent 技能
流程生成器技能让 AI 编程工具能够通过终端创建和编辑您的流程。只需用自然语言描述您想要构建或修改的内容，该工具就会通过 Adapty CLI 读取流程的编辑器配置，对其进行重写，渲染预览，并在您确认后保存草稿。
技能是 AI 工具按需加载的一组指令。本技能涵盖流程配置中容易出错的部分：哪些编辑会阻止发布、删除某个屏幕后哪些引用会失效，以及渲染预览能证明什么、不能证明什么。
流程生成器技能目前处于实验阶段，所做的更改会直接保存到看板中的流程。请先在草稿或副本上运行，并在流程与付费墙编辑工具中仔细审查每一处变更，再进行发布。
开始之前
- 支持该技能的 AI 编程工具：Claude Code、GitHub Copilot CLI、OpenAI Codex 和 Gemini CLI 均可使用。
- Adapty 目录中的产品：在设计销售界面之前，该技能会列出你的产品并询问哪些应放在其中。如果没有合适的产品，它可以根据你提供的应用商店产品 ID 创建新产品，且会事先征询你的意见。
您可以用它做什么
从零开始创建流程
- 从描述生成：“我的健身 App 付费墙，两个套餐，默认选中年付。“该技能自动选择排版结构，从经过渲染验证的模式库（标签页、套餐卡片、切换开关、倒计时、进度条、底部弹窗）中构建出来，并使用你从产品目录中选定的产品。
- 从截图或设计稿生成：提供参考图，它会匹配布局、颜色、字体和图标风格，并逐一列出所有无法完全还原的差异。参考图可以是竞品的付费墙、你自己的截图，或设计工具中的某一帧。如果你的 AI 工具通过 MCP 连接到该设计工具，它可以直接读取帧内容——无需导出截图，也不用手动描述设计细节。
- 对照转化数据评分：如果你没有提供设计稿，该技能会在构建完成后自动运行 Adapty 的
paywall-teardown库，对生成的页面进行评估，并优先修复评分最低的问题——在你看到结果之前就已完成。你得到的是一个按你所在品类高转化模式打造的页面，而不是千篇一律的通用布局。
修改已有的流程
- 本地化进入新市场：添加语言区域并填写所有可本地化字段——标题、按钮标签、套餐说明、图片插槽和输入占位符。这是将一个已有付费墙快速扩展到十种语言的最高效方式。
- 一次性重写所有语言区域的文案：在不改动结构的前提下修改措辞，并在价格变量周围而非通过价格变量进行编辑，确保价格正常解析。
- 重构流程结构：添加、删除和重新排列屏幕，自动修复因此产生的导航错误，并报告任何无法访问的屏幕。
- 添加测验和分支逻辑：构建可选组、选项 ID 以及将每个答案路由到对应屏幕的条件动作——这一个性化步骤能将用户引导转变为精准的付费墙访问。
- 为测试创建实验变体：基于一个已有效的流程创建新流程，然后应用你想测试的更改。主题、字体、语言区域和产品均会继承，实验变体仅在你预期的地方有所不同。
- 为季节或活动重新换肤：从参考图片中提取颜色，并将新主题应用到整个流程，而无需逐屏手动调整样式。
生成结果
带有计划时间轴的付费墙
两个计划卡片上方的编号时间轴。在设备上渲染，商店已解析了价格——包括 Adapty 为年度计划计算的每月均价。
一句话生成付费墙
提示词只有”添加一个付费墙页面”——没有参考资料，也没有原有流程。$0.00 是预览时的占位数据，Best value 标签的出现是因为没有提供折扣信息。
三屏流程
测验、计划、报价，各屏之间的导航已连接完成。倒计时动画可以渲染，但只有在真机上才能验证它是否正常触发。
安装技能
该技能与 adapty-integration、flow-audit、migrate-placements、ads-manager、paywall-teardown 和 onboarding-teardown 一同包含在 adapty-skills 仓库中。以下任意一条命令均可安装全部七个技能。
然后调用它——在支持斜杠命令映射到技能的工具中使用 /flow-generator，或在不支持的工具中输入”Use the flow-generator skill”。
从那里开始，你用自然语言操作即可。大多数请求属于以下几类：
- 描述流程：说明应用的功能、界面要销售的内容，以及默认选中哪个套餐。
- 指定设计参考：提供截图、你自己的界面，或设计工具中的某个框架。
- 提出具体修改请求：说明流程名称和要修改的内容——新语言版本、不同的文案、额外的界面，或基于问卷答案的分支逻辑。
- 回答它的问题：它会询问哪些产品需要显示在界面上，对于任何真实数字，它不会自行编造。
工作原理
该技能构建的所有内容都汇集到一个本地文件中。在最后一步之前，任何内容都不会同步到你的看板。
-
设置并验证身份。该技能会在需要时安装或更新 Adapty CLI，然后验证你的 Adapty 登录状态并读取你的应用 ID。如果你尚未登录，它会打开浏览器登录页面并等待你完成登录。
-
选择或创建流程。编辑时，它会获取该流程的配置，并报告找到的内容——屏幕、语言区域、产品以及导航图——以便在做出任何更改之前发现错误的流程。它会先对获取到的配置进行备份。对于新建工作，它会创建一个全新的流程，而不是在已有内容的流程上直接生成。
-
验证配置。该工具会对本地文件执行两次验证，并对 Adapty 执行一次验证。本地验证确认内部引用仍然一致，且各属性格式正确。
adapty flows config validate随后会调用与发布时相同的服务进行校验，结果为绿色即表示配置可以发布。这三次验证均不保存任何内容。 -
预览与迭代。该技能会将每个更改过的屏幕渲染为截图并进行检查。如果你提供了参考图片，它会逐项对比渲染结果与文件——颜色、字体、图标样式、比例——并尽力缩小差距。如果发现问题，技能会返回第 3 步，这会消耗一次截图配额，而非一次保存配额。
-
批准并保存。覆盖已有配置前需要你明确确认。该功能会为每个被修改的页面展示渲染前后的对比效果，列出无可视化内容的变更，在浏览器中打开一个实时预览页面，并显示备份文件名。确认无误后才会执行写入。
运行完成后
技能会为你保存一个草稿。要让用户看到它：
- 在 Flow & Paywall Builder 中打开该流程。 如果你已在浏览器标签页中打开了该流程，请刷新页面——Flow & Paywall Builder 不会自动同步通过 CLI 所做的修改。
- 检查变更内容。 对于发布前已处于 Published 状态的流程，Adapty 会将其标记为 Dirty，团队中的所有人都能看到该状态。你的用户仍会看到最后一次发布的版本。
- 在真实设备上预览。 预览流程 介绍了通过 Adapty 移动端应用进行二维码扫描预览的完整流程。重点测试技能报告为未验证的部分——分支逻辑、切换开关，以及除已渲染语言之外的其他语言环境。
- 发布。 在 Flow & Paywall Builder 右上角点击 Publish to Live，或在终端运行
adapty flows publish。未关联到版位的流程不会被任何用户看到，且 Draft 状态的流程无法添加到版位——请先发布。详见保存与发布流程。
如果结果不对，可以从备份恢复：该功能在首次编辑前会复制配置，并在审批消息中注明文件名。你可以让它将该文件写回，也可以在 Flow & Paywall Builder 中手动修改流程。无论哪种方式，已保存的草稿对你的用户都不会有任何影响。
示例提示词
该技能已内置命令、配置格式及验证步骤，无需在提示词中逐一说明。只需指定哪个流程，以及完成后应达到什么效果即可。
为付费墙添加翻译
Add Brazilian Portuguese to my "Summer 2026" paywall. Translate every
localizable field, not just the headline, and tell me what you couldn't.根据设计稿构建
Build a new paywall flow from the "Winter promo" frame in our Figma file.
Show me my products first and let me pick which ones go on it.添加分支测验
Add a quiz screen before my paywall: "What's your main goal?" with three
options, each routing to its own benefit screen, then on to the paywall.重写文案
Rewrite the headline and CTA on my onboarding to be shorter and more direct.
Keep the price variables working, and apply it to every locale.生成测试变体
Copy my "Main paywall" into a new flow and make the monthly plan the
preselected one. Leave the original alone.为活动重新设计风格
Re-theme my paywall flow to match the colors in ./design/spring.png.
Copy and layout stay as they are.添加页面
Add a social proof screen between the quiz and the paywall in my activation
flow — star rating and two testimonials. Ask me for the real numbers.提供图片素材
此技能会从你的计算机上传图片，并将返回的 URL 自动绑定到流程中，省去你在 Flow & Paywall Builder 中手动添加媒体的步骤。它需要的是文件路径，而不是图片本身：当你在对话中粘贴或附加图片时，AI 工具接收到的只有像素数据，没有文件，因此无法进行上传。
将素材放入计算机上的某个文件夹，然后告知工具路径：
The hero images are in ./design/paywall/. Use hero-calm.png on the first
screen and the three icons in ./design/paywall/icons/ for the benefit rows.格式和尺寸限制与在流程及付费墙编辑工具中手动上传的要求一致——详见图片、视频与图标。SVG 是唯一的例外：上传会失败，因此该功能会以内联方式绘制单色字形。
每次上传都会在媒体库中添加一个独立资源，且没有任何 CLI 命令可以删除它，因此重复执行构建会留下多余的副本。
如果指定的文件名找不到对应文件，工具会主动询问，而不会用看起来相似的文件代替。文件名填错会生成一个渲染正常但图片有误的页面，工作流中没有任何机制能发现这类问题。
使用你自己的 AI 代理
Adapty 在 Flow 与付费墙编辑工具中内置了一个 AI 编辑器。两者的区别不在于功能多少，而在于工作发生在谁的环境里。
AI 编辑器是 Adapty 的代理，作用于你当前打开的页面。而 skill 则恰好相反：你的代理、你的模型、你的工具链，Adapty 只是它会操作的众多工具之一。你的 AI 工具已经能访问的一切，都可以随之而来——你的代码仓库、设计文件、MCP 服务器，以及你自己的提示词和上下文。
| AI 编辑器 | flow-generator 技能 | |
|---|---|---|
| 代理归属 | Adapty 的，在浏览器中运行 | 您的，在终端中运行 |
| 可访问内容 | 您当前打开的页面 | AI 工具可访问的所有内容 |
| 单次提示范围 | 单个页面 | 整个流程——页面、导航、语言包 |
| 本地化 | 不涵盖 | 添加语言包并填写所有可本地化字段 |
| 撤销方式 | 每次提示单击一次 | 备份文件，加上每次保存前的确认 |
| 前置配置 | 无需配置 | 需要 Adapty CLI 及该技能 |
当您已进入编辑工具并想对当前屏幕进行重新样式调整时，请使用 AI Editor。如果您不想离开自己的环境来完成流程相关工作，请使用 skill。
技能不会做什么
该技能将您的流程视为实时内容，因为已发布的流程正在为真实用户提供服务。
- 发布操作由您决定：AI 技能只会保存草稿，不会执行发布。您可以自己在 Flow & Paywall Builder 中发布，或使用
adapty flows publish命令。 - 覆盖操作需要您的确认：保存会替换整个配置，不支持部分写入，也无法撤销。确认提示会显示流程名称、ID、当前状态，以及技能在编辑前创建的备份文件。
- 并发编辑会导致写入失败：第一次写入之后，后续每次写入都会将配置的
updated_at时间戳发回 Adapty。如果这期间有团队成员保存了该流程，Adapty 会拒绝本次写入，而不是覆盖他们的修改。 - 删除流程仍需在看板操作：CLI 没有删除命令，因此技能为您创建的流程需要您自行在看板中删除。
- 真实数据和素材由您提供：评分、评论数量、折扣百分比和商店价格均不会凭空生成。当某个模式需要此类信息而您又未提供时，技能会主动询问，或直接省略该元素，并告知您具体做了哪种处理。
读取、验证和预览均不计费，也不会产生任何更改。保存配置是唯一会影响看板的操作，且需要您的确认。
局限性
运行需要时间
每次修改后，技能都会进行验证并重新渲染，这正是保证看板配置不出错的原因——但也使得每次运行比普通对话回复慢。小改动几分钟即可完成。编写一个带分支的多屏幕流程则需要 10 到 40 分钟。启动后去做别的事，不用盯着等。
视频和自定义字体需手动处理
技能可以上传图片，但不支持上传视频，也不支持上传自定义字体文件。对于这两类内容，技能会构建好对应的插槽，并将上传工作交由你完成：
- 视频：此技能会在视频所在位置放置媒体元素，因此在流程与付费墙编辑工具中替换文件时，布局已经就绪。
- 字体：此技能会创建设计所需的文字样式，并将其指向占位字体。在流程与付费墙编辑工具中上传字体后，将其分配给对应样式即可。
预览仅渲染单个屏幕的单一状态
技能的预览页面只会绘制单一界面，无法演示完整流程。以下内容均无法通过预览页面呈现，请在真实设备上逐一测试——具体方法请参阅预览流程：
- 导航和分支跳转：携带导航操作的按钮在预览中保持原位，因此条件路由无法触发。每个页面都是独立渲染的。
- 切换和多选：切换行和多选行始终以其默认的关闭状态显示。单选行和产品卡片则会正常渲染其选中状态。
- 非当前语言环境：预览会忽略流程的默认语言环境和语言列表顺序，因此无法直观地验证翻译效果。请在流程与付费墙编辑工具中切换语言环境，检查是否有文字溢出容器的情况。
- 运行时才能解析的内容：实际价格、商店货币和用户输入均无法预览。价格变量会以字面量 token 形式显示，其长度通常超过实际价格，可能导致文字被固定按钮遮挡——这种重叠在价格真正解析后便会消失。
- 页面无法感知的屏幕尺寸：依赖视口高度的布局需要在小屏手机上实际验证。
下一步
- flow-audit 技能 — 在发布之前，对该技能生成的草稿进行只读检查，确认其是否已准备好上线。
- 保存并发布流程 — 完成该技能生成的草稿。
- 常见问题 — 了解哪些原因会导致流程无法发布。
- 在 Adapty Flow & 付费墙编辑工具中添加语言 — 手动完成同样的本地化工作。
- 通过 AI 智能体和编程工具管理 Adapty — 了解其他 Adapty 技能与 AI 工具。