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

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.

RuntimeCách gọiRanh 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

Argument 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

  1. Thu thập context. Trích decision, audience, deadline, known fact, constraint và intended use từ conversation cùng file liên quan.
  2. Làm brief độc lập. Giải thích project và situation cho researcher không có prior context.
  3. Xác định một question. Nêu research question và decision nó sẽ hỗ trợ.
  4. 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.
  5. Đặt evidence rule. Ưu tiên official documentation, repository, paper, filing và changelog. Coi forum cùng social post là signal yếu.
  6. 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.
  7. 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ứngBước tiếp theo an toàn
Runtime không nhận diện ak:research-promptXá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 paragraphYêu cầu fixed one-paragraph contract không preface hay deliverable thứ hai.
Brief chứa nhiều goal không liên quanGiữ 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 researchDừ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ậtXó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.