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

Skill

Nhận tư vấn kỹ thuật với ak:ask

Dùng ak:ask để nhận hướng dẫn kỹ thuật và kiến trúc dựa trên bằng chứng mà không bắt đầu implementation.

Dùng ak:ask khi project marketing phát sinh câu hỏi kỹ thuật hoặc kiến trúc và bạn cần recommendation trực tiếp trước khi thay đổi bất kỳ thứ gì. Skill thu thập context project liên quan ở phạm vi nhỏ nhất, đối chiếu tài liệu với source hoặc cấu hình hiện tại, rồi trả về option, trade-off và next action. Skill không triển khai recommendation.

Chọn ak:ask cho tư vấn

Dùng ak:ask khi

  • Bạn cần chọn kiến trúc, pattern tích hợp hoặc công nghệ cho website marketing, analytics pipeline, content system hay automation.
  • Bạn muốn so sánh các cách tiếp cận theo constraint hiện tại của project.
  • Bạn cần đánh giá rủi ro, độ tin cậy hoặc khả năng mở rộng trước khi lập plan.
  • Bạn cần câu trả lời chỉ phân tích và không cho phép thay đổi workspace.

Chọn workflow khác khi

  • Mục tiêu marketing hoặc bằng chứng chấp nhận vẫn chưa rõ. Dùng ak:brainstorm để xác định outcome và so sánh hướng đi.
  • Bạn cần implementation plan bền vững. Dùng ak:plan.
  • Bạn có defect tái hiện được và muốn sửa. Dùng ak:fix.
  • Bạn cần điều tra có hệ thống trước khi quyết định có thay đổi hay không. Dùng ak:debugging và yêu cầu dừng sau chẩn đoán.

ak:ask là Skill tư vấn kỹ thuật trong package Marketing đã resolve. Việc cài cùng Marketing Kit không biến nó thành workflow nghiên cứu campaign, positioning, copywriting hay phân tích hiệu suất.

Chuẩn bị câu hỏi và bằng chứng

Trước khi gọi Skill:

  • Hoàn thành Làm quen và xác nhận Marketing Kit đã được cài cho đúng runtime cùng scope.
  • Mở project liên quan nếu câu trả lời phụ thuộc kiến trúc của project.
  • Nêu quyết định, constraint hiện tại và bằng chứng đã có.
  • Chỉ rõ tệp nhạy cảm, tài khoản live, dữ liệu riêng tư hoặc hệ thống bên ngoài phải nằm ngoài scope.
  • Nêu có cần tài liệu bên ngoài hiện tại hay không. Quyền truy cập mạng và provider phụ thuộc các tool có trong session.
RuntimeCách gọiRanh giới khả dụng
Claude Code/ak:ask ...Khả dụng qua delivery native hoặc plugin rõ ràng.
Cursor/ak:ask ...Được projection thành Skill gọi bằng slash; không hàm ý runtime parity rộng hơn.
Codex$ak:ask ...Dùng discovery Skill native của Codex; Hook và UI khác Claude Code.

Xem Runtime adapter để hiểu khác biệt về delivery và từng component.

Chạy Skill

Hỏi một câu hướng đến quyết định và nêu ranh giới bằng chứng:

/ak:ask "Với project landing page này, nên gửi conversion event từ browser, server hay cả hai? Kiểm tra event pipeline hiện tại, so sánh trade-off về chất lượng dữ liệu và privacy, không sửa tệp"

Theo mặc định, Skill giữ toàn bộ scope bạn yêu cầu, không thêm phần chưa được yêu cầu, đồng thời áp dụng KISS và DRY. Thêm --yagni khi bạn cũng muốn Skill thách thức và cắt scope không cần thiết cho outcome đã nêu. Hãy đặt format câu trả lời và ranh giới quyền hạn mong muốn ngay trong câu hỏi.

Hiểu các giai đoạn tư vấn

  1. Khám phá context. Skill đọc instruction repository, README gốc và tài liệu project được route phù hợp với câu hỏi.
  2. Kiểm tra bằng chứng hiện tại. Skill đối chiếu tài liệu với source, test, cấu hình hoặc runtime evidence khi các bề mặt đó liên quan.
  3. Đánh giá kiến trúc. Skill xem xét ranh giới hệ thống, lựa chọn công nghệ, khả năng mở rộng, độ tin cậy và rủi ro.
  4. Tổng hợp recommendation. Skill áp dụng KISS và DRY, giữ toàn bộ scope đã yêu cầu, giải thích phương án thay thế, trade-off và điểm cần xác minh. Với --yagni, Skill cũng thách thức scope không cần thiết.
  5. Dừng trước delivery. Output có thể chuyển sang brainstorm hoặc plan, nhưng Skill không bắt đầu implementation.

Bốn góc nhìn cố vấn được nêu trong Skill mô tả cách tổ chức phân tích. Chúng không đảm bảo bốn Agent gọi độc lập hoặc model cụ thể.

Giữ lần chạy ở chế độ chỉ đọc

Tư vấn không phải quyền thực thi

ak:ask không được sửa workspace, thay đổi tài khoản provider, publish content, liên hệ audience, chi ngân sách, commit code hay deploy. Nếu chấp nhận recommendation, hãy chuyển sang workflow planning hoặc delivery riêng với scope và phê duyệt riêng.

Việc kiểm tra repository vẫn có thể làm lộ thông tin nhạy cảm nếu câu hỏi quá rộng. Hãy nêu path liên quan và loại trừ secret, customer record, credential cùng tệp riêng tư không liên quan. Khi cần nguồn bên ngoài hiện tại, hãy duyệt riêng network hoặc provider access và review bằng chứng được trích dẫn.

Review output và bằng chứng

Kết quả hữu ích nên có:

  • Phân tích kiến trúc dựa trên bằng chứng project đã kiểm tra.
  • Cách tiếp cận được đề xuất cùng lý do và phương án khả thi khác.
  • Hướng dẫn công nghệ với lợi ích, chi phí và constraint quan trọng.
  • Chiến lược xác minh hoặc implementation theo phase, không phải chỉnh sửa chưa được phê duyệt.
  • Rủi ro, giả định, khoảng trống bằng chứng và next action.
  • Câu hỏi chưa giải quyết được đặt cuối cùng nếu có.

Hãy coi recommendation là guidance, không phải proof. Xác minh behavior của provider, yêu cầu privacy, data contract và constraint vận hành với nguồn có thẩm quyền hiện tại trước khi hành động.

Xử lý sự cố tư vấn

Triệu chứngBước tiếp theo an toàn
Runtime không nhận diện ak:askXác nhận target và scope, khởi động lại runtime, rồi làm theo Runtime không tìm thấy Skill hoặc Agent.
Câu trả lời chung chungBổ sung quyết định cụ thể, path liên quan, constraint và bằng chứng Skill được phép kiểm tra.
Câu trả lời giả định behavior đã cũYêu cầu xác minh claim với source, test, cấu hình hiện tại hoặc nguồn bên ngoài có thẩm quyền đã được duyệt.
Skill bắt đầu đề xuất chỉnh sửaNhắc lại ranh giới chỉ phân tích và dừng trước mọi mutation. Dùng workflow riêng nếu muốn delivery.
Câu hỏi chủ yếu là chiến lược marketingDùng Marketing domain Skill như research, brand, planning hoặc content thay vì kéo giãn tư vấn kỹ thuật.

Biết giới hạn hiện tại

  • Skill trả lời câu hỏi kỹ thuật và kiến trúc, không phải oracle chiến lược Marketing tổng quát.
  • Câu trả lời bị giới hạn bởi tệp project, tool, provider access và bằng chứng hiện tại có trong session.
  • Skill không thể đảm bảo hiệu suất, conversion, revenue, hỗ trợ provider hay kết quả compliance.
  • Stable và beta có source content cùng invocation identity ak:ask giống nhau; projection runtime vẫn có thể khác theo adapter.

Tiếp tục với Tổng quan Marketing Kit, làm rõ outcome bằng ak:brainstorm hoặc tạo plan được review bằng ak:plan.