Tóm tắt nhanh / Lệnh

Bộ Engineer

Chỉ trên beta

/ak:page-builder

Page builder động

Gắn hoặc mở rộng page builder bằng stack của project, rồi vận hành draft, preview và publish. Không dùng để thiết kế trang một lần hay bọc API chung.

01

Khám phá host

02

Định nghĩa contract

03

Gắn editor

04

Mở giao diện

Nguyên tắc 01

Agent là người vận hành chính; người dùng chỉnh trang qua editor.

Nguyên tắc 02

Tái sử dụng stack host và owner trang hiện có; không tạo nguồn sự thật thứ hai.

Nguyên tắc 03

setup, update và operate là đối số skill, không phải subcommand CLI ak.

Nguyên tắc 04

Thiếu creator bắt buộc hoặc runtime không hỗ trợ là năng lực chưa đủ, đã nêu tên — không được coi là xong.

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 Khám phá host Xác định app, CMS/builder sẵn có, mô hình render, component, auth/storage và deployment từ project hiện tại trước khi chọn adapter.
  2. 2 Định nghĩa contract Định nghĩa registry block và contract trang đã serialize, gồm kích thước widget, rồi triển khai thao tác trang chung trên owner hiện có.
02

Xử lý

Agent / skill thực thi

  1. 3 Gắn editor Gắn editor dễ tiếp cận, responsive, dùng cảm ứng và vòng đời preview/publish vào các thao tác đó. Xác minh một block thật trước khi mở rộng.
  2. 4 Mở giao diện Mở API, CLI, MCP stdio/HTTP và WebMCP theo yêu cầu, kèm xuất SEO/Markdown và chuẩn bị deploy trong phạm vi.
03

Kiểm chứng

Gate, review, xác thực

  1. 5 Tạo skill operator Dùng ak-skill-creator đã cài để tạo hoặc cập nhật skill operator của project từ contract đang chạy. Bắt buộc khi setup và khi cập nhật contract.
  2. 6 Xác minh hành trình Hoàn thành hành trình đã chấp nhận, sửa chỗ fail, rồi báo artifact, giao diện đã test, path skill operator và phần chưa xác minh.

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:page-builder [setup|update|operate] [project-path] [request]

Đối số

[setup|update|operate]

Mode

Đối số skill; suy từ request nếu bỏ trống. Đối số ghi rõ thắng. Không phải subcommand CLI `ak`.

/ak:page-builder setup ./apps/storefront
[project-path]

Đường dẫn project

Path app host khi setup hoặc update. Bỏ trống nếu workspace hiện tại là host.

/ak:page-builder setup ./apps/storefront
[request]

Yêu cầu

Việc cần gắn, mở rộng hoặc vận hành. Với update/operate, chỉ đổi hành vi được yêu cầu.

/ak:page-builder operate Create a pricing draft and share its preview

Subcommand

setup Gắn mới
/ak:page-builder setup [project-path] [request]

Khám phá host, làm contract, editor, giao diện, skill operator và xác minh cho builder mới.

Kết quả:

/ak:page-builder setup ./apps/storefront
update Mở rộng có phạm vi
/ak:page-builder update [project-path] [request]

Đổi hành vi được yêu cầu và contract liên quan. Không dựng lại subsystem không liên quan.

Kết quả:

/ak:page-builder update Add the existing ProductGrid block with category bindings
operate Vận hành trang
/ak:page-builder operate [request]

Dùng skill operator của project nếu có; nếu chưa có thì vận hành tại đây rồi tạo skill đó sau khi xác minh contract.

Kết quả:

/ak:page-builder operate Create a pricing draft and share its preview

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ế.

Setup builder storefront Khuyến nghị
/ak:page-builder setup ./apps/storefront
Dùng khi:
Dùng khi project cần hệ thống ghép trang tái sử dụng trên stack sẵn có.
Kết quả:
Khám phá host, làm registry và thao tác trang, xác minh một block thật, mở giao diện được yêu cầu, rồi tạo skill operator của project.
Thêm block sẵn có
/ak:page-builder update Thêm block ProductGrid sẵn có kèm binding danh mục
Dùng khi:
Dùng khi mở rộng builder mà không dựng lại subsystem không liên quan.
Kết quả:
Đăng ký ProductGrid sẵn có kèm binding danh mục, cập nhật contract liên quan, và làm mới hướng dẫn skill operator cho block mới.
Vận hành bản nháp giá
/ak:page-builder operate Tạo bản nháp trang giá và chia sẻ preview
Dùng khi:
Dùng cho thay đổi trang thường ngày khi chưa có skill operator hoặc skill này phải tự vận hành builder.
Kết quả:
Tạo bản nháp trang giá đã lưu, chia sẻ preview sẵn có, và không nhận đã publish live trừ khi bước đó đã được xác minh.

Phạm vi xử lý

  • Khám phá host
  • Định nghĩa contract
  • Gắn editor
  • Mở giao diện
  • Tạo skill operator
  • Xác minh hành trình

Tiếp theo