product-marketing-context

Tổng quan về skill product-marketing-context

product-marketing-context làm gì

Skill product-marketing-context giúp bạn tạo và duy trì một file nguồn dùng chung cho product marketing tại .agents/product-marketing-context.md. Nhiệm vụ của nó đơn giản nhưng rất có giá trị: ghi lại một lần các nội dung cốt lõi như tổng quan sản phẩm, đối tượng mục tiêu, định vị, phản đối thường gặp, bằng chứng thuyết phục và nền tảng thông điệp để những workflow marketing khác có thể tái sử dụng, thay vì phải hỏi lại cùng một nhóm câu hỏi nền tảng mỗi lần.

Ai nên dùng skill này

Skill này đặc biệt phù hợp với founder, product marketer, growth lead và agency cần triển khai công việc marketing có AI hỗ trợ theo cách lặp lại được trên một repo hoặc dự án khách hàng. Nó đặc biệt hữu ích nếu bạn muốn giữ thông điệp nhất quán giữa các đầu việc như định vị, xây ICP, viết nháp landing page, lập kế hoạch campaign hoặc tài liệu sales enablement.

Công việc thực sự mà skill này giải quyết

Phần lớn team không cần “nhiều câu chữ hơn”. Họ cần một lớp ngữ cảnh ổn định để model tham chiếu trước khi viết bất cứ thứ gì. product-marketing-context skill được thiết kế chính xác cho bước thiết lập đó. Nó tạo ra một tài liệu ngữ cảnh marketing có thể tái sử dụng trước, rồi các skill khác mới xây tiếp trên nền này.

Vì sao cách này tốt hơn một prompt chung chung

Một prompt thông thường có thể yêu cầu định vị, nhưng thường chỉ cho ra câu trả lời dùng một lần. product-marketing-context được tổ chức quanh các nguyên tắc sau:

• luôn kiểm tra xem đã có file context hay chưa
• chỉ cập nhật những phần thực sự thay đổi
• hỗ trợ auto-draft từ codebase hoặc đi theo luồng hướng dẫn tạo từ đầu
• lưu kết quả vào một đường dẫn file cố định để các skill khác có thể tham chiếu

Vì vậy, nó mang tính vận hành thực tế hơn nhiều so với kiểu prompt chung chung như “giúp tôi làm messaging”.

Trường hợp phù hợp và không phù hợp

Phù hợp nhất:

• sản phẩm mới chưa có nền tảng messaging rõ ràng
• repo dự kiến sẽ dùng nhiều AI marketing skill
• team đang cập nhật định vị sau khi ra mắt, đổi giá hoặc thay đổi đối tượng mục tiêu

Ít phù hợp:

• các tác vụ viết copy một lần rồi thôi, không cần lưu context lâu dài
• sản phẩm không có repo hoặc tài liệu sản phẩm đủ để kiểm tra
• team kỳ vọng chỉ riêng skill này sẽ làm luôn phần nghiên cứu thị trường chuyên sâu

Cách dùng skill product-marketing-context

Bối cảnh cài đặt và nơi file được lưu

Nếu môi trường của bạn hỗ trợ cài Skills, hãy thêm repository cha và dùng skill product-marketing-context từ đó. File đầu ra mà skill này xoay quanh là:

/.agents/product-marketing-context.md

Skill cũng sẽ kiểm tra .claude/product-marketing-context.md cho các thiết lập cũ và có thể hỗ trợ chuyển nội dung đó sang cấu trúc mới.

Bắt đầu bằng việc kiểm tra file context hiện có

Trước khi tạo mới bất cứ thứ gì, workflow đúng là tìm:

• .agents/product-marketing-context.md
• .claude/product-marketing-context.md

Nếu file context đã tồn tại, cách làm đúng không phải là “viết lại toàn bộ”. Hãy đọc file đó, tóm tắt những gì đã được ghi nhận, rồi chỉ cập nhật những phần bị ảnh hưởng bởi thay đổi mới từ người dùng.

Chọn đúng hướng thiết lập

Repository này cho thấy hai cách bắt đầu thực tế:

1. Auto-draft from codebase
   Nên dùng khi repo có đủ tín hiệu hữu ích như README.md, nội dung landing page, tài liệu docs, package.json hoặc product copy trong ứng dụng.

2. Start from scratch
   Phù hợp hơn khi repo còn mỏng, tài liệu nội bộ quan trọng hơn code, hoặc bản thân sản phẩm vẫn đang trong giai đoạn định hình.

Đây là một trong những chi tiết quan trọng nhất khi áp dụng product-marketing-context guide: kết quả sẽ tốt hơn rõ rệt nếu bạn chọn đúng hướng dựa trên chất lượng bằng chứng hiện có.

product-marketing-context cần những đầu vào gì

Để có đầu ra hữu ích, tối thiểu hãy cung cấp:

• sản phẩm là gì
• sản phẩm dành cho ai
• vấn đề chính mà nó giải quyết
• nó khác gì so với các lựa chọn thay thế
• các proof point hoặc ràng buộc hiện tại
• đây là bản nháp đầu tiên hay một lần cập nhật

Đầu vào bổ sung hữu ích:

• thay đổi về pricing tier
• persona mới
• mẫu thắng/thua trong bán hàng
• ngôn ngữ khách hàng dùng trong cuộc gọi hoặc review
• ưu tiên về brand voice
• phản đối từ phía sales
• mục tiêu theo đợt launch hoặc theo quý

Những phần mà skill này cố gắng xây dựng

Dựa trên evals và workflow trong repository, bạn có thể kỳ vọng luồng product-marketing-context usage sẽ bao phủ các phần như:

• Product Overview
• Target Audience
• Personas
• Problems You Solve
• Competitive Landscape
• Differentiation
• Objections
• Switching Dynamics
• Customer Language
• Brand Voice
• Proof Points
• Goals

Cấu trúc này rất quan trọng vì nó tạo ra một file context bền vững, chứ không chỉ là một đoạn định vị ngắn.

Biến một yêu cầu mơ hồ thành prompt mạnh

Yếu:

Help me with product marketing.

Tốt hơn:

Use the product-marketing-context skill. Check whether .agents/product-marketing-context.md already exists. If not, auto-draft a V1 from the repo and website copy. Capture product overview, ICP, personas, key pain points, differentiation, objections, proof points, customer language, and brand voice. Flag assumptions clearly so I can review them.

Tốt nhất cho trường hợp cập nhật:

Use the product-marketing-context skill to update our existing context. We added an enterprise tier and now sell to VP of Engineering in addition to Product Managers. Read .agents/product-marketing-context.md, tell me which sections need revision, then update only those sections and preserve everything still valid.

Một workflow thực tế giúp giảm đoán mò

Một chuỗi làm việc hiệu quả thường là:

1. Kiểm tra file context hiện có.
2. Quyết định dùng auto-draft hay phỏng vấn có hướng dẫn.
3. Tạo mới hoặc cập nhật file context theo từng phần.
4. Đánh dấu các giả định và các chỗ còn thiếu bằng chứng.
5. Review cùng người dùng để chỉnh sửa.
6. Lưu vào .agents/product-marketing-context.md.
7. Tái sử dụng file đó cho các tác vụ marketing về sau.

Đây là lý do chính để thực hiện product-marketing-context install sớm trong dự án: nó giảm đáng kể công sức thiết lập lặp đi lặp lại ở các bước sau.

Nên đọc các file repository này trước

Để đánh giá nhanh, hãy bắt đầu với:

• skills/product-marketing-context/SKILL.md
• skills/product-marketing-context/evals/evals.json

SKILL.md giải thích workflow vận hành. evals/evals.json đặc biệt hữu ích vì nó cho thấy “cách dùng đúng” trông như thế nào trong các prompt thực tế, bao gồm cả các tình huống cập nhật sau khi sản phẩm thay đổi.

Điều gì thực sự nâng chất lượng đầu ra

Kết quả tốt nhất đến từ bằng chứng, không phải kỳ vọng. Nếu muốn có một context doc mạnh hơn, hãy trỏ skill tới các nguồn như:

• nội dung homepage hoặc landing page
• tài liệu sản phẩm và phần text onboarding
• ghi chú transcript demo
• mô tả pricing và các gói
• trích dẫn từ phỏng vấn khách hàng
• các so sánh với đối thủ mà team thực sự đang dùng
• phản đối thường gặp trong sales call
• brand guideline hiện có

Nếu thiếu các nguồn này, bản nháp vẫn có thể dùng được, nhưng sẽ chứa nhiều giả định chung chung hơn.

Kỳ vọng gì ở bản nháp đầu tiên

Một bản V1 được tạo bằng product-marketing-context nên được xem là tài liệu đang làm việc, không phải chân lý cuối cùng. Bản nháp hữu ích nhất sẽ:

• tách bạch sự thật đã xác nhận với phần định vị được suy luận
• chỉ ra rõ những khoảng trống về proof point hoặc độ rõ ràng của đối tượng mục tiêu
• cung cấp đủ cấu trúc để các tác vụ AI marketing phía sau vẫn giữ được tính nhất quán

Nếu bạn muốn có messaging chiến lược trau chuốt, hãy chuẩn bị ít nhất một vòng review sau khi file ban đầu được tạo.

Câu hỏi thường gặp về skill product-marketing-context

product-marketing-context có phù hợp cho người mới bắt đầu không?

Có. Skill này thân thiện với người mới vì workflow rất rõ ràng: kiểm tra file hiện có, chọn auto-draft hoặc guided setup, rồi điền vào các phần cụ thể. Bạn không cần nắm các framework PMM chính quy vẫn có thể tạo ra phiên bản đầu tiên dùng được.

Khi nào nên dùng product-marketing-context thay vì prompt thông thường?

Hãy dùng khi bạn muốn có ngữ cảnh tái sử dụng được cho nhiều tác vụ. Nếu mục tiêu chỉ là viết một headline cho landing page, prompt thường có thể đã đủ. Nhưng nếu mục tiêu là giữ thông điệp nhất quán trên nhiều đầu ra, thì product-marketing-context for Product Marketing là nền tảng tốt hơn.

Nó có thể cập nhật context hiện có thay vì tạo lại từ đầu không?

Có. Đây là một hành vi cốt lõi. Skill được thiết kế để đọc file .agents/product-marketing-context.md hiện có, tóm tắt những gì đã có sẵn, rồi chỉ chỉnh sửa những phần bị tác động bởi thông tin mới.

Skill này có làm nghiên cứu thị trường thay tôi không?

Không hẳn. Nó có thể suy ra khá nhiều từ repo và tài liệu sản phẩm, nhưng không thay thế được nghiên cứu khách hàng. Nếu bằng chứng đầu vào yếu, đầu ra vẫn hữu ích về mặt cấu trúc nhưng sẽ mỏng hơn về chiều sâu chiến lược.

Nếu repo của tôi gần như không có marketing copy thì sao?

Hãy chọn hướng start-from-scratch và trả lời các câu hỏi theo cách hội thoại. Cách này thường tốt hơn việc cố ép một bản auto-draft từ codebase quá ít tín hiệu về khách hàng, phản đối hay bối cảnh mua hàng.

product-marketing-context chỉ hữu ích trong hệ sinh thái repo này thôi sao?

Nó có giá trị cao nhất khi đi cùng các marketing skill khác cùng tham chiếu tới .agents/product-marketing-context.md, nhưng bản thân file này vẫn có thể mang đi dùng ở nơi khác. Bạn vẫn có thể xem nó là PMM brief chuẩn của mình ngay cả khi không dùng toàn bộ hệ skill.

Khi nào skill này là lựa chọn không phù hợp?

Bỏ qua nếu:

• bạn chỉ cần một đầu ra copy đơn lẻ, tách biệt
• team của bạn sẽ không duy trì một file context dùng chung
• sản phẩm của bạn còn quá mơ hồ để trả lời các câu hỏi cơ bản về đối tượng và vấn đề

Cách cải thiện skill product-marketing-context

Hãy cung cấp bằng chứng cho skill, không chỉ nêu mục tiêu

Nâng cấp lớn nhất cho chất lượng của product-marketing-context skill đến từ nguồn tư liệu tốt hơn. Chỉ nói “chúng tôi muốn định vị mạnh hơn” là chưa đủ. Hãy cung cấp đầu vào thô như:

• nội dung homepage
• ghi chú cuộc gọi với khách hàng
• các phản đối hàng đầu từ team sales
• lý do khách hàng chuyển sang dùng sản phẩm
• giải thích feature-to-benefit
• proof point có số liệu

Nhờ vậy model có thể bám vào dữ kiện thay vì tự bịa ra luận điểm.

Nói rõ chính xác điều gì đã thay đổi

Khi cập nhật, đừng yêu cầu refresh toàn bộ nếu thực tế chỉ có hai điểm thay đổi. Hãy nói rõ cái mới là gì:

• pricing tier mới
• ICP được mở rộng
• category được đổi tên
• tập trung mạnh hơn vào enterprise
• áp lực cạnh tranh mới

Cách này giúp skill cập nhật đúng phần cần sửa mà không vô tình làm suy yếu những thông điệp vẫn còn đúng.

Yêu cầu gắn nhãn cho các giả định

Một lỗi phổ biến là suy đoán bị ẩn đi. Để nâng chất lượng đầu ra, hãy yêu cầu model đánh dấu:

• confirmed facts
• likely inferences
• missing inputs
• questions for review

Làm vậy sẽ giúp bản nháp đầu tiên dễ duyệt và dễ tinh chỉnh hơn nhiều.

Review theo từng phần để có đầu ra cuối tốt hơn

Đừng đợi đến cuối mới review toàn bộ tài liệu. Những phần có giá trị cao nhất cần xác nhận sớm là:

• Target Audience
• Problems You Solve
• Differentiation
• Objections
• Proof Points

Nếu những phần này sai, toàn bộ messaging được xây tiếp trên file đó cũng sẽ lệch theo.

Tăng chất lượng phần customer language

Một điểm yếu thường gặp là câu chữ quá chung chung. Để cải thiện product-marketing-context guide trong thực tế, hãy cung cấp cho nó chính xác những cụm từ mà khách hàng thực sự dùng trong:

• phỏng vấn
• support tickets
• trang review
• cuộc gọi sales
• phản hồi onboarding

Ngôn ngữ khách hàng thật giúp tăng độ liên quan của copy ở các bước sau lên rất rõ.

Cẩn thận với các lỗi phổ biến này

Các vấn đề thường gặp gồm:

• danh sách tính năng được ngụy trang thành định vị
• ICP quá rộng
• khác biệt hóa yếu trước các “đối thủ” mơ hồ
• brand voice mang tính kỳ vọng nhưng không có ví dụ cụ thể
• proof point chỉ là tuyên bố, không phải bằng chứng

Nếu thấy các dấu hiệu này, hãy chỉnh lại nguồn đầu vào trước khi yêu cầu viết lại.

Lặp lại bằng các prompt follow-up có mục tiêu rõ ràng

Sau bản nháp đầu tiên, hãy dùng các prompt tập trung như:

• “Narrow the ICP to the most likely first buyer.”
• “Rewrite objections based on enterprise procurement concerns.”
• “Separate direct competitors from status-quo alternatives.”
• “Turn proof points into evidence-backed bullets only.”

Việc lặp lại có mục tiêu sẽ cải thiện tài liệu nhanh hơn nhiều so với yêu cầu viết lại toàn bộ.

Duy trì product-marketing-context như một file sống

Cách dùng product-marketing-context hiệu quả nhất về lâu dài là duy trì liên tục, không phải thiết lập một lần rồi bỏ đó. Hãy xem lại file mỗi khi sản phẩm, đối tượng, pricing, category hoặc sales motion của bạn thay đổi. Nhờ vậy, mọi tác vụ marketing về sau sẽ luôn bám sát thực tế hiện tại thay vì dựa trên các giả định đã cũ.