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.
| Runtime | Cách gọi | Ranh 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"/ak:write formula AIDA "Tạo variant ngắn, vừa và dài cho onboarding offer đã duyệt. Chỉ dùng proof được cung cấp và tránh urgency giả"$ak:write audit assets/articles/launch-guide.md "Chấm draft như heuristic review, liệt kê claim thiếu bằng chứng và không sửa tệp"| Route | Kết quả dự kiến | Tác động quan trọng |
|---|---|---|
audit | Review copy, search, platform và brand | Đọc tệp và tạo report có score; score là heuristic nội bộ. |
blog | Article, metadata và illustration tùy chọn | Có thể tạo cây article trong assets/articles/ và dùng workflow research hoặc image. |
blog-youtube | Article từ YouTube video | Truy cập video metadata, caption, screenshot, research source và media tool khi khả dụng. |
cro | Phân tích conversion và copy đã sửa | Có thể yêu cầu copywriter Agent sửa tệp code hoặc content trong phạm vi. |
enhance | Copy được sửa theo issue đã nêu | Có thể sửa copy file đã tìm thấy sau khi kiểm tra context. |
fast | Draft trực tiếp | Dùng copywriter Agent với orchestration tối thiểu. |
formula | Variant AIDA, PAS, BAB, 4Ps, ACCA hoặc FAB | Nạp brand context và viết variant ngắn, vừa, dài. |
good | Draft đã research và plan | Có thể dùng research, planning, design và multimodal review trước khi trả kết quả. |
publish | Phiên bản file đã audit và sửa | Có 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
- Đị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.
- Nạp context. Đọc brief, source material, brand voice, channel rule và tệp hiện có chỉ trong boundary đã duyệt.
- Research hoặc plan khi cần. Route blog và
goodcó thể dùng external research hoặc Agent chuyên biệt;fastchủ đích làm ít hơn. - 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.
- Audit artifact. Kiểm tra structure, clarity, CTA, channel fit, search consideration, brand voice và claim thiếu bằng chứng.
- 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ứng | Bước tiếp theo an toàn |
|---|---|
| Copy bịa fact hoặc proof | Xóa claim, cung cấp source và chạy lại section bị ảnh hưởng. |
| Brand voice sai | Cung cấp path guideline đã duyệt, ví dụ, prohibited term và target channel. |
publish thay đổi quá nhiều | Dừ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ại | Cung 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ại | Là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.
Duyệt asset marketing cục bộ với ak:content-hub
Mở ak:content-hub như một thư viện asset cục bộ, hiểu đúng tác động lên tệp và giữ thao tác chỉnh sửa cùng AI enhancement dưới quyền review.
Research và audit search với ak:seo
Dùng ak:seo cho audit, keyword research và pSEO artifact trong khi tách provider query, OAuth, bulk generation và live search change.