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

Skill

Khám phá hướng logo với ak:logo-design

Xây logo brief, tìm hướng dẫn style trong package, tạo raster variant qua Gemini và tách riêng quyết định trademark, identity, vector production cùng launch.

Dùng ak:logo-design để nghiên cứu logo style, color và pattern theo industry, biến brand brief đã duyệt thành image-generation prompt và tạo một hoặc nhiều concept PNG qua Gemini. Skill hỗ trợ exploration và review; không thực hiện trademark clearance, tạo identity system hoàn chỉnh, cung cấp vector master cho production, đăng ký mark hay launch logo mới.

Chọn ak:logo-design để phát triển concept

Dùng ak:logo-design khi

  • Bạn cần logo concept, đề xuất style, hướng color hoặc design brief theo industry.
  • Bạn biết brand name, audience, positioning, attribute mong muốn và constraint quan trọng.
  • Bạn muốn tìm catalog style, color và industry trong package trước khi tạo raster variant.
  • Bạn có thể review distinctiveness, độ chính xác text, scalability, accessibility, quyền source và mức phù hợp thương hiệu cùng stakeholder.

Chọn workflow khác khi

  • Bạn cần brand system đầy đủ, quyết định naming hoặc positioning trước visual exploration. Bắt đầu với workflow Marketing brand phù hợp.
  • Bạn cần campaign banner thay vì identity mark có thể tái sử dụng. Dùng ak:banner-design.
  • Bạn cần trademark clearance, tư vấn pháp lý, registration, vector cleanup, print preflight hoặc production file. Chuyển concept đã chọn cho owner pháp lý và design production phù hợp.
  • Bạn định bắt chước mark hiện có, nhân vật được bảo hộ hoặc tác phẩm dễ nhận biết của nghệ sĩ còn sống khi chưa có quyền.

Chuẩn bị brand brief và provider

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

  • Hoàn thành Làm quen và xác nhận Marketing Kit đã được cài cho runtime cùng scope hiện tại.
  • Cung cấp brand name, positioning, audience, industry, personality mong muốn, symbol cần có hoặc tránh, constraint color cùng competitor hay mark không được gây nhầm lẫn.
  • Quyết định bạn chỉ cần research và brief, một PNG hay batch variant có scope.
  • Cung cấp GEMINI_API_KEY, cài google-genai và chỉ cho phép network provider khi image generation đã được duyệt.
  • Chọn output directory bạn kiểm soát và nêu tệp hiện có có thể bị thay hay không.
  • Lập bước review trademark và similarity riêng trước public adoption. Local catalog search không phải clearance search.
RuntimeCách gọiRanh giới khả dụng
Claude Code/ak:logo-design ...Phân phối native là mặc định; phân phối plugin rõ ràng cũng được hỗ trợ. Generation vẫn phụ thuộc credential Gemini cục bộ và tính khả dụng provider.
Cursor/ak:logo-design ...Cách gọi bằng slash đã được người dùng xác minh. Image display và tool HTML preview tùy chọn có thể khác theo thiết lập.
Codex$ak:logo-design ...Skill dùng discovery native của Codex. Hook projection một phần không cung cấp legal clearance hay provider access.

Xem Runtime adapter để hiểu khác biệt ở mức component.

Chạy Skill

Nêu brand, attribute, style hoặc industry, quantity, ranh giới output và phần phải để lại cho quyết định sau.

/ak:logo-design Tạo ba concept direction cho "Northstar Ledger", sản phẩm analytics ưu tiên privacy. Khám phá style minimalist, geometric và negative-space với palette xanh dịu. Nền trắng, không sao chép mark, chỉ tạo bản nháp PNG; không thay logo hiện tại hay publish

Dùng control research và generator trong package

Helper tìm kiếm cục bộ nhận query và có thể thu hẹp --domain thành style, color hoặc industry. Helper cũng hỗ trợ --max-results, --json, --design-brief--brand-name/-p.

Khi generation được duyệt, generator Python đi kèm expose:

ControlMục đích
--prompt, -pMô tả logo
--brand, -bBrand name
--style, -sMột style được generator hỗ trợ
--industry, -iMột industry được generator hỗ trợ
--output, -oOutput path cho một PNG
--batch--output-dirSố variant và đích batch
--brand-contextContext prompt bổ sung trong batch mode
--proYêu cầu image model Pro trong package thay cho model họ Flash mặc định
--aspect-ratio, -r1:1, 16:9, 9:16, 4:3 hoặc 3:4; mặc định là 1:1
--list-styles, --list-industriesIn các lựa chọn được generator chấp nhận mà không generation

Nếu không có --output, ảnh đơn dùng tên như {brand_slug}_{timestamp}.png trong working directory. Batch mode mặc định vào ./{brand_name}_logos và ghi tên như {brand_name}_minimalist_01.png.

Theo các giai đoạn concept

  1. Xác nhận brief. Skill ghi brand, audience, positioning, industry, personality, motif mong muốn và bị cấm, color, nhu cầu wordmark, quantity, quyền cùng authority.
  2. Tìm hướng dẫn trong package. Skill có thể query catalog CSV cục bộ để lấy row style, color và industry liên quan rồi biến kết quả thành design brief.
  3. Chọn direction. Review concept và prompt được đề xuất trước khi tiêu quota provider. Loại direction gây nhầm lẫn, derivative, không an toàn về văn hóa hoặc không đúng brand.
  4. Tạo variant đã duyệt. Gemini nhận prompt và ghi output PNG raster. Instruction trong package yêu cầu nền trắng.
  5. Review ở nhiều kích thước. Kiểm tra silhouette, text và spelling, contrast, color, behavior grayscale, nhận diện ở kích thước nhỏ, symbol ngoài ý muốn và similarity với mark đã biết.
  6. Dừng trước adoption. HTML preview là tùy chọn và chỉ nên được tạo sau khi bạn duyệt artifact cục bộ bổ sung đó. Replacement, registration, launch, publication và production conversion vẫn là công việc riêng.

Tách quyết định pháp lý, provider và launch

Generation không phải trademark clearance

Output trông khác biệt vẫn có thể xung đột với mark hiện có hoặc chứa material được bảo hộ. Thực hiện review similarity, trademark, văn hóa và jurisdiction bởi người đủ chuyên môn trước adoption hay registration.

Nhóm công việcRanh giới thông thường
Hướng dẫn và soạn nhápCatalog search, design brief, prompt writing và review criteria có thể hoàn tất mà không có generation request.
Thay đổi cục bộGeneration tạo tệp PNG; preview tùy chọn đã duyệt có thể thêm HTML gallery. Xác nhận path trước khi ghi hoặc thay tệp.
Tác động provider và chi phíMỗi variant và retry gửi prompt tới Gemini, tiêu quota và có thể phát sinh chi phí hoặc bị safety policy provider chặn.
Tác động brand và pháp lýSkill không cấp quyền trademark filing, legal clearance, assignment quyền hay adoption làm identity chính thức.
Tác động publish và tài khoảnSkill không thay logo hiện tại, cập nhật profile hay product, publish asset, đặt print material hoặc thông báo stakeholder.

Chỉ dùng name, source image, font, symbol và reference bạn có quyền sử dụng. Tránh deceptive similarity, certification mark giả, stereotype có hại và claim concept là unique hay legally available khi chưa có bằng chứng.

Review output và bằng chứng

Với mỗi concept, hãy giữ:

  • Brief đã duyệt, search query, catalog row đã dùng, prompt, style, industry, aspect ratio, model request và output path.
  • Provider success hoặc failure cùng tệp PNG chính xác thực sự được tạo.
  • Visual review ở kích thước đầy đủ, nhỏ, monochrome và high-contrast.
  • Check text và spelling, quyền source, potential similarity, cultural review và câu hỏi pháp lý còn mở.
  • Shortlist đã chọn cùng mọi hành động vector production, trademark, replacement, launch và publish còn chờ.

Raster output nên được coi là bằng chứng concept. Production handoff có thể cần redraw, typography licensing, spacing rule, color definition, vector master, monochrome variant, responsive mark và usage guide.

Xử lý sự cố an toàn

Triệu chứngBước tiếp theo an toàn
Runtime không tìm thấy ak:logo-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.
Local search không trả rowMở rộng query hoặc chọn rõ style, color hay industry; không bịa catalog evidence.
Xuất hiện google-genai package not installedCài package trong môi trường Python đã duyệt, rồi chỉ chạy lại generation dự kiến.
Xuất hiện GEMINI_API_KEY not setCấu hình key qua cơ chế secret đã duyệt; không bao giờ dán hoặc commit key.
Không có ảnh được tạoGiữ brief cùng provider error, sau đó sửa prompt hoặc hoãn generation mà không tuyên bố tệp tồn tại.
Brand text sai hoặc méoTừ chối ảnh. Không dùng raster correction làm bằng chứng của wordmark hoàn chỉnh khi chưa review.
Concept giống mark khácLoại khỏi shortlist và escalate cho review brand cùng pháp lý đủ chuyên môn.
Batch output ít hơn yêu cầuReview danh sách style có giới hạn của generator cùng từng request lỗi trước khi retry hay đổi quantity.

Tiếp tục với Tổng quan Marketing Kit hoặc Projects, artifacts và checkpoints.

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

  • Knowledge catalog trong package rộng hơn generator flag. Generator hiện tại expose 18 lựa chọn style và 10 lựa chọn industry; catalog recommendation không tự động là --style hay --industry được chấp nhận.
  • Batch generation bị giới hạn bởi danh sách cố định gồm chín style và hiện truyền industry="tech" nội bộ. Không dùng batch output làm bằng chứng về prompt riêng theo industry cho brief không thuộc tech; ưu tiên single generation có chủ đích hoặc sửa workflow trước khi dùng.
  • Generator tạo concept PNG raster, không tạo SVG, EPS, PDF, font file, trademark evidence hay brand guideline hoàn chỉnh.
  • Prompt yêu cầu behavior nền trắng hoặc transparent, trong khi instruction của Skill yêu cầu nền trắng. Kiểm tra pixel thực tế; không giả định background transparency hay isolation sẵn sàng cho production.
  • Model ID, safety filter, quota, giá, resolution, text rendering và tính khả dụng provider có thể thay đổi ngoài AgentKit.
  • Concept được tạo không đảm bảo originality, registrability, legal clearance, brand recognition, conversion, revenue hay stakeholder approval.