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

Skill

Định tuyến visual deliverable với ak:design

Biến brand hoặc campaign brief thành đúng workflow cho logo, CIP, slide, banner, social image, icon hay poster.

Dùng ak:design khi outcome là visual cho brand hoặc campaign và bạn muốn một điểm vào để chọn đúng production route. Skill chứa workflow cùng knowledge đi kèm cho logo, CIP mockup, slide, banner, social image, icon và poster, đồng thời có thể phối hợp các Marketing Skill liên quan cho brand và token.

Chọn ak:design cho visual deliverable

Dùng ak:design khi

  • Deliverable là logo concept, CIP mockup, presentation, banner, social image, SVG icon, poster hoặc tổ hợp có phạm vi rõ của các loại này.
  • Bạn muốn workflow phân loại request trước khi chọn tool hay tệp.
  • Bạn có brand input, kích thước channel, copy và ranh giới phê duyệt.

Chọn workflow khác khi

Chuẩn bị brief và runtime

Cung cấp artifact đích, audience, channel, kích thước hoặc aspect ratio chính xác, copy đã duyệt, brand source, output format, ranh giới tệp và việc có cho phép external research hay generation không. Xác nhận bạn có quyền với mọi logo, ảnh, font và reference được cung cấp.

RuntimeCách gọiRanh giới khả dụng
Claude Code/ak:design ...Phân phối native là mặc định; plugin là lựa chọn rõ ràng. Asset tool, browser capture và provider call thực tế phụ thuộc session.
Cursor/ak:design ...Cách gọi bằng slash đã được người dùng xác minh, nhưng không đảm bảo tool hay automation giống nhau.
Codex$ak:design ...Có hỗ trợ native Skill discovery; projection component vẫn phụ thuộc từng capability.

Hoàn thành Làm quen và đọc Runtime adapter trước lần chạy đầu.

Chạy Skill

/ak:design Create three launch-poster directions for the supplied event brief and brand guide. Produce reviewable prompts and layout specs only. Do not generate images, browse, write files, or publish

Sau khi chọn direction, chỉ cấp quyền cho route và output cần thiết. Ví dụ, yêu cầu hai HTML banner source đúng kích thước cùng PNG export trong thư mục đã nêu, nhưng giữ upload và publication ngoài scope.

Hiểu các giai đoạn

  1. Phân loại deliverable. Skill định tuyến logo, CIP, slide, banner, social image, icon hoặc poster thay vì áp dụng một quy trình chung.
  2. Xác nhận input. Skill thu thập brand rule, copy, kích thước, format, quyền asset, reference và ranh giới giữa guidance với production.
  3. Phát triển direction. Route đã chọn dùng bảng và reference liên quan đi kèm để tạo concept, prompt, layout decision hoặc token choice.
  4. Review trước mutation. Bạn chọn direction và duyệt riêng file write, provider call, browser capture hay Skill phụ thuộc.
  5. Tạo artifact đã duyệt. Tùy route, output có thể gồm SVG, PNG, HTML/CSS, prompt, brief hoặc presentation file.
  6. Xác minh và báo cáo. Workflow kiểm tra kích thước, rendering, copy, contrast, brand consistency cùng đường dẫn tệp rồi báo cáo rủi ro còn lại.

Giữ ảnh hưởng bên ngoài dưới quyền kiểm soát

Định tuyến không cấp quyền cho mọi production tool

Một số route có thể gọi image provider, browse reference, load hosted font hay library hoặc capture HTML trong browser. Các thao tác này có thể gửi input ra ngoài project, dùng credential, phát sinh chi phí hoặc phụ thuộc behavior provider hiện tại. Hãy duyệt riêng từng ảnh hưởng.

Đừng coi Skill là quyền sửa source file, cài package, rebuild knowledge đi kèm, liên hệ platform, upload asset, mua media, publish, commit hay deploy. Không đưa claim và metric được tạo vào visual copy nếu không có nguồn đã duyệt.

Xác minh output và bằng chứng

Một lần chạy hoàn tất nên nêu route đã chọn, input đã duyệt, tệp được tạo hoặc sửa, kích thước chính xác, provider hay capture operation đã chạy và visual QA đã dùng. Review chính tả, brand mark, responsive crop, contrast, safe zone, accessible alternative và việc có editable source hay không.

Với route HTML/CSS-to-image, kiểm tra cả source lẫn pixel export. Với image hoặc SVG do model tạo, kiểm tra artifact thực tế thay vì coi prompt hay model response là bằng chứng.

Xử lý sự cố hoặc tiếp tục

Triệu chứngBước tiếp theo an toàn
Runtime không nhận diện ak:designXác nhận target cùng scope, mở lại runtime, rồi dùng Runtime không tìm thấy Skill hoặc Agent.
Skill chọn sai routeNêu lại artifact cuối, format, kích thước và code có thuộc deliverable không.
Brand guidance xung đột với style đi kèmCoi brand source đã duyệt là authority và ghi lại deviation.
External tool không khả dụngGiữ brief, prompt hoặc HTML source và báo cáo bằng chứng generation hay capture còn thiếu.
Kích thước export hoặc typography saiSửa source, load asset cần thiết, export lại rồi kiểm tra trực quan lần nữa.
Có đề xuất thêm tệp hoặc provider callDừng và thu hẹp route, thư mục, số lượng cùng ranh giới quyền đã duyệt.

Tiếp tục với Tổng quan Marketing Kit hoặc xem Projects, artifacts và checkpoints trước khi khôi phục.

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

  • Stable và beta chứa nội dung ak:design byte-identical trong các release đã kiểm tra.
  • Style, kích thước, palette, formula và reference data đi kèm là điểm bắt đầu. Hãy xác minh specification platform hiện tại cùng brand source thực tế.
  • Một số reference có wording lịch sử về provider, model, giá, performance và platform. Trang này không đảm bảo các claim đó.
  • Route poster tạo prompt trước mọi image-model call riêng; prompt không phải poster hoàn tất. Route social và banner cũng cần render thành công cùng visual QA trước khi export hoàn tất.
  • Trang Marketing này mô tả toàn bộ Skill field của Marketing. Trang không nhập outcome semantics từ trang Engineer có Skill cùng tên.