Skill
Thiết lập context marketing cho project với ak:init
Phỏng vấn stakeholder, đối chiếu bằng chứng hiện có và tạo lượng context marketing bền vững tối thiểu mà project cần.
Dùng ak:init khi project mới hoặc hiện có cần một marketing brief đã thống
nhất, constraint thương hiệu, context audience, mục tiêu và nơi lưu tài liệu rõ
ràng. Skill kiểm tra nội dung project đang coi là nguồn có thẩm quyền, phỏng vấn
bạn về thông tin còn thiếu rồi đề xuất thay đổi tài liệu nhỏ nhất nhưng hữu ích.
Chọn ak:init để onboarding project
Dùng ak:init khi
- Bạn bắt đầu một project marketing và cần brief có cấu trúc.
- Repository hiện có chứa context marketing rải rác hoặc đã cũ cần stakeholder kiểm tra lại.
- Các session sau cần context bền vững về product, audience, brand, objective, timeline và resource.
- Bạn muốn giữ cấu trúc tài liệu hiện tại thay vì nhận một template thư mục cố định.
Chọn workflow khác khi
- Project đã có context được duyệt và bạn chỉ cần campaign hoặc deliverable. Dùng Skill lập kế hoạch hoặc sáng tạo phù hợp.
- Bạn cần báo cáo repository ở chế độ chỉ đọc. Dùng
ak:watzup; Skill đó báo trạng thái nhưng không thiết lập thẩm quyền marketing. - Bạn cần giữ cuộc hội thoại hiện tại cho session khác. Dùng
ak:handoff. - Bạn chỉ cần convention cho agent trong một thư mục. Dùng
ak:folder-context.
Chuẩn bị project và bằng chứng
Trước khi bắt đầu:
- Hoàn thành Làm quen và cài Marketing Kit cho đúng runtime cùng scope đang dùng.
- Mở project có tài liệu mà bạn chấp nhận cập nhật.
- Xác định người được quyền xác nhận thông tin product, brand, pháp lý, audience, budget và timeline.
- Tập hợp nguồn đã duyệt như README gốc, strategy hiện tại, brand guidance, product asset, customer evidence và URL website công khai.
- Loại credential, dữ liệu riêng tư của customer và dữ liệu cá nhân mà brief không cần.
Skill có thể kiểm tra instruction của repository, navigation tài liệu, manifest, asset và tệp project liên quan. Skill cũng có thể đọc website hoặc nguồn bên ngoài khác mà bạn cung cấp khi runtime hiện tại có tool phù hợp và bạn duyệt quyền truy cập mạng đó.
Gọi Skill
| Runtime | Cách gọi | Ranh giới khả dụng |
|---|---|---|
| Claude Code | /ak:init ... | Delivery native hoặc plugin có thể cung cấp Skill. Câu hỏi tương tác và research được delegate tùy chọn phụ thuộc capability trong session. |
| Cursor | /ak:init ... | Cách gọi bằng slash đã được người dùng xác minh cho AgentKit Skill đã cài. Điều này không chứng minh behavior của câu hỏi, Agent hay tool giống hệt. |
| Codex | $ak:init ... | Codex dùng cơ chế discovery native của Skill. Projection Agent và Hook phụ thuộc capability nên workflow bao quanh có thể khác. |
Đọc Runtime adapter trước khi giả định prompt tương tác, Agent, browser tool hoặc Hook hoạt động giống nhau.
/ak:init "Onboard repository sản phẩm hiện có này để lập kế hoạch ra mắt. Tái sử dụng tài liệu hiện tại, coi interview được cung cấp là riêng tư, không khởi tạo Git, tạo remote, commit, publish hoặc chi tiêu"/ak:init "Onboard repository sản phẩm hiện có này để lập kế hoạch ra mắt. Tái sử dụng tài liệu hiện tại, coi interview được cung cấp là riêng tư, không khởi tạo Git, tạo remote, commit, publish hoặc chi tiêu"$ak:init "Onboard repository sản phẩm hiện có này để lập kế hoạch ra mắt. Tái sử dụng tài liệu hiện tại, coi interview được cung cấp là riêng tư, không khởi tạo Git, tạo remote, commit, publish hoặc chi tiêu"Hãy nêu ranh giới quyền hạn ngay trong prompt đầu. Đặc biệt, phân biệt quyền đọc và soạn draft với quyền khởi tạo repository, tạo remote được host, ghi tài liệu project hoặc commit kết quả.
Hiểu các giai đoạn
- Kiểm tra trạng thái repository. Skill chạy
git status. Nếu thư mục không phải Git repository, Skill hỏi trước khi chạygit init. - Đánh giá context hiện có. Các luồng research xem bằng chứng product hoặc service, asset marketing hiện có, hiện diện công khai và context cạnh tranh. Skill tóm tắt phát hiện và hỏi chúng còn chính xác không.
- Thực hiện phỏng vấn brief. Skill lần lượt thu thập thông tin cơ bản, product và service, objective, audience, competitor, brand asset, nguồn design, hiện diện social, timeline và budget.
- Định tuyến fact bền vững. Workflow ánh xạ từng fact đã xác nhận tới bề mặt có thẩm quyền hiện tại và chỉ đề xuất tệp mới theo mục đích khi chưa có owner.
- Ghi tài liệu đã duyệt. Skill chỉ cập nhật tệp và navigation đã thống nhất, sau đó báo path thực tế cùng context chưa giải quyết.
- Đề xuất hành động tiếp theo riêng biệt. Skill hỏi riêng trước khi commit và gợi ý một nhóm nhỏ Marketing Skill phù hợp với outcome tiếp theo.
Cuộc phỏng vấn được chia nhỏ có chủ đích. Câu trả lời tùy chọn có thể để TBD,
nhưng báo cáo hoàn tất phải hiển thị rõ các khoảng trống đó.
Giữ mutation và tác động bên ngoài rõ ràng
Thiết lập project không phải blanket approval
Quyền thực hiện phỏng vấn hoặc soạn brief không cấp quyền chạy git init, tạo
repository GitHub hay GitLab, ghi tài liệu, commit, truy cập website, publish,
outreach, thay đổi tài khoản hoặc phân bổ budget. Hãy duyệt riêng từng ranh
giới có liên quan.
git initthay đổi trạng thái repository. Skill hỏi trước khi Git chưa tồn tại.- Tạo remote bằng
gh repo createdùng credential và provider qua mạng, tạo trạng thái bên ngoài, đồng thời cần quyết định rõ visibility cùng ownership. - Đọc website, video hoặc social profile được cung cấp có thể liên hệ provider bên ngoài và để lộ metadata của request.
- Thông tin budget, customer, follower, cạnh tranh và brand có thể nhạy cảm. Chỉ lưu nội dung project được phép giữ.
- Tạo tài liệu sẽ ghi tệp. Hãy review outline và path được đề xuất trước khi cho phép ghi.
- Giai đoạn commit là tùy chọn và cần duyệt riêng. Skill không cấp quyền push, merge, publication, launch campaign, outreach hoặc spend.
Xác minh output
Một lần chạy hoàn tất nên cung cấp:
- Tóm tắt đã xác nhận về product, audience, brand, objective và marketing asset hiện có.
- Marketing brief đã hoàn thành hoặc ghi rõ phần chưa hoàn thành.
- Cập nhật tối thiểu vào authority tài liệu hiện có, hoặc tệp theo mục đích chỉ cho vai trò chưa có owner.
- Navigation tài liệu được cập nhật khi project có dùng.
- Báo cáo hoàn tất liệt kê bằng chứng đã kiểm tra, path chính xác đã đổi, phần bị bỏ qua và câu hỏi chưa giải quyết.
- Bản ghi riêng cho biết Git initialization, tạo remote và commit đã bị từ chối, bỏ qua hay phê duyệt.
Hãy kiểm tra diff và xác minh mọi claim bền vững với owner tương ứng. Brief được tạo ra là context project, không phải bằng chứng rằng claim thị trường, price, quy mô audience hay nhận định cạnh tranh còn hiện hành.
Xử lý sự cố an toàn
| Triệu chứng | Bước tiếp theo an toàn |
|---|---|
Runtime không nhận diện ak:init | Xác nhận target và scope Marketing, mở session mới rồi làm theo Runtime không tìm thấy Skill hoặc Agent. |
| Context hiện có mâu thuẫn với câu trả lời phỏng vấn | Giữ cả hai bằng chứng hiển thị, xác định owner hiện tại và hỏi stakeholder có thẩm quyền quyết định. |
| Skill đề xuất một cây tài liệu cố định | Dừng và yêu cầu Skill quay lại instruction của repository cùng navigation tài liệu hiện tại. |
| Git hoặc remote creation xuất hiện khi chưa duyệt | Từ chối hành động. Tiếp tục brief mà không thiết lập repository, hoặc duyệt một thao tác có scope chính xác. |
| Không thể research bên ngoài | Tiếp tục bằng bằng chứng local được cung cấp và đánh dấu claim về hiện diện số hoặc competitor là chưa xác minh. |
| Tệp ngoài scope tài liệu đã thống nhất bị đổi | Dừng, kiểm tra diff và giữ phần việc không liên quan. Không commit cho tới khi ownership rõ ràng. |
Tiếp tục với Tổng quan Marketing Kit, hoặc xem Cài đặt Kit khi chưa chắc về discovery hay scope runtime.
Biết các giới hạn hiện tại
- Source workflow có thể delegate research và công việc tài liệu, nhưng concurrency của Agent, UI câu hỏi và browser capability thực tế phụ thuộc runtime.
- Giai đoạn next step của Skill vẫn nhắc tới script command catalog cũ và ví dụ slash cũ. Marketing Kit không đóng gói command nào; hãy xác minh catalog Skill đã cài và dùng invocation trên từng trang Skill thay vì giả định các ví dụ đó khả dụng.
- Thông tin website, social, competitor, price, follower và budget có thể thay đổi. Skill không thể làm chúng trở nên hiện hành nếu thiếu bằng chứng và quyền truy cập phù hợp.
- Skill không đảm bảo hiệu suất campaign, revenue, conversion, market fit, khả dụng của provider hay kết quả thương mại.