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

Skill

Soạn và review marketing copy với ak:write

Định tuyến task viết có phạm vi rõ ràng qua ak:write, giữ brand và evidence input, đồng thời phân biệt file readiness với publication thực.

Dùng ak:write để tạo, cải thiện hoặc audit marketing copy. Các workflow được định tuyến bao gồm draft nhanh, copy có plan, variant theo formula, blog, conversion copy, enhancement, quality review và bước kiểm tra file sẵn sàng để publish.

Chọn ak:write cho deliverable viết có phạm vi rõ ràng

Dùng ak:write khi

  • Bạn biết audience, offer hoặc topic, format, channel và action mong muốn.
  • Bạn có fact, source, brand voice, từ cấm và legal constraint đã được duyệt.
  • Bạn cần variant, bài viết có cấu trúc, audit hoặc revision cho tệp cục bộ.

Chọn workflow khác khi

  • Bạn cần strategy chương trình hoặc editorial calendar. Dùng ak:content-marketing.
  • Bạn cần keyword, ranking hoặc technical search evidence hiện tại. Dùng ak:seo.
  • Bạn cần publish CMS, post social hoặc gửi email thực. Writing artifact là input cho workflow riêng đó, không phải quyền thực hiện.

Chuẩn bị brief và workspace

Xác nhận Marketing Kit đã được cài cho đúng runtime và scope. Cung cấp outcome, audience, format, source fact, brand guidance, CTA, channel limit, non-goal, output path và việc tệp cục bộ có thể được tạo hoặc overwrite hay không. Với blog-youtube, cung cấp public video URL và duyệt việc truy cập transcript, research cùng media. Với audit, enhance, cro hoặc publish, cung cấp tệp chính xác hoặc vị trí workspace có phạm vi rõ ràng.

RuntimeCách gọiRanh giới khả dụng
Claude Code/ak:write ...Phân phối native là mặc định; phân phối plugin rõ ràng cũng được hỗ trợ.
Cursor/ak:write ...Skill được projection sang Cursor và cách gọi bằng slash đã được người dùng xác minh; dependent tool vẫn có thể khác.
Codex$ak:write ...Skill dùng native discovery của Codex; external research và media work phụ thuộc tool có trong session.

Chạy writing route phù hợp

/ak:write good "Soạn launch article 700 từ từ brief đã duyệt đính kèm. Khớp docs/brand-guidelines.md, dẫn nguồn mọi factual claim và không publish"
RouteKết quả dự kiếnTác động quan trọng
auditReview copy, search, platform và brandĐọc tệp và tạo report có score; score là heuristic nội bộ.
blogArticle, metadata và illustration tùy chọnCó thể tạo cây article trong assets/articles/ và dùng workflow research hoặc image.
blog-youtubeArticle từ YouTube videoTruy cập video metadata, caption, screenshot, research source và media tool khi khả dụng.
croPhân tích conversion và copy đã sửaCó thể yêu cầu copywriter Agent sửa tệp code hoặc content trong phạm vi.
enhanceCopy được sửa theo issue đã nêuCó thể sửa copy file đã tìm thấy sau khi kiểm tra context.
fastDraft trực tiếpDùng copywriter Agent với orchestration tối thiểu.
formulaVariant AIDA, PAS, BAB, 4Ps, ACCA hoặc FABNạp brand context và viết variant ngắn, vừa, dài.
goodDraft đã research và planCó thể dùng research, planning, design và multimodal review trước khi trả kết quả.
publishPhiên bản file đã audit và sửaCó thể overwrite cùng path hoặc tạo {path}-published.md; không publish ra ngoài.

Hiểu các giai đoạn

  1. Định tuyến yêu cầu. Argument đầu chọn reference workflow; phần còn lại xác định subject hoặc file.
  2. Nạp context. Đọc brief, source material, brand voice, channel rule và tệp hiện có chỉ trong boundary đã duyệt.
  3. Research hoặc plan khi cần. Route blog và good có thể dùng external research hoặc Agent chuyên biệt; fast chủ đích làm ít hơn.
  4. Soạn hoặc sửa. Tạo format và variant được yêu cầu, giữ fact đã xác minh cùng từ cấm.
  5. Audit artifact. Kiểm tra structure, clarity, CTA, channel fit, search consideration, brand voice và claim thiếu bằng chứng.
  6. Trả evidence. Báo output path, source, thay đổi lớn, review finding và mọi approval chưa giải quyết.

Giữ publication và claim dưới quyền con người

Route publish không thực sự publish

ak:write publish là quality gate cục bộ. Nó có thể viết lại tệp được cung cấp và gắn nhãn kết quả sẵn sàng để publish, nhưng không cập nhật CMS, gửi email, post lên network, mua media hay chứng minh copy chính xác hoặc compliant.

Duyệt riêng network research, YouTube retrieval, image generation và provider use. Không gửi secret, private customer data hay licensed material tới provider bên ngoài khi chưa được phép. Review testimonial, statistic, comparison, urgency, pricing, guarantee và regulated claim theo source cùng policy áp dụng.

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

Output phụ thuộc route. formula ghi dưới assets/copy/{date}-{formula}-{slug}.md; blog dùng assets/articles/{date}-{slug}/; còn blog-youtube dùng content/blog/ cùng thư mục image. Route khác có thể sửa tệp được cung cấp hoặc trả report. Xác nhận path thực trước downstream automation.

Kết quả hoàn chỉnh xác định brief và source đã dùng, brand rule đã áp dụng, tệp đã tạo hoặc đổi, edit before-and-after quan trọng, audit finding, evidence còn thiếu và action vẫn cần để publish. Xem numeric quality score và nhãn “publish ready” là workflow signal, không phải bảo đảm conversion, ranking, revenue hay compliance.

Xử lý sự cố và biết giới hạn

Triệu chứngBước tiếp theo an toàn
Copy bịa fact hoặc proofXóa claim, cung cấp source và chạy lại section bị ảnh hưởng.
Brand voice saiCung cấp path guideline đã duyệt, ví dụ, prohibited term và target channel.
publish thay đổi quá nhiềuDừng, kiểm tra diff, khôi phục bản gốc từ version control hoặc backup của bạn rồi chạy lại với boundary hẹp hơn.
Platform rule có vẻ cũXác minh tài liệu platform hiện tại trước approval; limit và template đi kèm có thể cũ đi.
YouTube hoặc research retrieval thất bạiCung cấp transcript cùng source đã duyệt, hoặc tiếp tục mà không có enrichment chưa được hỗ trợ.
Runtime discovery thất bạiLàm theo Runtime không tìm thấy Skill hoặc Agent.

Skill không thể bảo đảm quality, originality, rights clearance, search performance, conversion hay publication acceptance. Tiếp tục với tổng quan Marketing Kit hoặc chỉ dùng Skill theo channel sau khi copy và authority boundary đã được duyệt.