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

Skill

Tạo mockup nhận diện doanh nghiệp với ak:cip-design

Biến đầu vào thương hiệu đã duyệt thành CIP brief, các mockup nhận diện đã chọn và presentation HTML tùy chọn để review.

Dùng ak:cip-design để lập kế hoạch cách một identity đã duyệt xuất hiện trên stationery, signage, apparel, vehicle, packaging, digital asset và các touchpoint thương hiệu khác. Skill có thể tìm kiếm trong knowledge CIP đi kèm, chuẩn bị brief, tạo các ảnh mockup đã chọn qua Gemini và ghép kết quả PNG thành một presentation HTML duy nhất.

Chọn ak:cip-design cho ứng dụng thương hiệu

Dùng ak:cip-design khi

  • Bạn có tên thương hiệu, bối cảnh audience hoặc industry và hướng identity đã xác định.
  • Bạn cần CIP brief hoặc hướng dẫn cho những deliverable nhận diện cụ thể.
  • Bạn muốn mockup áp dụng logo đã duyệt lên các touchpoint đã chọn.
  • Bạn muốn một artifact để review trước khi đặt làm tệp production-ready.

Chọn workflow khác khi

  • Logo hoặc định hướng thương hiệu rộng hơn chưa được duyệt. Hãy xác lập source of truth đó trước khi áp dụng trên toàn CIP.
  • Bạn cần visual asset rộng hơn như poster, slide deck, banner hoặc icon. Bắt đầu với ak:design.
  • Bạn cần interface token dùng lại được hoặc component specification. Dùng ak:design-system.
  • Bạn cần frontend code hoạt động thay vì mockup nhận diện. Dùng ak:frontend-design.

Mockup được tạo là tài liệu hỗ trợ review, không phải artwork sẵn sàng in, fabrication drawing, chứng nhận accessibility, xác minh trademark hay bằng chứng logo được tái tạo chính xác.

Chuẩn bị đầu vào thương hiệu và runtime

Trước khi bắt đầu:

  • Hoàn thành Làm quen và xác nhận Marketing Kit đã được cài cho đúng runtime cùng scope đang dùng.
  • Cung cấp tên thương hiệu đã duyệt, bối cảnh industry, style mong muốn và các deliverable chính xác. Thêm kích thước hoặc constraint sản xuất nếu đã biết.
  • Chỉ cung cấp tệp logo khi bạn có quyền sử dụng và được phép gửi nó tới image provider đã chọn.
  • Quyết định lần chạy chỉ đưa guidance, chỉ tạo prompt, tạo ảnh, hay tạo ảnh kèm presentation HTML.
  • Nêu output directory bạn kiểm soát trước khi cho workflow ghi ảnh hoặc HTML.
RuntimeCách gọiRanh giới khả dụng
Claude Code/ak:cip-design ...Phân phối native là mặc định; phân phối plugin rõ ràng cũng được hỗ trợ. Provider call và thao tác ghi tệp vẫn phụ thuộc tool, credential hiện có cùng phê duyệt của bạn.
Cursor/ak:cip-design ...Cách gọi bằng slash đã được người dùng xác minh. Điều này không chứng minh provider, Agent hay Hook hoạt động giống nhau trên mọi thiết lập Cursor.
Codex$ak:cip-design ...Skill dùng cơ chế discovery native của Codex. Automation theo runtime chỉ được chuyển khi có hỗ trợ.

Xem Runtime adapter trước khi giả định parity ở cấp component.

Chạy Skill

Bắt đầu bằng brief có phạm vi rõ và để generation ngoài lượt đầu:

/ak:cip-design Create a CIP brief for Northstar, a B2B logistics brand. Cover business card, letterhead, reception signage, and vehicle branding. Use the supplied brand guide only. Do not call an image provider or write files yet

Sau khi duyệt brief, hãy nêu rõ ranh giới mutation và provider:

/ak:cip-design Generate only the approved business-card and reception-signage mockups with ./brand/northstar-logo.png. Write PNG files to ./output/northstar-cip. Stop before creating a presentation

Dùng cùng nội dung với $ak:cip-design trong Codex. Tùy chọn --prompt-only của helper đi kèm tránh provider call và thao tác ghi ảnh. --logo chọn đầu vào image-editing, --output chọn thư mục ảnh và --no-logo-prompt cho phép rõ ràng provider tự diễn giải logo. Đây là tùy chọn của helper script, không phải flag của cách gọi Skill.

Hiểu các giai đoạn

  1. Xác nhận application brief. Workflow ghi lại brand, industry, style, deliverable, kích thước, nguồn logo, ranh giới output và trạng thái phê duyệt.
  2. Tìm trong dữ liệu CIP đi kèm. Các bảng local cung cấp candidate về deliverable, style guidance, industry guidance, mockup context và thành phần prompt.
  3. Review brief. Bạn xác minh độ chính xác thương hiệu, phần loại trừ, constraint sản xuất và việc có cho phép dùng provider hay không.
  4. Tạo mockup đã duyệt. Nếu được cấp quyền, helper gửi prompt cùng ảnh logo tùy chọn tới Gemini và ghi tệp PNG có timestamp. Một set nhiều item mặc định gồm business card, letterhead, office signage, vehicle và polo shirt, trừ khi request đưa danh sách hẹp hơn.
  5. Render presentation tùy chọn. Renderer đọc các tệp PNG trong thư mục đã chọn và ghi một tệp HTML responsive, giao diện dark, nhúng ảnh base64.
  6. Review artifact. Bạn so sánh mọi kết quả với logo nguồn, brand rule, kích thước thực, yêu cầu legibility và constraint sản xuất.

Tách riêng phê duyệt và ảnh hưởng từ provider

Yêu cầu mockup có thể vượt ranh giới provider

Image generation cần Gemini API credential hiện hành và các Python dependency đi kèm. Thao tác này gửi nội dung prompt và, khi được cung cấp, ảnh logo tới provider đó. Availability, điều khoản, behavior của model, network access và chi phí có thể thay đổi. Hãy duyệt provider call riêng với việc duyệt CIP brief.

Skill không cấp quyền:

  • Upload logo confidential hoặc chưa được cấp phép, customer data hay identity material chưa phát hành.
  • Tạo mọi item trong default set khi chỉ một deliverable được duyệt.
  • Coi text, kích thước, màu, finish hoặc logo placement được tạo là production truth khi chưa review.
  • Gửi tệp tới printer, manufacturer, social platform, ad platform hay điểm đến bên ngoài khác.
  • Commit, publish hoặc deploy output.

Khi logo transparent hoặc palette được load, generator đi kèm chuyển nó sang RGB và đặt phần transparency lên nền trắng trước provider call. Hãy review bước chuyển đổi nếu transparency hoặc background treatment là quan trọng.

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

Một lần chạy hoàn tất nên cung cấp:

  • CIP brief đã duyệt và các lựa chọn dữ liệu đi kèm dùng để tạo brief.
  • Provider command chính xác hoặc bằng chứng prompt-only, gồm deliverable đã chọn, tùy chọn model, aspect ratio, đường dẫn logo và output directory.
  • Đường dẫn các tệp PNG thực sự được tạo, đồng thời giữ lỗi hiển thị.
  • Đường dẫn presentation HTML khi render đã được duyệt.
  • Tóm tắt review bao quát logo fidelity, chính tả, contrast, safe placement, behavior responsive của presentation và câu hỏi sản xuất chưa giải quyết.

Đừng chấp nhận ảnh chỉ vì prompt yêu cầu logo chính xác hoặc resolution cụ thể. Hãy kiểm tra pixel đã render và xác minh mọi text hiển thị.

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:cip-designXác nhận target cùng scope, mở session mới, rồi làm theo Runtime không tìm thấy Skill hoặc Agent.
Brief trả về local match yếu hoặc không cóDùng từ rõ hơn về industry, style, deliverable hoặc mockup. Coi guidance fallback là đề xuất, không phải bằng chứng.
Không load được logoKiểm tra đường dẫn rõ ràng và tệp ảnh được hỗ trợ, rồi dừng thay vì âm thầm chấp nhận logo khác.
Thiếu provider credential hoặc dependencyGiữ lại brief hoặc dùng output prompt-only. Không dán secret vào prompt hay commit secret vào project.
Text hoặc chi tiết logo được tạo bị saiTừ chối ảnh, thu hẹp deliverable cùng prompt hoặc dừng. Không sửa asset regulated hay production bằng giả định.
Presentation HTML trốngXác nhận thư mục ảnh đã chọn tồn tại và chứa tệp PNG trước khi render.
Tệp xuất hiện sai thư mụcDừng, kiểm tra đường dẫn được báo cáo và chỉ move hoặc tạo lại sau khi xác nhận ownership.

Tiếp tục với Tổng quan Marketing Kit, so sánh Runtime adapter, 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 Skill ak:cip-design byte-identical trong các release đã kiểm tra.
  • Các bảng và guide đi kèm là tài liệu tham khảo, không phải authority hiện hành về platform, pháp lý, fabrication, accessibility hay thương hiệu.
  • Tên provider và wording về model trong source đi kèm là bằng chứng release lịch sử. Không có đảm bảo về availability, chất lượng, resolution, latency hay giá hiện tại.
  • Phần tổng quan source và generator đi kèm không thống nhất về một default flash2 bổ sung; parser được expose chỉ nhận flashpro, mặc định là flash. Trang này theo parser thực thi và không đưa ra claim chất lượng cho tùy chọn nào.
  • Renderer mô tả các category filename đã biết bằng copy tích hợp và dùng copy chung cho tên chưa biết. Hãy review mọi description trước khi chia sẻ.