Tìm hiểu cách kết hợp Claude và ChatGPT để xây dựng tài liệu đặc tả yêu cầu phần mềm rõ ràng, đầy đủ và dễ triển khai. Hướng dẫn quy trình thực hiện, cách viết yêu cầu chức năng, tiêu chí nghiệm thu và những lưu ý giúp doanh nghiệp tiết kiệm thời gian phát triển phần mềm.
Từ khóa chính: Kết hợp Claude và ChatGPT xây dựng tài liệu đặc tả yêu cầu phần mềm
1. Tài liệu đặc tả yêu cầu phần mềm là gì?
Tài liệu đặc tả yêu cầu phần mềm (Software Requirements Specification, viết tắt là SRS) là tài liệu mô tả chi tiết những gì một phần mềm cần thực hiện, cách hệ thống hoạt động và các điều kiện mà sản phẩm phải đáp ứng. Đây là cơ sở để đội ngũ phát triển, kiểm thử và khách hàng hiểu thống nhất về sản phẩm trước khi bắt đầu triển khai.
Một tài liệu SRS thường bao gồm các nội dung chính:
- Mục tiêu dự án: Vấn đề cần giải quyết và đối tượng sử dụng phần mềm.
- Yêu cầu chức năng: Những tính năng hệ thống cần có, chẳng hạn như đăng nhập, quản lý đơn hàng hoặc thanh toán.
- Yêu cầu phi chức năng: Các tiêu chí về hiệu suất, bảo mật, khả năng mở rộng và tính ổn định.
- Luồng hoạt động: Cách người dùng tương tác với hệ thống trong từng tình huống.
- Quy tắc nghiệp vụ: Những điều kiện mà hệ thống phải tuân thủ khi xử lý dữ liệu.
- Tiêu chí nghiệm thu: Điều kiện để xác định một tính năng đã được phát triển đúng yêu cầu.
Trong thực tế, việc xây dựng tài liệu đặc tả thường mất nhiều thời gian vì thông tin đầu vào có thể nằm rải rác trong các cuộc họp, email, tài liệu nghiệp vụ và trao đổi với khách hàng. Nếu yêu cầu không được diễn đạt rõ ràng, đội ngũ phát triển dễ hiểu sai, dẫn đến sửa đổi nhiều lần và kéo dài tiến độ dự án.
Đây là lúc Claude và ChatGPT có thể hỗ trợ. Hai công cụ AI có thể giúp phân tích thông tin, sắp xếp yêu cầu, phát hiện điểm chưa rõ và chuẩn hóa cách trình bày tài liệu. Tuy nhiên, chúng không thể tự xác định chính xác mọi quy tắc nghiệp vụ nếu người dùng chưa cung cấp đủ dữ liệu.
2. Vì sao nên kết hợp Claude và ChatGPT khi viết tài liệu SRS?
Claude và ChatGPT đều có khả năng xử lý văn bản, phân tích thông tin và hỗ trợ soạn thảo tài liệu. Tuy nhiên, thay vì giao toàn bộ công việc cho một công cụ, doanh nghiệp có thể phân chia nhiệm vụ để tận dụng điểm mạnh của từng công cụ.
Sử dụng Claude để phân tích yêu cầu và xử lý tài liệu đầu vào
Claude có thể hỗ trợ đọc, tổng hợp và phân tích các tài liệu dài như biên bản họp, mô tả nghiệp vụ, tài liệu quy trình hoặc phản hồi của khách hàng. Từ những thông tin này, người dùng có thể yêu cầu Claude xác định các nhóm yêu cầu, tìm điểm chưa thống nhất và đề xuất những câu hỏi cần làm rõ.
Ví dụ, khi xây dựng phần mềm quản lý bán hàng, doanh nghiệp cung cấp cho Claude tài liệu mô tả quy trình đặt hàng, thanh toán và giao hàng. AI có thể giúp tổng hợp các bước xử lý, xác định vai trò của nhân viên và khách hàng, đồng thời chỉ ra những thông tin còn thiếu như điều kiện hủy đơn hoặc cách xử lý khi thanh toán thất bại.
Sử dụng ChatGPT để chuẩn hóa và hoàn thiện tài liệu
Sau khi có bản tổng hợp yêu cầu ban đầu, ChatGPT có thể hỗ trợ chuyển các ý tưởng thành cấu trúc tài liệu SRS rõ ràng hơn. Người dùng có thể yêu cầu viết yêu cầu chức năng theo mã định danh, xây dựng bảng quy tắc nghiệp vụ, tạo user story hoặc đề xuất tiêu chí nghiệm thu.
Chẳng hạn, yêu cầu “khách hàng có thể đặt hàng trực tuyến” còn khá chung chung. ChatGPT có thể giúp phát triển yêu cầu này thành các nội dung cụ thể hơn:
- FR-001: Hệ thống cho phép khách hàng thêm sản phẩm còn hàng vào giỏ.
- FR-002: Hệ thống kiểm tra thông tin giao hàng trước khi xác nhận đơn.
- FR-003: Hệ thống thông báo kết quả đặt hàng sau khi hoàn tất xử lý.
- AC-001: Đơn hàng chỉ được tạo khi thông tin bắt buộc hợp lệ và sản phẩm đáp ứng điều kiện đặt hàng.
Các ví dụ trên cần được điều chỉnh theo quy trình thực tế của dự án. Không nên xem nội dung do AI đề xuất là yêu cầu đã được phê duyệt nếu chưa có sự xác nhận của người phụ trách nghiệp vụ.
3. Quy trình kết hợp Claude và ChatGPT để xây dựng tài liệu đặc tả yêu cầu phần mềm
Để tránh tình trạng tài liệu dài nhưng thiếu chính xác, doanh nghiệp nên sử dụng AI theo một quy trình có kiểm soát. Mỗi bước cần có đầu vào, kết quả đầu ra và người chịu trách nhiệm kiểm tra.
Bước 1: Thu thập và chuẩn bị thông tin đầu vào
Trước tiên, hãy tập hợp các thông tin liên quan đến dự án, bao gồm mục tiêu phần mềm, đối tượng sử dụng, quy trình nghiệp vụ hiện tại, yêu cầu từ khách hàng và các giới hạn về công nghệ hoặc ngân sách.
Bạn có thể sử dụng Claude để tổng hợp tài liệu và phân loại thông tin thành ba nhóm:
- Yêu cầu đã được xác nhận.
- Giả định cần kiểm chứng.
- Câu hỏi chưa có câu trả lời.
Cách phân loại này giúp tránh việc AI tự bổ sung những chi tiết chưa được khách hàng thống nhất.
Bước 2: Dùng Claude phân tích và tìm điểm còn thiếu
Sau khi chuẩn bị dữ liệu, hãy yêu cầu Claude phân tích yêu cầu theo từng nhóm chức năng. Ngoài việc tóm tắt, cần yêu cầu công cụ xác định những trường hợp ngoại lệ, mâu thuẫn và thông tin còn thiếu.
Ví dụ, với chức năng đăng nhập, các câu hỏi cần làm rõ có thể gồm: Người dùng được đăng nhập bằng email hay số điện thoại? Điều gì xảy ra khi nhập sai mật khẩu nhiều lần? Có cần xác thực hai bước không? Hệ thống xử lý tài khoản bị khóa như thế nào?
Kết quả của bước này là danh sách yêu cầu sơ bộ và các vấn đề cần được người phụ trách xác nhận.
Bước 3: Dùng ChatGPT xây dựng bản SRS có cấu trúc
Từ kết quả đã được rà soát, hãy sử dụng ChatGPT để tạo bản dự thảo SRS theo một cấu trúc thống nhất. Tùy quy mô dự án, tài liệu có thể bao gồm:
- Giới thiệu và mục tiêu dự án.
- Phạm vi phần mềm và đối tượng sử dụng.
- Mô tả tổng quan hệ thống.
- Yêu cầu chức năng.
- Yêu cầu phi chức năng.
- Quy tắc nghiệp vụ và luồng xử lý.
- Yêu cầu dữ liệu, tích hợp và bảo mật.
- Tiêu chí nghiệm thu.
Mỗi yêu cầu nên được diễn đạt cụ thể, có mã định danh và có thể kiểm tra được. Chẳng hạn, thay vì viết “hệ thống phải phản hồi nhanh”, hãy xác định thời gian phản hồi mục tiêu và điều kiện đo lường nếu dự án đã thống nhất được các chỉ số này.
Bước 4: Đối chiếu hai công cụ để phát hiện sai sót
Khi đã có bản dự thảo, hãy đưa tài liệu trở lại Claude để kiểm tra tính nhất quán, các phần mâu thuẫn và yêu cầu bị bỏ sót. Sau đó, có thể sử dụng ChatGPT để rà soát cấu trúc, cách diễn đạt và mức độ kiểm thử được của từng yêu cầu.
Để quá trình kiểm tra hiệu quả hơn, hãy yêu cầu AI trình bày kết quả theo bảng:
| Mã yêu cầu | Vấn đề phát hiện | Mức độ ảnh hưởng | Hướng xử lý |
|---|---|---|---|
| FR-001 | Chưa xác định điều kiện đặt hàng | Cao | Xác nhận quy tắc với bộ phận nghiệp vụ |
| FR-002 | Chưa mô tả trường hợp thanh toán thất bại | Cao | Bổ sung luồng xử lý lỗi |
| NFR-001 | Chưa có chỉ số hiệu suất cụ thể | Trung bình | Thống nhất tiêu chí đo lường |
Bảng này là ví dụ minh họa. Các vấn đề thực tế cần được xác định dựa trên tài liệu của dự án, không nên mặc định rằng mọi hệ thống đều có cùng yêu cầu.
Bước 5: Xác nhận yêu cầu với các bên liên quan
Đây là bước không nên bỏ qua. Claude và ChatGPT có thể hỗ trợ phát hiện vấn đề nhưng không thể thay thế quyết định của khách hàng, chuyên viên phân tích nghiệp vụ hoặc kiến trúc sư phần mềm.
Trước khi chốt tài liệu, đội ngũ dự án cần kiểm tra xem từng yêu cầu có đúng với nhu cầu thực tế hay không, có mâu thuẫn với yêu cầu khác không và có thể kiểm thử được không. Những giả định chưa được xác nhận phải được đánh dấu rõ ràng thay vì đưa vào tài liệu như thông tin chính thức.
4. Prompt mẫu và những lưu ý khi sử dụng AI viết tài liệu SRS
Chất lượng tài liệu đầu ra phụ thuộc nhiều vào cách đặt yêu cầu cho AI. Một prompt tốt cần nêu rõ vai trò, mục tiêu, dữ liệu đầu vào, định dạng đầu ra và những giới hạn mà AI phải tuân thủ.
Prompt mẫu dùng với Claude
“Bạn là chuyên viên phân tích nghiệp vụ phần mềm. Hãy phân tích tài liệu đầu vào để xác định mục tiêu hệ thống, nhóm người dùng, yêu cầu chức năng, quy tắc nghiệp vụ và các trường hợp ngoại lệ. Phân biệt rõ thông tin đã được xác nhận, giả định và câu hỏi còn thiếu. Không tự tạo thêm yêu cầu nếu tài liệu chưa cung cấp căn cứ. Trình bày kết quả bằng bảng để đội ngũ dự án dễ rà soát.”
Prompt mẫu dùng với ChatGPT
“Dựa trên danh sách yêu cầu đã được xác nhận dưới đây, hãy xây dựng bản dự thảo tài liệu đặc tả yêu cầu phần mềm SRS. Mỗi yêu cầu cần có mã định danh, mô tả, điều kiện thực hiện và tiêu chí nghiệm thu phù hợp. Phân chia thành yêu cầu chức năng, yêu cầu phi chức năng và quy tắc nghiệp vụ. Nếu thiếu thông tin, hãy ghi rõ nội dung cần xác nhận thay vì tự suy đoán.”
Những lưu ý quan trọng
Để sử dụng Claude và ChatGPT hiệu quả trong quá trình xây dựng SRS, doanh nghiệp cần chú ý một số điểm sau:
- Bảo mật dữ liệu: Không đưa thông tin khách hàng, dữ liệu nội bộ hoặc thông tin nhạy cảm vào công cụ AI khi chưa được phép. Cần tuân thủ chính sách bảo mật của tổ chức và điều khoản dịch vụ đang sử dụng.
- Kiểm soát phiên bản: Lưu lại các phiên bản tài liệu, người chỉnh sửa và những thay đổi quan trọng để tránh nhầm lẫn giữa bản dự thảo và bản đã được phê duyệt.
- Giữ sự nhất quán: Sử dụng thống nhất thuật ngữ, mã yêu cầu và cách trình bày trong toàn bộ tài liệu.
- Không phụ thuộc hoàn toàn vào AI: Nội dung liên quan đến bảo mật, phân quyền, thanh toán và xử lý dữ liệu cần được người có chuyên môn kiểm tra kỹ.
- Đánh giá hiệu quả thực tế: Theo dõi thời gian soạn thảo, số lỗi phát hiện trong quá trình rà soát và số lần phải sửa đổi yêu cầu để xác định AI có thực sự giúp cải thiện quy trình hay không.
Kết luận
Kết hợp Claude và ChatGPT để xây dựng tài liệu đặc tả yêu cầu phần mềm giúp doanh nghiệp rút ngắn thời gian tổng hợp thông tin, chuẩn hóa yêu cầu và phát hiện những điểm chưa rõ trước khi phát triển sản phẩm. Claude có thể hỗ trợ phân tích tài liệu đầu vào, trong khi ChatGPT giúp cấu trúc hóa và hoàn thiện bản dự thảo SRS.
Tuy nhiên, hiệu quả của phương pháp này phụ thuộc vào chất lượng dữ liệu, cách đặt prompt và quy trình kiểm duyệt. Khi được sử dụng đúng cách, AI không thay thế chuyên viên phân tích nghiệp vụ mà trở thành công cụ hỗ trợ để đội ngũ phát triển xây dựng tài liệu rõ ràng, nhất quán và dễ triển khai hơn.
