case-study-writing

Tổng quan

case-study-writing là kỹ năng gì?

Kỹ năng case-study-writing là một quy trình được hướng dẫn để tạo case study B2B rõ ràng, đáng tin cậy theo khung STAR (Situation → Task → Action → Result). Kỹ năng này được xây dựng như một inference.sh skill để agent của bạn có thể nghiên cứu, phác thảo và viết nháp câu chuyện khách hàng nhấn mạnh được kết quả kinh doanh thực tế.

Thay vì phải bắt đầu từ trang giấy trắng, kỹ năng này dẫn dắt agent đi qua từng bước:

• Thiết lập Situation và bối cảnh của khách hàng
• Xác định Task hoặc thách thức một cách cụ thể
• Mô tả Action (giải pháp và cách triển khai của bạn)
• Đo lường Result bằng số liệu, so sánh trước/sau và yếu tố minh họa

Dành cho ai?

Hãy dùng kỹ năng case-study-writing nếu bạn cần tạo:

• Câu chuyện thành công của khách hàng cho SaaS, dịch vụ, hoặc sản phẩm B2B
• Tài liệu hỗ trợ bán hàng thể hiện rõ bằng chứng về kết quả
• Case study marketing cho website, slide deck hoặc chiến dịch
• Portfolio cho agency, tư vấn, hoặc freelancer

Phù hợp với các nhóm:

• Marketing và content marketing
• Customer marketing và customer success
• Sales và sales engineering
• Agency và tư vấn B2B

Kỹ năng này giải quyết vấn đề gì?

Kỹ năng này được thiết kế để giải quyết các vấn đề thường gặp khi viết case study:

• Câu chuyện nghe “bóng bẩy” nhưng thiếu tác động kinh doanh rõ ràng
• Bản nháp thiếu cấu trúc, khiến các kết quả quan trọng bị chìm lấp
• Số liệu yếu hoặc thiếu, làm suy giảm độ tin cậy
• Thiếu nghiên cứu về ngành và bối cảnh của khách hàng

Bằng cách tuân theo cấu trúc STAR cố định và hướng dẫn số lượng từ từ repository, agent giữ cho từng phần tập trung và đảm bảo tổng độ dài nằm trong khoảng 800–1200 từ, cân bằng giữa chi tiết và khả năng đọc.

Khi nào case-study-writing là lựa chọn phù hợp?

Hãy chọn kỹ năng này khi:

• Bạn có sản phẩm hoặc dịch vụ với kết quả đo lường được
• Bạn cần cấu trúc case study nhất quán, đúng thương hiệu cho nhiều câu chuyện khác nhau
• Bạn muốn agent sử dụng research và data thay vì ngôn ngữ marketing chung chung
• Bạn dự định tái sử dụng case study trong slide bán hàng, landing page hoặc chiến dịch social

Kỹ năng này không phù hợp khi:

• Bạn chỉ cần testimonial ngắn hoặc các câu trích dẫn một dòng
• Bạn đang viết tài liệu kỹ thuật thuần túy hoặc user manual
• Bạn không có quyền đề cập tên khách hàng, số liệu hoặc kết quả, và cũng không thể ẩn danh chúng

Cách sử dụng

Điều kiện cần

Định nghĩa kỹ năng trong repository ghi rõ kỹ năng này được thiết kế để chạy với inference.sh CLI (infsh).

Bạn nên có:

• Node.js đã cài đặt (để dùng npx khi cài skill)
• Quyền truy cập infsh CLI nếu bạn định thực hiện bước nghiên cứu Quick Start

Nếu bạn muốn dùng luồng research như trong source, hãy cài inference.sh CLI theo hướng dẫn chính thức tại:

• https://raw.githubusercontent.com/inference-sh/skills/refs/heads/main/cli-install.md

Các bước cài đặt

Dùng lệnh cài đặt của Agent Skills Finder để thêm skill vào môi trường agent của bạn:

npx skills add https://github.com/inferen-sh/skills --skill case-study-writing

Lệnh này sẽ tải định nghĩa kỹ năng case-study-writing và các file hướng dẫn liên quan từ repository inferen-sh/skills trong thư mục guides/writing/case-study-writing.

Sau khi cài đặt, hãy mở:

• SKILL.md để xem mô tả chuẩn và quy trình workflow
• Các tài liệu hướng dẫn trong guides/writing/case-study-writing để tham khảo cấu trúc chi tiết và ví dụ

Quy trình cốt lõi với STAR

Khi đã cài đặt, bạn có thể nhắc agent sử dụng case-study-writing bất cứ khi nào bạn đề cập đến các cụm trigger như case study, customer story, success story, B2B case study hoặc client testimonial.

Một quy trình điển hình gồm:

1. Thu thập đầu vào
   Cung cấp cho agent:

   • Tên khách hàng và ngành (hoặc phiên bản ẩn danh tương đương)
   • Sản phẩm hoặc dịch vụ họ đã sử dụng
   • Thách thức chính và các số liệu đã biết
   • Trích dẫn hoặc ghi chú từ phỏng vấn, nếu có

2. Nghiên cứu bối cảnh khách hàng (tùy chọn, qua infsh)
   SKILL guide minh họa cách dùng inference.sh CLI để nghiên cứu bên ngoài. Ví dụ:

   infsh login
   
   # Research the customer's industry
   infsh app run tavily/search-assistant --input '{
     "query": "SaaS customer onboarding challenges 2024 statistics"
   }'
   

   Bạn có thể điều chỉnh truy vấn này cho ngành của khách hàng (ví dụ: manufacturing, fintech, ecommerce) để thu thập số liệu và xu hướng mới nhất, làm mạnh thêm phần Situation và Task.

3. Viết nháp theo cấu trúc STAR
   Kỹ năng đề xuất cấu trúc và độ dài gần đúng như sau:

   • Situation (100–150 từ) – Khách hàng là ai, bối cảnh của họ, và vì sao hiện trạng không còn phù hợp.
   • Task (100–150 từ) – Thách thức hoặc mục tiêu cụ thể, mô tả bằng ngôn ngữ kinh doanh (ví dụ: giảm churn, cải thiện chất lượng lead, rút ngắn onboarding).
   • Action (200–300 từ) – Giải pháp đã triển khai, cách hoạt động, và các bước triển khai chính làm nổi bật sản phẩm hoặc dịch vụ của bạn.
   • Result (100–200 từ) – Kết quả đo lường được với so sánh trước/sau, mốc thời gian và KPI chính.

   Trong prompt, hãy yêu cầu agent:

   • Tuân theo khung STAR theo đúng thứ tự
   • Giữ tổng độ dài trong khoảng 800–1200 từ
   • Tách bạch rõ từng phần

4. Bổ sung số liệu, yếu tố minh họa và trích dẫn
   Mô tả kỹ năng nhấn mạnh:

   • Trình bày số liệu – Yêu cầu agent làm nổi bật các số liệu như tỷ lệ chuyển đổi, tác động doanh thu, thời gian tiết kiệm được hoặc tỉ lệ lỗi giảm. Hỏi agent đề xuất các ý tưởng visual đơn giản (ví dụ: biểu đồ cột trước/sau, biểu đồ funnel) để designer có thể triển khai sau.
   • Trích dẫn khách hàng – Nếu bạn cung cấp ghi chú phỏng vấn thô, hãy yêu cầu agent đề xuất 1–3 câu trích dẫn đắt giá, bám theo các phần Task, Action và Result.

5. Lên kế hoạch định dạng phân phối
   Khi câu chuyện chính đã được duyệt, bạn có thể yêu cầu agent (với cùng ngữ cảnh skill) chuyển thể case study thành:

   • Đề cương one-page sales PDF
   • Tiêu đề slide cho sales deck
   • Bài đăng social ngắn nhấn mạnh kết quả chính
   • Đoạn tóm tắt case study cho website hoặc blog

Tùy chỉnh kỹ năng theo workflow của bạn

Repository khuyến nghị xem kỹ năng này như một workflow template, không phải kịch bản cứng nhắc. Bạn có thể:

• Điều chỉnh độ dài từng phần nếu ngành của bạn cần chiều sâu kỹ thuật nhiều hơn
• Thay thế bằng công cụ nghiên cứu hoặc nguồn dữ liệu riêng của bạn thay cho ví dụ tavily/search-assistant
• Tích hợp dàn ý STAR vào CMS hoặc template proposal nội bộ

Khi cấu hình agent, hãy map các cụm từ kích hoạt bạn ưa dùng (ví dụ: “draft customer success story” hoặc “write SaaS onboarding case study”) với case-study-writing để workflow được kích hoạt nhất quán cho cả team.

Câu hỏi thường gặp (FAQ)

Kỹ năng case-study-writing thực sự làm gì?

Kỹ năng case-study-writing dẫn dắt agent của bạn qua một quy trình viết case study B2B có cấu trúc theo khung STAR. Nó tập trung vào bối cảnh dựa trên nghiên cứu, định nghĩa vấn đề rõ ràng, giải thích chi tiết giải pháp của bạn, và kết quả được chứng minh bằng số liệu, trích dẫn và gợi ý yếu tố minh họa.

Tôi cài đặt case-study-writing như thế nào?

Chạy lệnh:

npx skills add https://github.com/inferen-sh/skills --skill case-study-writing

Sau đó mở SKILL.md trong repository đã cài để xem hướng dẫn đầy đủ, bao gồm Quick Start và bảng khung STAR.

Tôi có bắt buộc phải dùng inference.sh CLI (infsh) không?

SKILL guide minh họa các lệnh ví dụ sử dụng inference.sh CLI (infsh) để thực hiện nghiên cứu với tavily/search-assistant. Điều này được khuyến nghị nếu bạn muốn tự động hóa phần nghiên cứu ngành, nhưng bạn cũng có thể:

• Chạy các luồng nghiên cứu tương tự bằng công cụ riêng, hoặc
• Cung cấp cho agent phần nghiên cứu bạn đã thu thập sẵn.

Bản thân cấu trúc case-study-writing (khung STAR và hướng dẫn số lượng từ) vẫn có thể áp dụng mà không cần infsh.

Tôi nên chuẩn bị thông tin gì để có kết quả tốt nhất?

Để tạo case study mạnh với kỹ năng case-study-writing, hãy chuẩn bị:

• Thông tin nền về khách hàng (ngành, quy mô, vị trí, cách họ sử dụng sản phẩm)
• Thách thức hoặc mục tiêu kinh doanh chính
• Chi tiết triển khai (cách sản phẩm/dịch vụ của bạn được sử dụng)
• Kết quả định lượng (KPI trước và sau)
• Bất kỳ ghi chú phỏng vấn hoặc trích dẫn khách hàng nào

Đầu vào càng phong phú, case study cuối cùng sẽ càng cụ thể và đáng tin cậy.

Tôi có thể dùng case-study-writing cho câu chuyện không phải B2B không?

Kỹ năng này được tối ưu cho bối cảnh B2B với các chỉ số kinh doanh đo lường được. Bạn vẫn có thể điều chỉnh cho B2C hoặc các câu chuyện thay đổi nội bộ, nhưng cấu trúc, giọng điệu và trọng tâm KPI được thiết kế riêng cho case study B2B.

Case study hoàn chỉnh sẽ dài khoảng bao nhiêu?

Theo hướng dẫn khung STAR trong repository, độ dài khuyến nghị là 800–1200 từ. Đây thường là mức đủ để trình bày bối cảnh, giải thích giải pháp và chứng minh kết quả mà không khiến người đọc bị quá tải.

Kỹ năng này có phù hợp để viết bài mạng xã hội hoặc quảng cáo không?

case-study-writing chủ yếu là một workflow dạng báo cáo, dài hơi. Nó rất phù hợp để tạo case study đầy đủ, sau đó bạn có thể tái sử dụng thành:

• Các đoạn trích ngắn cho social media
• Email tiếp cận khách hàng cho đội sales
• Slide hoặc one-pager

Nếu cần content thuần quảng cáo hoặc social ngắn, bạn có thể kết hợp kỹ năng này với các kỹ năng copywriting chuyên biệt hơn, và dùng case study như nguồn nội dung gốc.

Tôi có thể xem toàn bộ file và quy tắc của kỹ năng này ở đâu?

Sau khi cài đặt, hãy mở thư mục skill trong môi trường của bạn để xem:

• SKILL.md – mô tả chính và hướng dẫn sử dụng
• Các tài liệu bổ sung trong guides/writing/case-study-writing

Dùng tab Files trong Agent Skills Finder hoặc editor local của bạn để xem toàn bộ cây thư mục, bao gồm mọi reference lồng nhau hoặc tài liệu hỗ trợ mà repository cung cấp.