Quản lý Marketing Skill với ak:skill

Dùng ak:skill để tạo hoặc cải thiện Marketing Skill tái sử dụng trong project hiện tại. Skill định tuyến một trong sáu action tới workflow tập trung, giữ SKILL.md ngắn gọn bằng progressive disclosure và phân biệt planning cần review trước với action sửa tệp trực tiếp.

Chọn ak:skill cho task lifecycle của Skill

Dùng ak:skill khi

• Bạn muốn tạo Marketing Skill từ mô tả, URL tài liệu hoặc source repository.
• Bạn cần thêm reference hay script vào Skill hiện có.
• Bạn muốn có optimization plan và review gate trước khi đổi Skill.
• Bạn cần sửa Skill từ tệp logs.txt ở project root.
• Bạn muốn lập plan cho Skill mới hoặc áp dụng content update có giới hạn.

Chọn workflow khác khi

• Bạn vẫn cần chọn giữa Skill, Agent, command và workflow. Dùng ak:kit-builder để chọn component và tạo scaffold.
• Bạn cần install hay refresh Marketing Kit thay vì author nội dung project. Làm theo Cài đặt Kit.
• Bạn chỉ cần đọc hoặc giải thích một Skill. Hãy yêu cầu analysis mà không chọn action có mutation.
• Bạn định sửa Skill ở user scope. Việc đó cần quyền riêng, rõ ràng; project scope là mặc định.

Chuẩn bị target và bằng chứng

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

• Xác nhận Marketing Kit đã được cài đúng runtime cùng scope hiện tại.
• Đọc instruction của repository và tìm project Skill directory.
• Giữ thay đổi không liên quan và nêu chính xác target Skill.
• Với fix-logs, kiểm tra logs.txt ở project root rồi loại secret hay dữ liệu cá nhân trước khi dùng.
• Với URL hay repository source, xác định ranh giới network, download và external tool được phép trước khi research.

Chạy Skill

Từ đầu tiên theo vị trí là action. Ví dụ này lập plan cho Skill mới và giữ implementation sau một lần phê duyệt riêng:

/ak:skill plan campaign-brief "Create a project-scoped Skill that turns an approved launch brief into reviewable draft assets; do not implement yet"

/ak:skill plan campaign-brief "Create a project-scoped Skill that turns an approved launch brief into reviewable draft assets; do not implement yet"

$ak:skill plan campaign-brief "Create a project-scoped Skill that turns an approved launch brief into reviewable draft assets; do not implement yet"

Chọn action có chủ đích

Chỉ sáu action này được public Skill contract định tuyến. Đừng dựa vào internal reference không được liệt kê như một action được hỗ trợ khác.

Hiểu các giai đoạn

1. Parse action và target. Skill hỏi phần quan trọng còn thiếu thay vì đoán tên Skill hay scope.
2. Tải reference tương ứng. Mỗi action có rule riêng cho research, review, output và mutation.
3. Kiểm tra project scope. SKILL.md, reference, script, instruction của repository và log liên quan được đọc trước khi thay đổi.
4. Chỉ research theo quyền đã cấp. Tra tài liệu hoặc phân tích repository có thể dùng network và external tool; update local đơn giản không ngầm cho phép crawl rộng.
5. Lập plan hoặc sửa theo action. plan và optimize thêm review gate. add, create, fix-logs và update có thể đi tới thay đổi project file đã được cấp quyền.
6. Xác minh progressive disclosure. Entry file giữ ngắn gọn còn hướng dẫn chi tiết và deterministic helper chuyển vào resource tập trung.
7. Báo cáo bằng chứng và quyền còn thiếu. Lần chạy liệt kê đường dẫn, check, rủi ro chưa xử lý cùng bước Git hay distribution chưa được duyệt.

Kiểm soát research và mutation

Phê duyệt planning có hai ranh giới: duyệt proposal cho phép workflow lưu plan đã nêu; implementation chỉ bắt đầu sau xác nhận implementation riêng. Commit, push, package export, publication hay release về sau cũng là quyết định riêng.

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

Một lần chạy hoàn tất nên cung cấp:

• Action đã chọn, target Skill, project scope và non-goal đã chấp nhận.
• Tệp chính xác được tạo hoặc thay đổi, gồm reference hay script mới.
• SKILL.md ngắn gọn với description nêu khi nào Skill nên được kích hoạt.
• Bằng chứng tệp được tham chiếu tồn tại và script có test đại diện hoặc lý do được ghi rõ khi chưa chạy.
• Với plan hoặc optimize, vị trí plan đã duyệt, phase file, success criteria, rủi ro và trạng thái implementation.
• Tóm tắt diff cuối cùng với câu hỏi chưa giải quyết cùng mọi external action hay distribution action chưa được duyệt.

Xử lý sự cố và tôn trọng giới hạn

Các action reference trong package chủ yếu hướng Claude và có thể nêu tool, Agent hay đường dẫn không có ở runtime khác. Workflow không thể chứng minh source bên ngoài đầy đủ, cài tool khi chưa được duyệt hay tự đưa project Skill vào Marketing package đã phát hành. Tiếp tục với Marketing Kit hoặc dùng ak:kit-builder cho component không phải Skill.