Tóm tắt nhanh:
ak-shopifylàm app, extension, theme cho Shopify, gọi GraphQL Admin API, nhận webhook và tính tiền cho app. Nó xác định loại việc, đọc bản CLI và API version đang cấu hình, chỉ mở tài liệu của đúng loại đó rồi thử trên store dev hoặc theme xem trước. Nó không tự đưa lên store thật khi bạn chưa chỉ rõ store, theme và cho phép, và không chuyển sang skill nào khác.
Công khai: mình là maintainer của AgentKit và có quan hệ affiliate: link AgentKit trong bài là link affiliate, mua qua link này bạn được giảm 30%.
Tóm tắt
Dùng khi bạn cần thêm extension ở checkout, sửa theme, nhận webhook đơn hàng, thêm gói thuê bao cho app hoặc đồng bộ nhiều dữ liệu qua Admin API. Chỉ đổi giao diện storefront thì nói rõ là theme: skill sửa Liquid, không dựng app mới.
flowchart LR
A["Việc Shopify: app, extension, theme, API"] --> B["ak-shopify"]
B --> C["Code chạy được trên store dev hoặc theme xem trước"]
C --> D["Dừng, không chuyển skill nào"]Nó dựa trên 4 ý:
| Ý | Câu hỏi | Ví dụ |
|---|---|---|
| Loại việc | Việc này là app, extension hay theme? | Ô "Lời nhắn quà tặng" ở checkout là extension; đổi bố cục trang sản phẩm là theme |
| Phiên bản đang dùng | Project dùng bản CLI nào, API version nào? | Project ghi api_version = "2025-10" thì truy vấn và extension viết theo bản đó |
| Hàng rào an toàn | Những gì không được nới lỏng dù code chạy? | Scope tối thiểu, kiểm HMAC webhook, server giữ trạng thái thanh toán, xử lý lặp lại an toàn |
| Xem trước khác lên live | Thử xong đã lên store thật chưa? | shopify theme dev chỉ là bản xem trước; lên live cần đúng store, theme và sự cho phép |
API Shopify ra bản mới mỗi quý và mỗi bản được hỗ trợ 12 tháng, nên công thức trong tài liệu của skill có thể cũ hơn project. Skill đối chiếu với bản thật và tài liệu chính thức.
Prompt mẫu cho extension ở checkout:
/ak-shopify checkout Thêm ô "Lời nhắn quà tặng" vào checkout của app <tên app>.
Ràng buộc: dùng API version đang cấu hình trong project, không xin thêm scope.
Xong khi: ô hiện ở checkout trên store dev <tên store dev>, lời nhắn lưu vào đơn hàng.Skill này không có cờ. Sau tên skill bạn có thể ghi loại extension rồi tính năng, ví dụ checkout gift message. Cả hai phần đều tuỳ chọn.
Phần dưới đây là bản chi tiết: luồng chạy, 5 tình huống kèm prompt, cách ghi đầu vào, lịch sử thay đổi theo bản ak và các lỗi hay vấp. Bản chi tiết và trang trực quan dành cho subscriber. Agent của bạn cũng tìm được trong đó qua MCP của portal.
Mở khi tài khoản có quyền subscriber
Bài này dành cho subscriber
Khi tài khoản có quyền, toàn bộ bài, bản visual tương tác và lệnh gọi từ agent đều mở.
- Đăng nhập hoặc tạo tài khoản modernEngineerQuyền đọc gắn với email tài khoản.
- Chọn gói trên trang Bảng giáGói 1, 3 hoặc 12 tháng, trả bằng chuyển khoản VietQR. Quyền đọc mở khoảng một phút sau khi tiền về.
- Hoặc nhập mã Facebook subscriberNgười ủng hộ trang qua Facebook nhận mã kích hoạt qua tin nhắn mỗi tháng.
Đã là subscriber? Đăng nhập để đọc.
Dùng bài này trong agent của bạn
Lấy API keyChép đoạn dưới, dán vào Claude Code, Codex hay agent bạn đang dùng. Agent đọc bài rồi đối chiếu với repo đang mở.
Đọc bài "ak-shopify: làm app, extension, theme Shopify theo đúng bản đang dùng" trên modernEngineer rồi áp dụng vào repo này.
1. Gọi tool content_get của MCP server modernengineer với locale "vi", slug "ak-shopify". Nếu chưa nối MCP server modernengineer, dừng lại và hướng dẫn tôi nối theo https://modernengineer.dev/vi/mcp.
2. Tóm tắt các bước chính của bài, chỉ ra bước nào áp dụng được cho repo này.
3. Đề xuất thay đổi cụ thể và hỏi tôi trước khi sửa file.Nối MCP cho Claude Code (một lần)
claude mcp add --transport http modernengineer \
https://api.modernengineer.dev/mcp \
--header "Authorization: Bearer <API key>"Đọc trọn bài qua MCP cần API key của tài khoản subscriber hoặc đã mua guide này. Không có quyền, agent sẽ chỉ đọc được phần mở đầu.
- Phiên bản
- v1.0.0
- Cập nhật
- 22/10/2026
- Giấy phép
- Bảo lưu mọi quyền
- Slug
- ak-shopify
