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

Skill

Tạo creative direction brief với ak:creativity

Dùng hướng dẫn đi kèm về style, platform, voiceover, music và campaign để soạn creative direction có thể review mà không generate hay publish asset.

Dùng ak:creativity để biến brief về campaign, audience, industry và channel thành các lựa chọn creative direction. Skill tìm trong dataset local đi kèm về visual style, platform format, voiceover, music và campaign reasoning, sau đó kết hợp kết quả thành draft brief để con người review.

Skill tạo direction và recommendation. Nó không generate image, video, audio, copy, media placement hay campaign đã publish.

Chọn ak:creativity cho direction

Dùng ak:creativity khi

  • Bạn cần direction nhất quán trước khi đặt làm hoặc generate asset.
  • Bạn muốn so sánh lựa chọn về visual style, platform, voiceover, music và anti-pattern trong một brief.
  • Creative team cần draft tách rõ audience, objective, style, format, audio và quyết định approval.
  • Bạn muốn search local lặp lại được trên creative dataset trong package mà không liên hệ provider.

Chọn workflow khác khi

  • Bạn cần tệp image, video, voice, music hay copy hoàn chỉnh. Dùng production Skill phù hợp sau khi direction được duyệt.
  • Bạn cần platform spec, trend data, licensing term, legal clearance hoặc accessibility validation hiện tại. Xác minh với nguồn chính hiện tại và reviewer phù hợp.
  • Bạn cần brand positioning hay audience evidence thay vì creative expression. Hãy giải quyết research và brand brief trước.
  • Bạn muốn bảo đảm performance, revenue, conversion, recall hay cost. Các recommendation đi kèm không hỗ trợ những promise đó.

Chuẩn bị brief sẵn sàng cho quyết định

Trước khi chạy Skill, hãy cung cấp:

  • Objective campaign và deliverable dự kiến.
  • Audience cùng market evidence đã được duyệt.
  • Industry, product, offer, channel và constraint địa lý hay văn hóa.
  • Brand guideline hiện tại, thành phần bắt buộc và treatment bị cấm.
  • Decision owner, review criteria và yêu cầu licensing hay accessibility.

Hoàn thành Làm quen, cài Marketing Kit cho runtime cùng scope active và giữ instruction project có hiệu lực.

RuntimeCách gọiRanh giới khả dụng
Claude Code/ak:creativity ...Phân phối native là mặc định; plugin rõ ràng cũng được hỗ trợ. Search đi kèm chạy local, còn production tool sau đó có ranh giới riêng.
Cursor/ak:creativity ...Slash invocation đã được người dùng xác minh. Điều này không thiết lập parity cho mọi workflow design hay media tiếp theo.
Codex$ak:creativity ...Native Skill discovery được hỗ trợ. Hook projection chỉ một phần, nhưng Python search trong package vẫn là local Skill resource khi khả dụng.

Xem Runtime adapter trước khi giả định tool, Agent hay post-processing behavior giống nhau trên mọi runtime.

Yêu cầu draft có phạm vi rõ ràng

/ak:creativity Draft a creative direction brief for a B2B onboarding campaign aimed at operations leads on LinkedIn. Use the approved brand guide, present two style options, mark platform and licensing details for verification, and do not generate or publish assets

Public argument hint của Skill là [style or medium], nhưng brief đầy đủ tạo output dễ review hơn một adjective hay channel name đơn lẻ.

Hiểu contract search đi kèm

Skill dùng Python search pipeline trong package. Đây là field và option nội bộ, không phải flag runtime AgentKit riêng:

Input hoặc option nội bộÝ nghĩa
queryText bắt buộc mô tả campaign type, audience, industry, platform, style hoặc medium
--creative-brief, -cbKết hợp kết quả reasoning, style, platform, voiceover và music thành một brief
--campaign-name, -cĐặt heading cho brief
--format, -fChọn ascii hoặc markdown cho brief được tạo
--domain, -dGiới hạn search ở style, platform, voiceover, music hoặc reasoning
--max-results, -nGiới hạn detailed result; mặc định 3
--jsonTrả detailed domain-search result dưới dạng JSON

Workflow Skill thông thường bắt đầu bằng creative-brief search, rồi chỉ dùng domain search khi draft cần thêm lựa chọn hay implementation detail.

Hiểu các giai đoạn

  1. Xác nhận brief. Trích xuất campaign type, audience, industry, platform, brand constraint và quyết định còn cần đưa ra.
  2. Search campaign reasoning. Local BM25 index chọn campaign category gần nhất trong package cùng direction rule.
  3. Search năm domain local. Workflow search reasoning, style, platform, voiceover và music CSV data. Không có provider request.
  4. Tổng hợp draft. Brief gồm style đã chọn, palette và effect, platform format, voiceover direction, music direction cùng anti-pattern khi local data có nội dung.
  5. Thêm lựa chọn khi cần. Focused domain search có thể đưa ra thêm option; reference page bổ sung descriptive detail.
  6. Review trước production. Một người xác minh brand fit, cultural context, platform rule hiện tại, accessibility, claim, talent, music và asset licensing trước mọi production workflow.

Tách guidance khỏi production

Recommendation không phải clearance

Gợi ý style, platform, voiceover và music là draft direction. Chúng không cấp quyền dùng track, voice, likeness, font, image, trademark hay platform placement, cũng không cấp quyền generation hay publication.

  • Search script đi kèm đọc CSV data trong package và in text. Tự chúng không tạo tệp project hay gửi network request.
  • Nếu bạn lưu brief, generate asset, gọi media provider hay publish campaign, hãy coi mỗi việc là mutation hoặc external action riêng với destination, data, cost và approval boundary riêng.
  • Xác minh contrast, caption, readability, motion, representation và cultural meaning cho deliverable thực tế thay vì dựa vào style label.
  • Xác minh dimension, duration, content policy và audio rule hiện tại của channel tại thời điểm production. Platform và trend data trong package là snapshot.
  • Không lặp lại percentage hay benchmark claim từ source như evidence.

Xác minh output

Creative direction brief hữu ích nên có:

  • Objective campaign, audience, industry, channel và brand constraint bạn cung cấp.
  • Một direction được đề xuất cùng alternative có nhãn rõ ràng.
  • Ghi chú visual style, palette, composition, effect, voiceover, music và format gắn với brief thay vì trình bày như chân lý phổ quát.
  • Anti-pattern và quyết định chưa giải quyết.
  • Danh sách xác minh platform rule, accessibility, brand approval, claim, quyền sử dụng và licensing.
  • Tuyên bố rõ không asset nào được generate, mua, upload hay publish trừ khi bạn duyệt riêng hành động đó.

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

Triệu chứngBước tiếp theo an toàn
Kết quả trống hoặc genericThêm campaign type, audience, industry và channel; sau đó yêu cầu focused domain search.
Cùng default direction xuất hiện nhiều lầnCoi đó là search fallback, không phải recommendation được brief hỗ trợ. Yêu cầu alternative và so sánh thủ công.
Platform detail xung đột tài liệu hiện tạiƯu tiên nguồn chính hiện tại của platform và cập nhật production brief; không coi packaged data là authority hiện tại.
Music hay voice direction thiếu thông tin quyền sử dụngDừng trước production và lấy licensing, consent cùng legal review cho asset hoặc talent thực tế.
Skill bắt đầu tạo tệpKhẳng định lại lần chạy chỉ tạo direction, kiểm tra mọi mutation và giữ công việc không liên quan.
Runtime không tìm thấy ak:creativityLàm theo Runtime không tìm thấy Skill hoặc Agent.

Tiếp tục với Tổng quan Marketing Kit hoặc Projects, artifacts và checkpoints trước khi chuyển từ brief sang asset production.

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

  • Search ranking là lexical BM25 trên các CSV row trong package; nó không hiểu market như research hiện tại hay đo creative effectiveness.
  • Khi không có campaign reasoning row phù hợp, generator cung cấp generic fallback value. Những default này cần cùng mức review như mọi option khác.
  • Reference style, platform, trend, audio và color trong package có thể cũ hoặc chứa generalization rộng. Validate từng claim và spec quan trọng.
  • Skill không generate, test, distribute hay đo creative asset.