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

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 bao gồm các phần trong cấu hình flow dễ bị sai: 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ì bản xem trước được 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 đi kèm trong repository adapty-skills cùng với adapty-integration, flow-audit, migrate-placements, ads-manager, paywall-teardown, và onboarding-teardown. Mỗi lệnh sau đây sẽ cài đặt cả bảy công cụ.

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 & Paywall Builder. Nếu bạn đã mở flow trong một tab trình duyệt, hãy tải lại trang — Flow & Paywall Builder không tự nhận các thay đổi được thực hiện qua CLI.
2. Xem lại những gì đã thay đổi. Adapty đánh dấu 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 gần nhất.
3. Xem trước trên thiết bị thực. Xem trước flow hướng dẫn 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ấp Publish to Live ở góc trên bên phải của Flow & Paywall Builder, hoặc chạy adapty flows publish từ terminal. Một flow chưa được thêm vào placement thì sẽ không đến được 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 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 xác nhận. Hãy yêu cầu nó ghi lại file đó, hoặc tự sửa flow trong Flow & Paywall 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 công cụ

Skill này tải lên hình ảnh từ máy tính của bạn và gắn URL trả về vào flow, giúp bạn không phải thêm media thủ công trong Flow & Paywall Builder. Công cụ cần một đường dẫn file, 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 chỉ nhận được dữ liệu pixel mà không có file thực, nên 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, rồi chỉ đường dẫn đó cho công cụ:

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 & Paywall Builder — xem Ảnh, video và icon. SVG là ngoại lệ duy nhất: tải lên sẽ thất bại, nên công cụ sẽ vẽ trực tiếp các glyph đơn sắc dạng inline.

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 được, nê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ẻ giống. File sai sẽ tạo ra màn hình render đúng nhưng hiển thị ảnh sai, và không có gì trong quy trình có thể phát hiện điều đó.

Mang theo agent của bạn

Adapty cũng có AI Editor bên trong Flow & Paywall Builder. Điểm 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ở. Còn skill này là sắp xếp ngược lại: agent của bạn, model của bạn, công cụ của bạn, và Adapty chỉ là một trong những công cụ mà nó biết cách vận hành. Mọi thứ mà AI tool của bạn đã có thể tiếp cận đều đi kèm với nó — repo của bạn, file thiết kế của bạn, MCP server của bạn, prompt và context của chính 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.

• Việc xuất bản vẫn do bạn quyết định: Skill chỉ dừng lại ở bản nháp đã lưu và không bao giờ tự xuất bản. Bạn tự xuất bản trong Flow & Paywall Builder, hoặc dùng adapty flows publish.
• Ghi đè cần sự xác nhận của bạn: 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. Xác nhận sẽ nêu tên flow, ID của flow, 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 lệnh ghi thất bại: Mỗi lần ghi sau lần đầu tiên đều gửi kèm timestamp updated_at của cấu hình về Adapty. Nếu trong thời gian đó một thành viên trong nhóm đã lưu flow, Adapty sẽ từ chối lệnh ghi thay vì ghi đè công việc của họ.
• Xóa flow vẫn là thao tác trên dashboard: CLI không có lệnh xóa, vì vậy flow mà skill đã tạo cho bạn sẽ tồn tại cho đến khi bạn xóa nó khỏi dashboard.
• Số liệu và tài nguyên thực phải do bạn cung cấp: Đánh giá, số lượt nhận xét, phần trăm giảm giá và giá cửa hàng sẽ không bao giờ được bịa ra. Khi một mẫu cần một thông tin mà 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: Skill này đặt một phần tử media vào vị trí video, giúp bố cục đã đúng ngay khi bạn hoán đổi file trong Flow & Paywall Builder.
• Fonts: Skill này tạo các text style mà thiết kế của bạn yêu cầu và gán chúng vào một font chữ placeholder. Tải font lên trong Flow & Paywall Builder và gán nó cho các style đó.

Preview chỉ hiển thị một màn hình, trong một trạng thái

Trang xem trước của skill chỉ hiển thị một màn hình duy nhất và không chạy toàn bộ flow. Nó không thể hiển thị những điều 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: Nút có hành động điều hướng sẽ giữ nguyên vị trí trong preview, vì vậy các route có điều kiện 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 lựa chọn nhiều tùy chọn hiển thị ở trạng thái tắt theo giá trị mặc định của chúng. Hàng lựa chọn đơn và thẻ sản phẩm sẽ hiển thị đúng trạng thái được chọn.
• Bất kỳ ngôn ngữ nào ngoài ngôn ngữ đang hiển thị: Preview bỏ qua ngôn ngữ mặc định của flow và thứ tự danh sách ngôn ngữ, vì vậy không thể kiểm tra bản dịch trực quan. Hãy chuyển ngôn ngữ trong Flow & Paywall Builder và tìm các đoạn văn bản bị tràn ra ngoài container.
• Bất kỳ thứ gì được xử lý ở runtime: Giá thực tế, đơn vị tiền tệ của cửa hàng và đầu vào từ người dùng. Biến giá sẽ hiển thị dưới dạng token chữ, thường dài hơn giá thực và có thể đẩy văn bản xuống dưới nút cố định — hiện tượng chồng lấp này sẽ biến mất khi giá được xử lý.
• Kích thước màn hình mà trang không biết: Bố cục phụ thuộc vào chiều cao viewport cần được kiểm tra trên điện thoại màn hình nhỏ mới xác nhận được.

Tiếp theo là gì

• Kỹ năng flow-audit — kiểm tra chỉ đọc xem bản nháp mà kỹ năng này để lại có sẵn sàng để phát hành hay chưa, trước khi bạn xuất bản.
• Lưu & xuất bản flow — hoàn thiện bản nháp mà kỹ năng để lại.
• Các vấn đề thường gặp — những gì ngăn một flow không thể xuất bản được.
• Thêm ngôn ngữ trong Adapty Flow & Paywall Builder — thực hiện công việc bản địa hóa tương tự theo cách thủ công.
• Quản lý Adapty bằng AI agents và công cụ lập trình — các kỹ năng Adapty khác và công cụ AI.