Tóm tắt nhanh / Lệnh

Bộ Engineer

/ak:shopify

Phát triển Shopify

Hướng dẫn xây app, extension, theme, API, Polaris, Liquid, checkout, webhook và billing cho Shopify bằng quy trình xoay quanh Shopify CLI.

01

Chọn bề mặt

02

Chuẩn bị CLI

03

Khởi tạo dự án

04

Thêm điểm mở rộng

Nguyên tắc 01

Chọn đúng bề mặt Shopify trước khi viết mã

Nguyên tắc 02

Ưu tiên GraphQL Admin API thay cho REST cho phần mới

Nguyên tắc 03

Chỉ xin scope và trường dữ liệu mà tính năng thật sự cần

Nguyên tắc 04

Dùng development store và bằng chứng từ Partner Dashboard trước khi deploy

Bản đồ thực thi

Các nhánh chính từ đầu vào đến kết quả, bám theo cách command chạy khi dùng thật.

01

Khởi động

Đầu vào, phạm vi, route

  1. 1 Chọn bề mặt Xác định người dùng cần app, extension, theme hay mô hình kết hợp app với theme extension.
  2. 2 Chuẩn bị CLI Cài hoặc kiểm tra Shopify CLI trước khi tạo app, extension, theme hoặc deploy.
02

Xử lý

Agent / skill thực thi

  1. 3 Khởi tạo dự án Dùng shopify app init hoặc shopify theme init, rồi cấu hình scope, lựa chọn theme và bối cảnh dev cục bộ.
  2. 4 Thêm điểm mở rộng Tạo phần mở rộng checkout, admin, POS, customer account, function hoặc theme app extension theo nhu cầu.
03

Kiểm chứng

Gate, review, xác thực

  1. 5 Áp dụng mẫu nền tảng Ưu tiên GraphQL Admin API, Polaris UI, Liquid section, phân trang, xử lý rate limit và scope truy cập tối thiểu.
  2. 6 Bảo mật tích hợp Giữ credential trong biến môi trường, xác thực chữ ký webhook, dùng OAuth/session token và kiểm tra yêu cầu GDPR.
04

Đóng

Báo cáo, bàn giao, artifact

  1. 7 Kiểm thử store Dùng development store, nhiều gói store, kiểm tra responsive trên mobile, accessibility và việc extension có hiển thị đúng.
  2. 8 Deploy an toàn Chỉ chạy app deploy hoặc theme push/publish sau khi đã xem local preview và kiểm tra tương thích phiên bản.

Cú pháp, đối số, subcommand

Cách gọi skill: cú pháp, đối số vị trí, option dùng chung, rồi từng subcommand với cú pháp và kết quả riêng.

Cú pháp

/ak:shopify [extension-type] [feature]

Đối số

[extension-type]

Bề mặt Shopify

Bề mặt hoặc loại extension đích, như app, checkout_ui_extension, admin_action, admin_block, pos_ui_extension, function, theme hoặc mục tiêu Shopify cụ thể hơn. Đối số này chọn workflow; nó không cấp quyền sync store, deploy, push hoặc publish.

/ak:shopify checkout_ui_extension "Add an optional gift message to the existing app"
[feature] Bắt buộc

Brief tính năng

Outcome cho merchant hoặc người mua cùng ràng buộc: file app hoặc theme hiện có, phiên bản CLI và API đã pin, ranh giới store, scope, webhook, billing, privacy, nhu cầu lưu dữ liệu, test và quyền rõ ràng cho mọi remote mutation. Không đưa secret vào prompt.

/ak:shopify theme "Customize the product page in the current Liquid theme without pushing or publishing"

Đừng bỏ qua bước bắt buộc

Mỗi mục đối chiếu một lối tắt dễ mắc với cách làm đúng mà skill yêu cầu.

Lối tắt dễ mắc

Dùng REST cho nhanh cũng được.

Cách làm đúng

Phần dữ liệu Shopify mới nên ưu tiên GraphQL Admin API và chỉ lấy các trường cần thiết.

Lối tắt dễ mắc

Xin token rộng sẽ đỡ lỗi quyền.

Cách làm đúng

Skill yêu cầu scope tối thiểu, credential trong biến môi trường, OAuth/session token và xác thực chữ ký webhook.

Prompt mẫu

Ví dụ gọi command theo từng flag, subcommand, mode hoặc route dùng được trong workflow thực tế.

Extension Checkout UI Khuyến nghị
/ak:shopify checkout_ui_extension gift message field
Dùng khi:
Tùy biến luồng checkout bằng Shopify checkout extension.
Kết quả:
Hướng dẫn tạo extension bằng Shopify CLI, triển khai React checkout UI, kiểm thử bằng app dev, kiểm tra target và app deploy.
App merchant có billing
/ak:shopify app product sync with billing
Dùng khi:
Xây app cho merchant cần truy cập dữ liệu store và thu phí chức năng.
Kết quả:
Bao gồm app init, access scope trong shopify.app.toml, truy vấn GraphQL Admin API, OAuth, billing, webhook và xử lý credential.
Tùy biến theme Liquid
/ak:shopify theme product page customization
Dùng khi:
Thiết kế storefront riêng hoặc đổi trang sản phẩm thuộc về Shopify theme.
Kết quả:
Dùng quy trình theme init/dev/pull/push, mẫu sản phẩm Liquid, local preview, tối ưu ảnh, accessibility và bước publish an toàn.
Extension Function
/ak:shopify function delivery rule
Dùng khi:
Triển khai rule discount, payment, delivery hoặc validation bằng Shopify Function.
Kết quả:
Chọn hướng function extension, chạy tạo bằng Shopify CLI, giữ vòng lặp app dev/deploy và áp dụng kiểm thử cùng kiểm tra troubleshooting.

Phạm vi xử lý

  • Shopify CLI
  • Admin GraphQL
  • extension checkout
  • theme Liquid
  • Polaris UI
  • webhook và billing

Tiếp theo