job-stories

Tổng quan về skill job-stories

Skill job-stories giúp bạn biến ý tưởng sản phẩm còn thô thành job story theo JTBD, với mẫu: “Khi [tình huống], tôi muốn [động lực], để tôi có thể [kết quả].” Skill này hữu ích nhất khi bạn cần backlog item rõ hơn, lập kế hoạch yêu cầu tốt hơn, hoặc một cách diễn đạt chung về ngữ cảnh người dùng trước khi bước vào thiết kế giải pháp.

Skill này phù hợp nhất cho việc gì

Hãy dùng job-stories khi bạn đã biết khu vực tính năng nhưng cần làm sắc nét hơn vấn đề của người dùng đứng sau nó. Skill này phù hợp với product manager, designer, analyst và các AI agent đang soạn yêu cầu từ link thiết kế, prompt về tính năng, hoặc ghi chú từ stakeholder.

Vì sao nó khác một prompt chung chung

Giá trị chính nằm ở cấu trúc: nó buộc mô hình bắt đầu từ tình huống và động lực, rồi mới thêm tiêu chí chấp nhận gắn với kết quả có thể quan sát được. Nhờ vậy, job-stories hữu ích hơn nhiều so với prompt kiểu “viết user stories” chung chung khi team quan tâm đến bối cảnh, mục đích và kết quả có thể kiểm thử.

Khi nào đây là lựa chọn phù hợp

Skill này rất hợp cho job-stories for Requirements Planning, giai đoạn shaping backlog trước discovery, và việc chuyển các khái niệm tính năng thành story đặt người dùng làm trung tâm. Nó kém hữu ích hơn nếu bạn chỉ cần một danh sách ý tưởng ngắn gọn ở mức câu, không cần acceptance criteria, hoặc nếu team của bạn dùng hẳn một định dạng yêu cầu khác.

Cách dùng skill job-stories

Cài đặt và kích hoạt đúng cách

Với job-stories install, hãy dùng bộ nạp skill mặc định của thư mục: npx skills add phuryn/pm-skills --skill job-stories. Sau đó, hãy gọi skill với đủ ngữ cảnh để mô hình suy ra tình huống người dùng, khu vực sản phẩm và kết quả mong muốn. Chỉ ném vào một tên tính năng đơn lẻ thường là quá ít.

Đưa vào đúng dạng đầu vào

Skill này hoạt động tốt nhất khi prompt có đủ sản phẩm, tính năng, ngữ cảnh người dùng và bất kỳ tham chiếu thiết kế nào. Một prompt khởi đầu tốt sẽ như: “Create job stories for [product] feature [feature] using these user situations: [context]. Use the design link [design] and focus on outcomes, not roles.” Cách này tốt hơn nhiều so với “write job stories for checkout.”

Đọc các file này trước

Hãy bắt đầu với SKILL.md vì file này chứa workflow, mẫu story và các tham số bắt buộc. Nếu bản copy nội bộ của bạn có tài liệu đi kèm, hãy đọc tiếp README.md, AGENTS.md và metadata.json, cùng mọi thư mục rules/, resources/, references/ hoặc scripts/. Trong repo này, SKILL.md là nguồn sự thật chính, nên phần cần rà soát thêm không nhiều.

Mẹo workflow giúp đầu ra tốt hơn

Hãy dùng skill theo hai lượt: trước tiên để lấy job stories thô, sau đó tinh chỉnh theo các ràng buộc thực tế của bạn. Nếu đầu ra đầu tiên còn mơ hồ, hãy bổ sung tình huống cụ thể, điểm ra quyết định và link thiết kế. Nếu story nghe quá nặng về vai trò, hãy yêu cầu viết lại theo hướng đặt trọng tâm vào trigger và tiến triển mong muốn thay vì persona.

Câu hỏi thường gặp về skill job-stories

job-stories có phù hợp cho Requirements Planning không?

Có. job-stories được thiết kế cho requirements planning khi bạn muốn backlog item đặt người dùng làm trung tâm thay vì ticket đi từ tính năng trước. Nó giúp chuyển phạm vi công việc thành tình huống, động lực và kết quả, để team dễ trao đổi hơn với thiết kế và engineering.

Tôi có cần file thiết kế để dùng hiệu quả không?

Không bắt buộc, nhưng skill job-stories sẽ mạnh hơn khi bạn cung cấp một link. Một link Figma hoặc Miro giúp mô hình bám vào hành vi có thể nhìn thấy thay vì tự bịa giả định.

Nó khác user story thông thường ở điểm nào?

Prompt thông thường thường tạo ra mẫu theo vai trò hoặc acceptance criteria nông. Skill job-stories phù hợp hơn khi quyết định quan trọng là vì sao người dùng hành động và họ cần đạt được kết quả gì, chứ không chỉ là hệ thống nên làm gì.

Có thân thiện với người mới không?

Có, nếu bạn có thể mô tả tính năng bằng ngôn ngữ bình thường. Hạn chế chính nằm ở chất lượng đầu vào: người mới sẽ có kết quả tốt hơn khi cung cấp một hoặc hai tình huống người dùng thực tế thay vì một chủ đề tính năng quá rộng.

Cách cải thiện skill job-stories

Cung cấp tình huống giàu ngữ cảnh hơn, không chỉ tên tính năng

Mức cải thiện chất lượng lớn nhất đến từ ngữ cảnh cụ thể. Thay vì chỉ nói “notifications,” hãy đưa ra một tình huống như “When a user misses a payment reminder while traveling” để job-stories có thể tạo ra chuỗi tình huống, động lực và kết quả có ý nghĩa.

Thêm ràng buộc và tín hiệu thành công

Nếu bạn quan tâm đến accessibility, timing, giới hạn thiết bị hoặc luồng phê duyệt, hãy nêu rõ ngay từ đầu. Acceptance criteria sẽ mạnh hơn khi prompt giải thích thành công trông như thế nào, điều gì phải quan sát được, và điều gì sẽ khiến story thất bại.

Yêu cầu sửa theo kiểu lỗi cụ thể

Nếu bản nháp đầu tiên quá chung chung, hãy yêu cầu giảm bớt tham chiếu vai trò và thêm chi tiết tình huống. Nếu nó quá nặng về giải pháp, hãy yêu cầu job stories tránh ngôn ngữ triển khai. Nếu nó quá rộng, hãy thu hẹp tính năng xuống một mục tiêu người dùng tại một thời điểm.

Dùng đầu ra đầu tiên như bản nháp cho kế hoạch

Hãy xem lượt đầu như công cụ khám phá, không phải yêu cầu cuối cùng. Cách dùng job-stories hiệu quả nhất là lặp lại cho đến khi story khớp với roadmap, design và ràng buộc engineering của bạn, rồi lược bỏ mọi phần không thực sự giúp cho Requirements Planning hoặc triển khai.