Skill
Viết research brief sẵn sàng cho quyết định với ak:research-prompt
Biến research objective thành một paragraph độc lập nêu bằng chứng, contradiction, gap và report mong đợi.
Dùng ak:research-prompt để chuẩn bị assignment chặt chẽ cho human hoặc AI
researcher. Skill trả về một paragraph độc lập có đủ context, question, yêu cầu
source và completion criteria cho research result sẵn sàng hỗ trợ quyết định.
Skill viết brief; Skill không thực hiện research.
Chọn ak:research-prompt cho research handoff
Dùng ak:research-prompt khi
- Câu hỏi về market, audience, competitor, customer, technology hoặc policy cần evidence plan trước khi research.
- Một người hoặc research runner khác cần brief hoạt động mà không trao đổi tiếp.
- Quyết định cần source, xử lý contradiction, gap analysis và format nhất quán cho từng finding.
- Topic rộng cần một research question có phạm vi cùng ba đến sáu sub-question.
Chọn workflow khác khi
- Bạn muốn thực hiện research ngay. Dùng research workflow có sẵn sau khi review brief.
- Bạn muốn brainstorm option từ context hiện có mà không tìm bằng chứng.
- Bạn cần tài liệu project từ bằng chứng có sẵn. Dùng
ak:docs.
Chuẩn bị decision context
Cung cấp project cùng situation, quyết định cần hỗ trợ, audience, deadline, known fact, constraint, intended use, source preference và data bị cấm. Người đọc không có prior conversation phải hiểu được brief cuối.
| Runtime | Cách gọi | Ranh giới khả dụng |
|---|---|---|
| Claude Code | /ak:research-prompt ... | Phân phối native là mặc định; plugin rõ ràng cũng được hỗ trợ. |
| Cursor | /ak:research-prompt ... | Cách gọi bằng slash đã được người dùng xác minh; thực thi brief tạo ra là capability riêng. |
| Codex | $ak:research-prompt ... | Native Skill discovery được hỗ trợ; bản thân Skill không browse hay gọi provider. |
Soạn research assignment
/ak:research-prompt Quyết định liệu onboarding guide đã duyệt có nên thêm segment cho operations leader lần đầu hay không. Dùng customer evidence hiện tại và primary market source, tách fact khỏi inference và yêu cầu source URL cho mỗi finding/ak:research-prompt Quyết định liệu onboarding guide đã duyệt có nên thêm segment cho operations leader lần đầu hay không. Dùng customer evidence hiện tại và primary market source, tách fact khỏi inference và yêu cầu source URL cho mỗi finding$ak:research-prompt Quyết định liệu onboarding guide đã duyệt có nên thêm segment cho operations leader lần đầu hay không. Dùng customer evidence hiện tại và primary market source, tách fact khỏi inference và yêu cầu source URL cho mỗi findingArgument là research topic hoặc decision. Output contract cố định: đúng một paragraph, không heading, preface hay deliverable thứ hai.
Theo các giai đoạn xây brief
- Thu thập context. Trích decision, audience, deadline, known fact, constraint và intended use từ conversation cùng file liên quan.
- Làm brief độc lập. Giải thích project và situation cho researcher không có prior context.
- Xác định một question. Nêu research question và decision nó sẽ hỗ trợ.
- Bao phủ decision. Thêm ba đến sáu sub-question đánh số inline mà không gộp mission không liên quan.
- Đặt evidence rule. Ưu tiên official documentation, repository, paper, filing và changelog. Coi forum cùng social post là signal yếu.
- Xác định cách xử lý contradiction và gap. Tách confirmed fact, inference và unresolved uncertainty; xem lại contradiction cùng claim chỉ có một nguồn.
- Nêu handoff. Yêu cầu source URL, claim cụ thể và một dòng decision relevance cho mỗi finding, được researcher sau đó cung cấp trong một detailed Markdown result.
Giữ brief khỏi hidden data và false certainty
Brief không phải là research evidence
Đừng cite paragraph được tạo như một finding. Researcher sau đó phải thực thi, lấy current source, ghi conflict và tạo report được yêu cầu. Review report đó trước khi đổi messaging, publish, liên hệ audience hoặc chi ngân sách.
Đừng đưa secret, private URL, credential, personal data hay unsupported fact vào assignment. Chọn provider, network access, paid research tool và gửi project material ra ngoài workspace là phê duyệt riêng ở execution stage.
Xác minh output contract
Output hoàn tất nên:
- có đúng một paragraph;
- hiểu được mà không cần conversation trước;
- tập trung vào một research question và một decision;
- có ba đến sáu sub-question đánh số inline;
- nêu rõ included/excluded scope, source hierarchy, contradiction handling, gap round và completion bar; và
- nêu rõ URL, claim cùng decision relevance cho từng finding trong detailed Markdown report sau đó.
Skill thường trả paragraph trong response. Skill không tạo file trừ khi bạn yêu cầu riêng và duyệt target path.
Khắc phục và hiểu giới hạn
| Triệu chứng | Bước tiếp theo an toàn |
|---|---|
Runtime không nhận diện ak:research-prompt | Xác nhận target cùng scope, mở lại runtime, rồi làm theo Runtime không tìm thấy Skill hoặc Agent. |
| Output có heading hoặc nhiều paragraph | Yêu cầu fixed one-paragraph contract không preface hay deliverable thứ hai. |
| Brief chứa nhiều goal không liên quan | Giữ một decision và tách mission khác thành brief riêng. |
| Yêu cầu source còn mơ hồ | Yêu cầu primary source, URL cho từng finding, xử lý contradiction và gap round. |
| Skill bắt đầu research | Dừng và chỉ yêu cầu assignment; thực thi sau bằng research workflow đã duyệt. |
| Brief chứa context bảo mật | Xóa trước khi handoff và thay bằng context không nhạy cảm tối thiểu cần thiết. |
Skill không thể bảo đảm source availability, research quality, correctness hay business outcome. Skill chỉ cải thiện assignment contract.
Tiếp tục với Tổng quan Marketing Kit hoặc ak:docs sau khi
research result đã được review và chấp nhận.
Hiểu giới hạn launcher ak:hub hiện tại
Review launcher Content Hub và Marketing Dashboard local dự kiến mà không dựa vào path cũ hay feature bị mô tả quá mức.
Biến quyết định của stakeholder thành tài liệu với ak:interview-docs
Chạy phỏng vấn có hướng dẫn để đưa tầm nhìn và quyết định của người dùng vào README, ADR hoặc tài liệu project có cấu trúc.