Đánh giá ý tưởng với Spec Kit

Trước khi bắt đầu

• Cần biết: Spec Kit là gì và bạn phân biệt được "một ý tưởng" với "một tính năng đã được duyệt"; nếu chưa, đọc trước trang Spec Kit là gì?
• Cần có: Spec Kit đã cài trên máy, và một ý tưởng viết được thành một câu
• Cần đang ở: một thư mục dự án đã chạy specify init; dự án rỗng cũng đủ

1. Nhóm này dành cho ai

Nhóm trang này dành cho người đang đứng trước một quyết định: ý tưởng này có đáng bỏ công không. Bạn chưa có kế hoạch triển khai, chưa có thiết kế, và có thể chưa có mã nguồn nào.

Đây là nhóm trang dành cho câu hỏi "có nên làm không". Nếu bạn đã biết chắc phải làm và cần biết làm thế nào, hãy dùng nhóm Xây dựng.

2. Đánh giá độc lập, không cần mã nguồn

Quy trình đánh giá (assessment) chạy được mà không cần mã nguồn. Một dự án rỗng sau specify init là đủ. Nếu ý tưởng gắn với một kho mã đang có, bạn vẫn có thể trỏ tới kho đó để lấy thêm bằng chứng, nhưng đó là lựa chọn chứ không phải điều kiện.

Quy trình này cũng độc lập với SDD. Nó không tự gọi quy trình SDD và không chèn mình vào giữa các bước đặc tả. Không có bước nào trong quy trình đánh giá sửa mã nguồn.

3. Một quyết định "nên làm" không tự khởi động SDD

Kết quả go nghĩa là ý tưởng đáng theo đuổi, không phải là quy trình SDD đã bắt đầu. Việc chuyển sang xây dựng là một quyết định riêng của bạn.

Nếu bạn chọn xây dựng một ý tưởng phần mềm đã có kết quả go, hãy bảo đảm dự án đã có hiến chương (constitution), rồi đưa phần bàn giao trong decision.md sang lệnh đặc tả:

/speckit-specify Dùng phần bàn giao trong .specify/assessments/offline-mode/decision.md để đặc tả khái niệm offline-mode đã được duyệt.

Kết quả mong đợi: công cụ tạo thư mục specs/NNN-*/ chứa spec.md dựa trên phần bàn giao, và từ đây bạn tiếp tục theo nhóm Xây dựng.

Nếu kết quả là needs-clarification hoặc kill, bạn không chạy lệnh trên. Cả hai kết quả đó đều là kết thúc hợp lệ.

4. Đọc theo thứ tự nào

Nhóm này có một trang:

1. Quy trình đánh giá — nắm năm bước intake → research → define → shape → decide, cách cài tiện ích mở rộng (extension) assess, và ba kết quả có thể có.

Đọc hết trang đó là đủ để chạy trọn một lần đánh giá. Khi cần tra cứu chi tiết đối số của từng bước, xem thêm nhóm Tra cứu.

5. Bạn sẽ gặp những thuật ngữ nào

• Ý tưởng (idea): một thay đổi được đề xuất, chưa được chứng minh là đáng làm.
• slug: tên ngắn, không dấu, dùng lại ở cả năm bước. Ví dụ offline-mode.
• Bằng chứng (evidence): thông tin có nguồn, ủng hộ hoặc phản đối ý tưởng. Giả định không có nguồn không phải bằng chứng.
• Khẩu vị (appetite): mức công sức và thời gian bạn sẵn sàng bỏ ra cho ý tưởng.
• Phán quyết (verdict): kết luận cuối cùng, gồm go, needs-clarification, hoặc kill.
• Bàn giao (handoff): phần tóm tắt trong decision.md để chuyển sang bước đặc tả, nếu bạn chọn xây dựng.

Kết quả

Sau khi hoàn thành trang này, bạn đã:

• Biết nhóm Đánh giá phục vụ ai và khác gì nhóm Xây dựng
• Hiểu đánh giá chạy độc lập, không cần mã nguồn
• Hiểu quyết định go không tự khởi động quy trình SDD
• Biết trang cần đọc tiếp theo và sáu thuật ngữ sẽ gặp

Cách tự xác nhận: bạn giải thích được cho đồng nghiệp rằng đánh giá kết thúc bằng một quyết định, không phải bằng mã nguồn hay bản đặc tả.

Lỗi thường gặp

Lỗi	Nguyên nhân	Cách khắc phục
Không thấy thư mục .specify/assessments/	Tiện ích assess chưa được cài	Chạy specify extension add assess theo trang Quy trình đánh giá
Lệnh /speckit-specify báo thiếu hiến chương	Dự án chưa có .specify/memory/constitution.md	Chạy /speckit-constitution trước, rồi chạy lại lệnh đặc tả
Lệnh /speckit-specify không đọc được phần bàn giao	Đường dẫn trong lệnh trỏ sai slug	Kiểm tra tệp decision.md tồn tại đúng tại .specify/assessments/<slug>/

---

Nguồn tham chiếu: Idea Assessment QuickstartPhiên bản kiểm chứng: Spec Kit 1.1.3