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:debuggingvà 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.
| Runtime | Cách gọi | Ranh 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"/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"$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
- 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.
- 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.
- Đá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.
- 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. - 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ứng | Bước tiếp theo an toàn |
|---|---|
Runtime không nhận diện ak:ask | Xá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 chung | Bổ 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ửa | Nhắ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 marketing | Dù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:askgiố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.
Audit UI code với ak:web-design-guidelines
Review một tập tệp web UI có phạm vi rõ theo Web Interface Guidelines mới được fetch và nhận finding ngắn gọn theo tệp cùng dòng.
Định hình outcome marketing với ak:brainstorm
Dùng ak:brainstorm để biến intent chưa đầy đủ thành outcome, constraint, non-goal và acceptance criteria có thể quan sát đã được chấp nhận.