Kỹ năng agent để làm việc với flows

Kỹ năng flow-generator cho phép công cụ lập trình AI xây dựng và chỉnh sửa các flow của bạn ngay từ terminal. Chỉ cần mô tả bằng ngôn ngữ tự nhiên những gì bạn muốn xây dựng hoặc thay đổi, công cụ sẽ đọc cấu hình builder của flow qua Adapty CLI, viết lại, hiển thị bản xem trước, rồi lưu bản nháp sau khi bạn phê duyệt.

Một skill là tập hợp các hướng dẫn mà AI tool của bạn tải theo yêu cầu. Skill này đề cập đến những phần dễ mắc lỗi trong cấu hình flow: những chỉnh sửa nào sẽ dừng quá trình publish, những tham chiếu nào bị hỏng khi bạn xóa một màn hình, và những gì preview đã render có thể và không thể chứng minh.

Trước khi bắt đầu

• Công cụ lập trình AI hỗ trợ skill: Claude Code, GitHub Copilot CLI, OpenAI Codex và Gemini CLI đều hoạt động được.
• Sản phẩm trong danh mục Adapty của bạn: Trước khi thiết kế màn hình bán hàng, skill sẽ liệt kê các sản phẩm của bạn và hỏi bạn muốn hiển thị sản phẩm nào. Nếu không có sản phẩm nào phù hợp, nó có thể tạo mới từ các store product ID mà bạn cung cấp, và sẽ hỏi trước khi thực hiện.

Bạn có thể làm gì với nó

Tạo một flow từ đầu

• Từ mô tả: “Một paywall cho ứng dụng fitness của tôi, hai gói, gói năm được chọn sẵn.” Skill tự chọn bố cục, xây dựng từ các pattern đã được kiểm chứng — tabs, card gói, toggle, đếm ngược, thanh tiến trình, bottom sheet — và dùng các sản phẩm bạn đã chọn từ catalog.
• Từ ảnh chụp màn hình hoặc thiết kế: Đưa cho nó một bản tham chiếu và nó sẽ khớp layout, màu sắc, typography, và phong cách icon, sau đó cho bạn biết mọi điểm khác biệt mà nó không thể thu hẹp. Bản tham chiếu có thể là paywall của đối thủ, một màn hình của chính bạn, hoặc một frame từ công cụ thiết kế. Nếu AI tool của bạn được kết nối với công cụ thiết kế đó qua MCP, nó đọc frame trực tiếp — không cần ai xuất ảnh chụp màn hình hay mô tả lại thiết kế bằng lời.
• Được chấm điểm theo tiêu chí chuyển đổi: Khi bạn không cung cấp thiết kế, skill chạy thư viện paywall-teardown của Adapty trên màn hình vừa xây và sửa những điểm xếp hạng cao nhất, trước khi bạn nhìn thấy kết quả. Bạn nhận được một màn hình được xây dựng theo các pattern bán hàng hiệu quả trong danh mục của mình, không phải một layout chung chung.

Thay đổi flow hiện có

• Bản địa hóa thị trường mới: Thêm locale và điền vào mọi trường có thể bản địa hóa — tiêu đề, nhãn nút, chú thích gói, slot hình ảnh và placeholder nhập liệu. Đây là cách nhanh nhất để đưa một paywall đang hoạt động sang mười ngôn ngữ khác nhau.
• Viết lại nội dung trên tất cả các locale cùng lúc: Thay đổi từ ngữ mà không ảnh hưởng đến cấu trúc, chỉnh sửa xung quanh các biến giá thay vì can thiệp trực tiếp vào chúng, để giá vẫn hiển thị đúng.
• Tái cấu trúc flow: Thêm, xóa và sắp xếp lại các màn hình, sau đó sửa lại các điều hướng bị ảnh hưởng và báo cáo các màn hình không thể truy cập được.
• Thêm quiz và phân nhánh: Xây dựng các nhóm có thể chọn, ID tùy chọn và các hành động có điều kiện để dẫn mỗi câu trả lời đến màn hình riêng của nó — bước cá nhân hóa biến onboarding thành một lượt truy cập paywall có chọn lọc.
• Tạo biến thể cho A/B test: Tạo một flow mới được khởi tạo từ một flow đang hoạt động, sau đó áp dụng thay đổi bạn muốn kiểm tra. Theme, font, locale và sản phẩm được giữ nguyên, nên biến thể chỉ khác nhau ở đúng chỗ bạn muốn.
• Thay đổi giao diện theo mùa hoặc chiến dịch: Lấy màu từ ảnh tham chiếu và áp dụng theme mới cho toàn bộ flow, thay vì tự chỉnh từng màn hình một.

Kết quả tạo ra

Một paywall với dòng thời gian các gói

Dòng thời gian có đánh số trên hai thẻ gói đăng ký. Được hiển thị trên thiết bị thực, nên cửa hàng đã xử lý giá — bao gồm cả giá theo tháng mà Adapty tính toán cho gói hàng năm.

Một paywall từ một câu lệnh

Yêu cầu chỉ là “thêm màn hình paywall” — không có tham chiếu, không có flow nguồn. $0.00 là giá trị xem trước tạm thời, và nhãn hiển thị Best value vì không có thông tin giảm giá nào được cung cấp.

Flow ba màn hình

Quiz, kế hoạch, ưu đãi — với điều hướng được kết nối giữa các màn hình. Đồng hồ đếm ngược hiển thị, nhưng chỉ trên thiết bị thật mới kiểm chứng được nó hoạt động đúng không.

Cài đặt skill

Skill này được đóng gói trong repository adapty-skills cùng với adapty-integration, ads-manager và paywall-teardown. Mỗi lệnh sau đây sẽ cài đặt cả bốn.

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

git clone https://github.com/adaptyteam/adapty-skills.git
cp -r adapty-skills/skills/* ~/.copilot/skills/

gemini skills install https://github.com/adaptyteam/adapty-skills

git clone https://github.com/adaptyteam/adapty-skills.git
cp -r adapty-skills/skills/* ~/.agents/skills/

npx skills add adaptyteam/adapty-skills --all

Sau đó gọi nó — /flow-generator trong các công cụ ánh xạ lệnh slash sang skill, hoặc “Use the flow-generator skill” trong những công cụ không hỗ trợ.

Từ đó bạn làm việc bằng ngôn ngữ tự nhiên. Hầu hết các yêu cầu thuộc một trong số này:

• Mô tả flow: Ứng dụng làm gì, màn hình cần bán gì, chọn sẵn gói nào.
• Trỏ vào một thiết kế: Ảnh chụp màn hình, màn hình của bạn, hoặc một frame trong công cụ thiết kế.
• Yêu cầu chỉnh sửa cụ thể: Nêu tên flow và thay đổi cần làm — thêm ngôn ngữ mới, đổi nội dung, thêm màn hình, phân nhánh theo câu trả lời quiz.
• Trả lời câu hỏi của nó: Nó hỏi sản phẩm nào cần đặt trên màn hình, và với bất kỳ con số thực nào nó từ chối tự bịa.

Cách hoạt động

Mọi thứ skill xây dựng đều hội tụ vào một file cục bộ. Không có gì được đưa lên dashboard cho đến bước cuối cùng.

1. Thiết lập và xác thực. Skill cài đặt hoặc cập nhật Adapty CLI nếu cần, sau đó xác minh thông tin đăng nhập Adapty của bạn và đọc app ID. Nếu bạn chưa đăng nhập, nó sẽ mở trình duyệt để đăng nhập và chờ bạn hoàn tất.

2. Chọn hoặc tạo flow. Nếu để chỉnh sửa, công cụ sẽ tải config của flow đó về và báo cáo những gì tìm thấy — các màn hình, ngôn ngữ, sản phẩm và đồ thị điều hướng — để phát hiện sai flow trước khi thay đổi bất cứ điều gì. Công cụ cũng sẽ sao lưu config đã tải trước tiên. Nếu tạo mới, công cụ sẽ tạo một flow hoàn toàn mới thay vì ghi đè lên flow đã có nội dung.

3. Xác thực config. Lệnh này chạy hai bước xác thực cục bộ và một bước xác thực với Adapty. Bước cục bộ kiểm tra xem các tham chiếu nội bộ có còn nhất quán không và các thuộc tính có đúng định dạng không. adapty flows config validate sau đó chạy cùng dịch vụ kiểm soát việc xuất bản, vì vậy kết quả xanh có nghĩa là config có thể xuất bản được. Cả ba bước đều không lưu bất kỳ thứ gì.

4. Xem trước và lặp lại. Skill sẽ render từng màn hình đã thay đổi thành ảnh chụp màn hình và kiểm tra. Khi bạn cung cấp ảnh tham chiếu, nó sẽ so sánh kết quả render với file đó theo từng thành phần — màu sắc, kiểu chữ, phong cách icon, tỷ lệ — rồi thu hẹp các điểm khác biệt mà nó có thể xử lý. Bất kỳ điều gì trông không đúng sẽ đưa skill quay lại bước 3, tốn một lần chụp màn hình thay vì một lần lưu.

5. Phê duyệt và lưu. Việc ghi đè một cấu hình đã tồn tại cần có sự xác nhận rõ ràng từ bạn. Công cụ sẽ hiển thị bản xem trước trước và sau khi chỉnh sửa cho từng màn hình bị tác động, liệt kê các thay đổi không có giao diện trực quan, mở một màn hình trực tiếp trong trình duyệt của bạn, và đặt tên cho file sao lưu. Sau đó mới ghi vào.

Sau khi chạy

Kỹ năng sẽ lưu lại một bản nháp cho bạn. Để đưa nó đến tay người dùng:

1. Mở flow trong Flow Builder. Nếu bạn đã mở flow trong một tab trình duyệt, hãy tải lại trang — Flow Builder không tự nhận thay đổi được thực hiện qua CLI.
2. Xem lại những gì đã thay đổi. Adapty đánh dấu một flow đã được Published trước khi lưu là Dirty, và mọi người trong nhóm của bạn đều thấy trạng thái đó. Người dùng của bạn vẫn tiếp tục thấy phiên bản đã publish lần cuối.
3. Xem trước trên thiết bị thực. Xem trước flow mô tả quy trình dùng mã QR qua ứng dụng di động Adapty. Hãy kiểm tra những gì skill đã báo cáo là chưa được xác minh — phân nhánh, toggle, và bất kỳ ngôn ngữ nào khác ngoài ngôn ngữ đã được render.
4. Publish. Nhấn Publish to Live ở góc trên bên phải của Flow Builder. Một flow chưa được thêm vào placement sẽ không đến được với ai, và flow ở trạng thái Draft không thể được thêm vào placement — vì vậy hãy publish trước. Xem Lưu & publish flow.

Nếu kết quả không đúng, hãy khôi phục từ bản sao lưu: kỹ năng sẽ sao chép cấu hình trước lần chỉnh sửa đầu tiên và đặt tên file trong thông báo phê duyệt. Yêu cầu nó ghi lại file đó, hoặc tự sửa flow trong Flow Builder. Dù bằng cách nào, một bản nháp đã lưu cũng không ảnh hưởng gì đến người dùng của bạn.

Ví dụ về prompt

Skill đã mang theo các lệnh, định dạng cấu hình và các bước xác minh của riêng nó, vì vậy một prompt không cần phải liệt kê tất cả những thứ đó. Chỉ cần nói flow nào và kết quả mong muốn sau khi hoàn thành là gì.

Dịch một paywall

Add Brazilian Portuguese to my "Summer 2026" paywall. Translate every
localizable field, not just the headline, and tell me what you couldn't.

Xây dựng từ một thiết kế

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.

Thêm một quiz có phân nhánh

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.

Viết lại nội dung

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.

Tạo biến thể test

Copy my "Main paywall" into a new flow and make the monthly plan the
preselected one. Leave the original alone.

Thay đổi giao diện cho chiến dịch

Re-theme my paywall flow to match the colors in ./design/spring.png.
Copy and layout stay as they are.

Thêm một màn hình

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.

Cung cấp hình ảnh cho flow

Kỹ năng này tải lên một hình ảnh từ máy tính của bạn và gắn URL trả về vào flow, vì vậy bạn không cần thêm media thủ công trong Flow Builder. Nó cần một đường dẫn tệp, không phải hình ảnh trực tiếp: khi bạn dán hoặc đính kèm hình ảnh vào chat, công cụ AI của bạn nhận được các điểm ảnh nhưng không có tệp, vì vậy không có gì để tải lên.

Hãy đặt các tài nguyên vào một thư mục trên máy tính, sau đó trỏ công cụ đến đó:

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.

Định dạng và giới hạn kích thước khớp với upload thủ công trong Flow Builder — xem Hình ảnh, video và icon. SVG là ngoại lệ duy nhất: file này không thể upload, nên công cụ sẽ vẽ glyph một màu trực tiếp inline thay thế.

Mỗi lần upload sẽ thêm một asset riêng vào thư viện media của bạn, và không có lệnh CLI nào xóa asset đó, vì vậy mỗi lần chạy lại build sẽ để lại các bản sao thừa.

Nếu bạn đặt tên file mà công cụ không tìm thấy, nó sẽ hỏi lại thay vì tự thay thế bằng file trông có vẻ gần giống. File sai sẽ tạo ra màn hình hiển thị đúng nhưng chứa ảnh sai, và không có bước nào trong quy trình phát hiện được điều đó.

Mang agent của bạn vào

Adapty cũng có AI Editor bên trong Flow Builder. Sự khác biệt không phải là cái nào có nhiều tính năng hơn — mà là công việc diễn ra trong môi trường của ai.

AI Editor là agent của Adapty, hoạt động trên màn hình bạn đang mở. Skill này là sắp xếp ngược lại: agent của bạn, model của bạn, tooling của bạn, và Adapty chỉ là một công cụ nữa mà nó biết cách vận hành. Mọi thứ mà AI tool của bạn đã có thể truy cập đều đi kèm theo — repo của bạn, các file thiết kế, MCP server, prompt và context của bạn.

Dùng AI Editor khi bạn đang ở trong builder và muốn tạo lại style cho màn hình hiện tại. Dùng skill khi bạn muốn thực hiện công việc flow mà không cần rời khỏi môi trường của mình.

Những gì kỹ năng này sẽ không làm

Kỹ năng này coi các flow của bạn là nội dung đang hoạt động, vì một flow đã được xuất bản đang phục vụ người dùng thực.

• Xuất bản vẫn do bạn quyết định: Adapty CLI không có lệnh publish, nên công việc của skill chỉ dừng lại ở mức lưu bản nháp.
• Ghi đè cần được bạn phê duyệt: Một lần lưu sẽ thay thế toàn bộ cấu hình, không ghi một phần và không có tính năng hoàn tác. Bước phê duyệt sẽ hiển thị tên flow, ID, trạng thái và file backup mà skill đã tạo trước khi chỉnh sửa.
• Chỉnh sửa đồng thời sẽ khiến ghi thất bại: Mỗi lần ghi sau lần đầu tiên sẽ gửi timestamp updated_at của cấu hình về Adapty. Nếu trong thời gian đó một đồng nghiệp đã lưu flow, Adapty sẽ từ chối ghi thay vì ghi đè lên công việc của họ.
• Xóa flow vẫn phải thực hiện trên dashboard: CLI không có lệnh delete, nên flow mà skill đã tạo sẽ vẫn tồn tại cho đến khi bạn xóa nó trên dashboard.
• Số liệu và tài nguyên thực phải do bạn cung cấp: Đánh giá, số lượt review, phần trăm giảm giá và giá cửa hàng không bao giờ được tự bịa ra. Khi một pattern yêu cầu thông tin bạn chưa cung cấp, skill sẽ hỏi bạn hoặc bỏ qua phần tử đó, và thông báo rõ đã làm gì.

Giới hạn

Chạy mất thời gian

Skill xác thực và render lại sau mỗi thay đổi — đây là cơ chế giúp config lỗi không xuất hiện trên dashboard của bạn — nhưng cũng khiến một lần chạy chậm hơn so với một câu trả lời thông thường trong chat. Một chỉnh sửa nhỏ mất vài phút. Tạo một flow nhiều màn hình có nhánh rẽ mất 10 đến 40 phút. Hãy để nó chạy rồi quay lại sau, đừng ngồi chờ.

Video và font tùy chỉnh vẫn cần làm thủ công

Skill tải lên ảnh, không hỗ trợ video, và không tải lên file font tùy chỉnh. Với cả hai, skill sẽ tạo sẵn slot và để bạn tự tải lên:

• Video: Kỹ năng đặt một phần tử media vào đúng vị trí video, giúp layout đã chuẩn sẵn khi bạn thay file trong Flow Builder.
• Fonts: Kỹ năng tạo các text style mà thiết kế yêu cầu và trỏ chúng đến một font chữ tạm thời. Hãy upload font trong Flow Builder và gán vào các style đó.

Trang xem trước chỉ hiển thị một màn hình, trong một trạng thái

Trang xem trước của kỹ năng chỉ vẽ một màn hình duy nhất và không duyệt qua toàn bộ flow. Nó không thể hiển thị bất kỳ nội dung nào sau đây. Hãy kiểm tra từng mục trên thiết bị thực — Xem trước flow hướng dẫn cách thực hiện:

• Điều hướng và phân nhánh: Một nút có hành động điều hướng sẽ giữ nguyên vị trí trong preview, vì vậy một route có điều kiện sẽ không thể kích hoạt. Mỗi màn hình là một render riêng biệt.
• Toggle và lựa chọn nhiều tùy chọn: Hàng toggle và hàng multi-choice hiển thị ở trạng thái tắt dù mặc định là gì đi nữa. Hàng single-choice và thẻ sản phẩm thì hiển thị đúng trạng thái đã chọn.
• Bất kỳ locale nào khác locale đang hiển thị: Preview bỏ qua locale mặc định của flow và thứ tự danh sách locale, nên bạn không thể kiểm tra trực quan bản dịch. Hãy chuyển locale trong Flow Builder và tìm các đoạn văn bản bị tràn ra ngoài vùng chứa.
• Bất kỳ nội dung nào được xác định lúc runtime: Giá thực, tiền tệ của cửa hàng, và dữ liệu nhập từ người dùng. Một biến giá hiển thị dưới dạng token thô, thường dài hơn bất kỳ mức giá thực nào và có thể đẩy văn bản xuống bên dưới một nút cố định — lỗi chồng chéo này sẽ biến mất khi giá thực được hiển thị.
• Kích thước màn hình mà preview không biết: Một bố cục phụ thuộc vào chiều cao viewport cần được kiểm tra trên thiết bị màn hình nhỏ để xác nhận.

Tiếp theo

• Lưu & xuất bản flow — hoàn thiện bản nháp mà kỹ năng để lại cho bạn.
• Các vấn đề thường gặp — những gì khiến flow không thể xuất bản được.
• Thêm ngôn ngữ trong Adapty Flow Builder — thực hiện thủ công các bước bản địa hóa tương tự.
• Quản lý Adapty bằng AI agent và công cụ lập trình — các kỹ năng Adapty khác và công cụ AI.