AgentKit
Tài liệuBộ kitTham chiếu CLIỨng dụng Desktop

Skill

Thiết kế gamification có đạo đức với ak:gamification-marketing

Chọn mechanic có scope rõ ràng, model reward economics cùng abuse, lập kế hoạch implementation và đo behavior không dùng dark pattern.

Dùng ak:gamification-marketing để thiết kế mechanic point, badge, leaderboard, level, streak, challenge, quest, unlockable, reward hoặc progress cho một outcome marketing. Skill có thể tạo campaign strategy, sample configuration, implementation guidance, analytics event và measurement plan. Mechanic vẫn là đề xuất cho đến khi bạn duyệt thay đổi sản phẩm, campaign, reward và dữ liệu.

Chọn ak:gamification-marketing cho behavior có scope rõ ràng

Dùng ak:gamification-marketing khi

  • Bạn có behavior acquisition, retention, engagement, conversion hoặc onboarding cần hỗ trợ và bằng chứng cho thấy behavior đó tạo giá trị cho người dùng.
  • Bạn cần so sánh mechanic với autonomy, competence, relatedness, ability, timing, abuse risk và reward economics.
  • Bạn muốn thiết kế theo phase, event schema, rules outline hoặc implementation brief.
  • Bạn có thể xác định opt-out, accessibility, fairness, support và harm guardrail.

Chọn workflow khác khi

  • Offer hoặc journey nền chưa rõ. Dùng ak:funnel trước.
  • Vấn đề cụ thể là activation sau signup. Dùng ak:onboarding-cro trước khi thêm game mechanic.
  • Bạn đã chọn một experiment. Dùng ak:ab-test-setup cho test plan.
  • Mechanic được yêu cầu phụ thuộc addiction, deception, ép chia sẻ, reward giống gambling, scarcity giả hoặc đe dọa mất mát. Hãy thiết kế lại mục tiêu thay vì tối ưu pattern đó.

Chuẩn bị context về behavior, reward và system

Cung cấp audience, behavior mong muốn, lợi ích người dùng, baseline hiện tại, segment cùng eligibility rule, mechanic đề xuất, reward inventory cùng monetary value, constraint ngân sách và liability, jurisdiction, cân nhắc độ tuổi, abuse model, yêu cầu accessibility, data policy, technical stack, success cùng harm metric. Loại bỏ credential và record người dùng 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:gamification-marketing ...Phân phối native là mặc định; phân phối plugin rõ ràng cũng được hỗ trợ.
Cursor/ak:gamification-marketing ...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:gamification-marketing ...Skill dùng discovery native của Codex; Hook chỉ được projection một phần.

Chạy Skill

/ak:gamification-marketing "Thiết kế draft onboarding challenge 30 ngày với tối đa hai mechanic. Dùng tiến độ thật, tham gia tự nguyện, non-cash reward có cap, accessibility và anti-abuse rule. Nêu giả định, không implement, thông báo người dùng hay launch"

Hiểu các giai đoạn thiết kế

  1. Xác định mục tiêu và giá trị người dùng. Skill nối behavior mong muốn với acquisition, retention, engagement, conversion hoặc onboarding và kiểm tra thành công có lợi cho người tham gia lẫn business.
  2. Chọn tập mechanic nhỏ. Skill so sánh point, badge, leaderboard, level, streak, challenge, quest, unlockable, reward, progress và social sharing; phase đầu nên dùng ít mechanic nhất đủ để test giả thuyết.
  3. Đồng bộ motivation và ability. Skill có thể dùng framework self-determination, behavior và progression làm lăng kính thiết kế, không phải bằng chứng về tác động.
  4. Thiết kế rule và campaign. Skill phác thảo eligibility, earning, redemption, expiry, tier, milestone, difficulty, messaging, reset, recovery và anti-abuse behavior.
  5. Lập kế hoạch implementation. Reference trong package có pattern JSON, PostgreSQL, API, cache, leaderboard và event schema minh họa. Đây là điểm bắt đầu, không phải stack bắt buộc hay contract production-ready.
  6. Đo và review. Skill xác định engagement, completion, retention, conversion, reward cost, fraud, complaint, opt-out, fairness cùng negative feedback, rồi đề xuất experiment theo phase.

Bảo vệ autonomy, fairness và reward economics

Không tối ưu compulsion

Loss aversion, variable reward, scarcity, streak và leaderboard có thể tạo áp lực hoặc exclusion. Không dùng chúng để che odds, phạt nghỉ, đe dọa earned value, ép chia sẻ contact, nhắm vào người dễ tổn thương hoặc buộc tham gia để có basic access. Có thể cần review pháp lý và policy.

  • Giữ participation và sharing tự nguyện, với rule dễ hiểu cùng opt-out accessible không xóa giá trị sản phẩm không liên quan.
  • Hiển thị progress, eligibility, odds, expiry, reward value, cap, tax hoặc fee thực tế khi liên quan, cùng điều xảy ra khi campaign kết thúc.
  • Cung cấp lựa chọn không cạnh tranh hoặc riêng tư thay cho public ranking; ngăn harassment, shaming và lộ hoạt động cá nhân.
  • Model issuance, redemption, breakage, fraud, support, accounting liability, inventory và worst-case reward cost trước launch.
  • Rate-limit và làm award idempotent; xác định đường dispute, correction, rollback và audit trước khi nối rule với purchase hay referral.
  • Có consent cho analytics cùng notification, giảm identifier và tránh sensitive behavioral profiling.
  • Duyệt riêng code, database migration, provider call, notification, reward, campaign publication và spend khỏi thiết kế.

Review output và bằng chứng

Skill khai báo report path sau:

assets/reports/performance/{date}-gamification-analysis.md

Artifact hoàn chỉnh nên gồm behavior hypothesis, user benefit, mechanic đã chọn cùng alternative bị loại, rule table, reward economics, abuse model, yêu cầu consent và accessibility, rollout theo phase, định nghĩa event, decision metric, harm guardrail, ownership và implementation dependency. Coi mọi target, schedule, case-study figure, prize amount, schema, endpoint và infrastructure value ví dụ trong reference đi kèm là minh họa cho đến khi được xác minh trong context của bạn.

Xử lý sự cố workflow

Triệu chứngBước tiếp theo an toàn
Thiết kế chứa nhiều mechanicGiảm xuống một behavior hypothesis và một hoặc hai mechanic cho phase đầu.
Engagement tăng cùng complaint hoặc compulsive useDừng mở rộng, review harm guardrail cùng participant research và bỏ mechanic gây cưỡng ép.
Reward vượt ngân sách đã modelDừng issuance hoặc rollout qua control path đã duyệt, đối chiếu liability và sửa cap cùng eligibility.
Leaderboard gây abuse hoặc lộ dữ liệuDùng private progress, cohort, team, alias, moderation và opt-out, hoặc bỏ leaderboard.
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

  • Skill không đảm bảo engagement, retention, conversion, revenue, ROI hay habit formation.
  • Số liệu case study và psychology claim trong package không phải bằng chứng độc lập hiện tại và chủ ý không được dùng làm performance promise ở đây.
  • Reference implementation bỏ qua nhiều yêu cầu production, gồm authorization, privacy deletion, financial control, concurrency, regional rule, observability và incident response.
  • Các package release được mô tả chứa nội dung, reference cùng cách gọi ak:gamification-marketing giống nhau.

Tiếp tục với ak:ab-test-setup cho mechanic experiment đã duyệt, hoặc xem Tổng quan Marketing Kit.