AgentKit
Tài liệuBộ kitTham chiếu CLIỨng dụng Desktop
BetaBạn đang đọc tài liệu kênh beta (3.0.0-beta.15). Tính năng có thể thay đổi trước bản stable tiếp theo.Chuyển sang stable →

Skill

Audit form không phải signup với ak:form-cro

Review friction, nhu cầu dữ liệu, accessibility, cách đo và giả thuyết kiểm thử của form trước khi duyệt implementation.

Dùng ak:form-cro để audit form lead capture, contact, yêu cầu demo, application, survey, checkout hoặc yêu cầu báo giá. Mục tiêu là tăng lượt hoàn thành đủ điều kiện, không chỉ tăng submission, đồng thời giữ field mà business, bảo mật hoặc pháp luật cần. Output gồm phát hiện được ưu tiên, thiết kế field được đề xuất, hướng dẫn copy và error, cùng giả thuyết kiểm thử—không phải thay đổi form live.

Chọn ak:form-cro cho form không phải signup

Dùng ak:form-cro khi

  • Bạn cần hiểu form start, completion, field error, abandonment hoặc khác biệt trên mobile.
  • Bạn muốn đối chiếu mọi field bắt buộc và tùy chọn với quy trình follow-up cùng yêu cầu compliance.
  • Bạn cần đề xuất về layout, label, validation, multi-step flow, submit state hoặc kỳ vọng sau submit.

Chọn workflow khác khi

  • Form tạo tài khoản. Hãy dùng workflow CRO cho signup flow.
  • Form nằm trong popup và behavior của container là vấn đề chính. Hãy dùng workflow CRO cho popup.
  • Trang bao quanh, offer hoặc chất lượng traffic mới là vấn đề chính. Audit bề mặt rộng hơn trước khi quy kết kết quả cho form.
  • Bạn đã chọn một thay đổi có thể kiểm thử. Dùng ak:ab-test-setup để thiết kế experiment.

Chuẩn bị bằng chứng về form

Cung cấp URL, screenshot hoặc danh sách field; loại form và audience; điều xảy ra sau submission; số start và completion hiện tại; field-level error và drop-off; device split; cùng các field thực sự được dùng về sau. Đồng thời cung cấp yêu cầu về accessibility, consent, quyền riêng tư, retention, bảo mật và pháp lý. Loại bỏ secret cùng record cá nhân không cần thiết.

Hoàn thành Làm quen, rồi xác nhận Marketing Kit đã được cài cho đúng runtime và scope đang dùng.

RuntimeCách gọiRanh giới khả dụng
Claude Code/ak:form-cro ...Phân phối native là mặc định; phân phối plugin rõ ràng cũng được hỗ trợ.
Cursor/ak:form-cro ...Cách gọi bằng slash đã được người dùng xác minh; không suy ra runtime parity rộng hơn.
Codex$ak:form-cro ...Skill dùng discovery native của Codex; Hook chỉ được projection một phần.

Xem Runtime adapter để hiểu khác biệt ở mức component.

Chạy Skill

/ak:form-cro "Audit form yêu cầu demo này bằng field analytics được cung cấp. Giảm thiểu dữ liệu cá nhân, giữ consent bắt buộc và accessibility, đề xuất test, không sửa hoặc publish form"

Hiểu các giai đoạn review

  1. Phân loại form. Skill xác định mục đích, audience, outcome hoàn thành đủ điều kiện, quy trình follow-up và business constraint của form.
  2. Thiết lập bằng chứng. Skill review start, submission, field drop-off, validation error, completion time và khác biệt thiết bị mà không tạo baseline còn thiếu. Thiếu analytics là một finding: thiết lập instrumentation trước thay vì đoán thay đổi nào sẽ hiệu quả.
  3. Audit field và flow. Skill xem xét tính cần thiết, trạng thái required, thứ tự, grouping, conditional logic, multi-step behavior và lưu tiến độ. Mỗi đề xuất xóa hoặc hoãn field phải nêu owner và cách dùng downstream, hoặc ghi rõ chưa biết và cần xác nhận trước khi shipping.
  4. Review chất lượng tương tác. Skill bao quát label luôn hiển thị, help hữu ích, keyboard cùng autofill, error accessible, giữ input, loading, success và failure state.
  5. Ưu tiên đề xuất. Mỗi thay đổi dẫn bằng chứng hoặc được gắn nhãn giả thuyết, kèm priority và metric xác minh tác động. Tác động conversion dự kiến không phải lời hứa.
  6. Xác định cách đo. Đánh giá thành công bằng qualified completion: số submission hợp lệ, dùng được chia cho số form start đủ điều kiện, với tiêu chí qualification và cửa sổ quan sát rõ ràng. Event view, start, field, error, submit và success hỗ trợ chẩn đoán cùng experiment có scope rõ ràng.

Hướng dẫn về field, layout, multi-step, error, button, trust, mobile và cách đo vẫn có thể được dùng khi cần. Skill chỉ tham khảo tối đa một reference liên quan mỗi task; không yêu cầu chạy mọi checklist cho mọi audit.

Giảm friction không được làm giảm lựa chọn có hiểu biết

Không xóa disclosure bắt buộc, chọn sẵn consent, che trạng thái optional, mô tả urgency sai hoặc làm từ chối khó hơn submit. Conversion không đứng trên nghĩa vụ về quyền riêng tư, accessibility, bảo mật hay pháp lý.

  • Chỉ hỏi dữ liệu có mục đích được ghi nhận, lawful basis khi bắt buộc, retention rule và owner.
  • Không suy luận hay enrichment thuộc tính nhạy cảm nếu chưa được duyệt và chưa có data policy hợp lệ. Tên provider trong đề xuất không cấp quyền network hay chuyển dữ liệu.
  • Giữ label hiển thị, error cụ thể, input được bảo toàn, và bảo đảm đường dùng keyboard-only cùng assistive technology.
  • Xử lý phone number, free-text message, payment detail và application data theo độ nhạy, không như field conversion thông thường.
  • Không bịa cam kết về quyền riêng tư hoặc bảo mật, thời gian phản hồi, testimonial, badge hay social proof khác. Xác nhận claim với policy, data flow thực tế và bằng chứng được cung cấp trước khi dùng.
  • Duyệt riêng code edit, thay đổi analytics, cấu hình vendor, publish và rollout production khỏi bản audit.

Review output và bằng chứng

Kết quả hoàn chỉnh nên gồm:

  • Form audit với bằng chứng hoặc giả thuyết được gắn nhãn, impact rationale, recommendation, priority và validation metric cho từng thay đổi.
  • Danh sách field required/optional có lý do, thứ tự, conditional behavior, label, help text, error copy, submit copy và post-submit state. Mỗi đề xuất xóa hoặc hoãn nêu owner cùng cách dùng downstream hoặc ghi đang chờ xác nhận.
  • Cân nhắc về mobile và accessibility.
  • Event plan tránh thu field value trừ khi được yêu cầu rõ ràng.
  • Giả thuyết kiểm thử với qualified completion là outcome chính, metric hỗ trợ, guardrail và giả định.
  • Ranh giới rõ giữa đề xuất và implementation được duyệt riêng.

Xử lý sự cố workflow

Triệu chứngBước tiếp theo an toàn
Không có field-level evidenceThêm event start, error, submit-attempt và success đã review quyền riêng tư trước khi xếp hạng tác động của field.
Có thêm lead nhưng chất lượng giảmĐánh giá thành công bằng qualified completion, không phải raw submission, và xem context cần thiết downstream có bị xóa không.
Một field bắt buộc về pháp lýGiữ field, giải thích lý do và test độ rõ hoặc timing thay vì âm thầm xóa.
Abandonment mobile caoXác minh keyboard type, autofill, tap target, viewport, validation và giữ dữ liệu trên thiết bị thật.
Runtime không tìm thấy SkillXác nhận target cùng scope, khởi động lại runtime, rồi làm theo Runtime không tìm thấy Skill hoặc Agent.

Biết các giới hạn

  • Quy tắc về số field và layout là giả thuyết, không phải effect size chung.
  • Riêng completion rate không đo chất lượng lead, mức hiểu của người dùng, payment thành công hay downstream value.
  • Skill không thể xác minh accessibility, analytics, compliance hay behavior của vendor đang live nếu thiếu quyền truy cập và bằng chứng tương ứng.

Tiếp tục với ak:ab-test-setup sau khi chọn đề xuất, hoặc xem Tổng quan Marketing Kit.