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

Skill

Định tuyến báo cáo marketing với ak:analyze

Chọn loại phân tích hoặc kỳ báo cáo được hỗ trợ, thu thập dữ liệu đã duyệt và tạo báo cáo marketing có nêu rõ giới hạn.

Dùng ak:analyze làm bộ định tuyến báo cáo Marketing phạm vi rộng. Skill nhận một trong sáu loại—traffic, campaigns, conversions, funnel, content hoặc engagement—hay subcommand report với daily, weekly, monthly hoặc quarterly. Skill thu thập dữ liệu thực sự khả dụng, áp dụng framework analytics của Marketing và báo cáo phát hiện, khoảng trống cùng recommendation.

Chọn ak:analyze để định tuyến, không để giả định connector

Dùng ak:analyze khi

  • Bạn biết loại phân tích hoặc cadence báo cáo được hỗ trợ cần dùng.
  • Dữ liệu project đã duyệt hoặc quyền provider được cấp đã khả dụng.
  • Bạn muốn overview đa kênh trước khi chọn điều tra sâu hơn.

Chọn workflow khác khi

  • Bạn cần phương pháp KPI, attribution, cohort hoặc experiment tùy chỉnh. Dùng trực tiếp ak:analytics.
  • Bạn cần thêm tracking, đổi account hoặc vận hành campaign. Skill này tạo phân tích; nó không cấp quyền mutation, publishing hay chi tiêu.
  • Yêu cầu không khớp loại được liệt kê. Hãy xác định câu hỏi cùng phép đo trước, thay vì dựa vào tên chung của Skill.

Chuẩn bị contract báo cáo

Cung cấp chính xác loại hoặc kỳ, khoảng ngày, timezone, currency, mục tiêu, kỳ so sánh, danh sách nguồn và định nghĩa metric. Workflow có thể dùng dữ liệu project và có thể lấy bằng chứng GA4 hoặc Search Console khi MCP tương thích, credential, quyền cùng hành vi provider hiện tại đều tồn tại. Tên provider trong Skill không chứng minh connector đã được cấu hình.

Giảm thiểu dữ liệu cá nhân. Identifier của account, property, campaign, page, query, email, CRM và conversion có thể làm lộ cá nhân hoặc hoạt động kinh doanh nhạy cảm. Dùng bản export tổng hợp, redact secret cùng identifier trực tiếp và ghi rõ sampling, consent, retention cùng nguồn bị thiếu.

RuntimeCách gọiRanh giới khả dụng
Claude Code/ak:analyze ...Dùng Skill trong package qua phân phối native hoặc plugin rõ ràng. Quyền dữ liệu vẫn phụ thuộc session.
Cursor/ak:analyze ...Cách gọi bằng slash đã được người dùng xác minh; không ngụ ý connector hay automation parity.
Codex$ak:analyze ...Dùng native Skill discovery; tool khả dụng và Marketing Hook có thể khác.

Chạy Skill

/ak:analyze campaigns "Chỉ dùng các bản export kênh đã duyệt từ 2026-07-01 đến 2026-07-31. So sánh với mục tiêu, nêu trường bị thiếu và không thay đổi account"

Với báo cáo định kỳ, đặt report trước để Skill định tuyến argument còn lại:

/ak:analyze report weekly

Hiểu các giai đoạn

  1. Parse loại phân tích hoặc kỳ report.
  2. Kiểm kê nguồn khả dụng và tách dữ liệu được lấy, được cung cấp cùng bị thiếu.
  3. Áp dụng phép đo theo loại: nguồn traffic và trend; cost, conversion và ROI của campaign; stage cùng drop-off của funnel; hoặc content và engagement.
  4. So sánh với mục tiêu đã duyệt và kỳ trước thực sự tương đương.
  5. Tách quan sát, anomaly, giả định và recommendation trong báo cáo.

Giữ quyết định và mutation ở bạn

Báo cáo là guidance, không phải quyền vận hành

Không để recommendation tự động đổi tracking, budget, campaign, content, account hay live page. Mỗi mutation bên ngoài cần scope, review dữ liệu, quyền provider, kiểm tra chi phí và phê duyệt riêng.

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

Phân tích chuẩn ghi vào reports/analytics/{date}-{type}.md. Route report ghi vào reports/periodic/{date}-{period}.md. Kết quả nên có executive summary, metric chính, chi tiết kênh hoặc funnel liên quan, tiến độ mục tiêu, nguồn và kỳ so sánh, phát hiện, giới hạn cùng recommendation. Xác minh công thức, tổng, attribution window, identifier và citation với nguồn gốc.

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

Triệu chứngBước tiếp theo an toàn
Loại không rõChọn chính xác traffic, campaigns, conversions, funnel, content hoặc engagement.
Báo cáo định kỳ không routeDùng report daily, report weekly, report monthly hoặc report quarterly.
Provider được nêu không khả dụngDùng bản export đã duyệt hoặc cấu hình quyền riêng; không tạo dữ liệu giả.
Metric xung độtĐối chiếu định nghĩa, kỳ, timezone, currency và deduplication trước khi diễn giải.
Runtime không tìm thấy SkillLàm theo Runtime không tìm thấy Skill hoặc Agent.

Skill không bảo đảm độ phủ nguồn, connector khả dụng, attribution chính xác, statistical significance, revenue hay tăng hiệu suất. Xem Marketing KitRuntime adapter.