Tạo khung component Marketing với ak:kit-builder

Dùng ak:kit-builder để chọn và tạo scaffold cho Skill, Agent, command hoặc workflow của Marketing automation. Skill cung cấp guide tập trung, template và trình khởi tạo Python; bạn vẫn sở hữu contract của component, đường dẫn được tạo, đăng ký package, kiểm thử và review.

Chọn ak:kit-builder cho cấu trúc component

Dùng ak:kit-builder khi

• Bạn cần quyết định kiến thức tái sử dụng thuộc về Skill, autonomous handler thuộc về Agent, user action thuộc về command hay quy trình nhiều bước thuộc về workflow.
• Bạn muốn scaffold ở project scope với placeholder và section chuẩn.
• Bạn đang mở rộng Marketing automation và cần guide hoặc template riêng cho từng loại component.
• Bạn muốn review cấu trúc trước khi điền instruction theo domain.

Chọn workflow khác khi

• Bạn chỉ cần create, add, optimize, fix, plan hoặc update một Marketing Skill. Dùng ak:skill, workflow sở hữu lifecycle đó.
• Bạn cần install, refresh, audit hoặc remove Marketing Kit. Dùng lifecycle của AgentKit CLI trong Cài đặt Kit.
• Bạn cần bản nháp dùng một lần thay vì runtime component tái sử dụng.
• Bạn đã sẵn sàng publish hay phân phối component. Skill này tạo scaffold tệp; nó không duyệt package export, commit, push, release hay deploy.

Chuẩn bị project và runtime

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

• Hoàn thành Làm quen và xác nhận Marketing Kit đã được cài đúng runtime cùng scope hiện tại.
• Mở project nơi bạn được phép tạo hoặc thay thế tệp component.
• Đọc instruction của repository và kiểm tra tên component hiện có trước khi chọn target.
• Chuẩn bị Python nếu trình khởi tạo sẽ tạo scaffold.
• Chọn loại component và tên lowercase-hyphenated.

Xem Runtime adapter trước khi giả định component được tạo có discovery hay activation giống nhau ở mọi nơi.

Chạy Skill

Yêu cầu trực tiếp loại component và tên. Ví dụ này yêu cầu xem trước trước khi tạo bất kỳ tệp nào:

/ak:kit-builder skill campaign-brief — preview the destination and files before creating them

/ak:kit-builder skill campaign-brief — preview the destination and files before creating them

$ak:kit-builder skill campaign-brief — preview the destination and files before creating them

Mặc định, Skill scaffold đầy đủ scope được yêu cầu và không thêm phần việc ngoài yêu cầu. Thêm --yagni để challenge và cắt component scope không cần thiết cho outcome đã nêu.

Chọn component có chủ đích

Trình khởi tạo nhận python scripts/init_component.py <type> <name> và tùy chọn --path <output-dir>. Xem lần gọi script đó là chi tiết implementation của Skill, không phải lệnh AgentKit CLI.

Hiểu các giai đoạn

1. Phân loại outcome tái sử dụng. Skill phân biệt domain knowledge, autonomous handler, user action và process orchestration.
2. Kiểm tra target. Skill kiểm tra tên hiện có rồi tải guide cùng template tương ứng trước khi đề xuất đích.
3. Review kế hoạch scaffold. Bạn xác nhận loại, tên, đường dẫn, placeholder và việc target hiện có có thể bị thay thế hay không.
4. Tạo tệp project. Trình khởi tạo tạo directory đã chọn và ghi skeleton của component.
5. Điền contract. Thay mọi placeholder bằng trigger, bước, quality gate, output, reference hoặc script đúng với component.
6. Xác minh discovery và behavior. Test component trong runtime dự kiến, rồi review riêng mọi thay đổi package manifest hay distribution.

Giữ mutation và phê duyệt rõ ràng

Template là điểm bắt đầu, không phải bằng chứng component đã được export hay hoạt động. Marketing Kit hiện dùng Skills làm bề mặt gọi cho người dùng và không có command catalog. Vì vậy, tệp .claude/commands/ được tạo không trở thành Marketing command đã phát hành nếu thiếu thiết kế package và review 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:

• Loại component đã chọn và lý do nó phù hợp hơn các lựa chọn khác.
• Đường dẫn chính xác đã tạo hoặc thay đổi cùng nội dung hiện có được giữ lại.
• Scaffold không còn placeholder chưa giải thích trong component hoàn chỉnh.
• Reference hoặc script chỉ khi chúng cải thiện progressive disclosure hay làm deterministic step có thể tái tạo.
• Check dùng để xác nhận syntax, runtime discovery, happy path và failure path đại diện.
• Danh sách riêng các hành động package, Git, publication hoặc deployment vẫn cần phê duyệt.

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

Các guide hướng Claude và có một số pattern component lịch sử. Chúng không thiết lập cross-runtime parity, public command catalog hay distribution tự động. Tiếp tục với Marketing Kit hoặc dùng ak:skill khi component mong muốn chính là một Skill.