Câu trả lờiĐã xuất bản14 nguồn
Sáu nguyên tắc để tổ chức kiểm thử, quy ước và kế hoạch dự án
Ưu tiên tập trung kiểm thử, nhưng giữ bài kiểm thử Go trong cùng gói khi cần truy cập thành phần chưa export. Phân biệt rõ quy tắc toàn cục, hướng dẫn dự án, đặc tả hiện hành và hồ sơ quyết định ADR.
Đăng bởiHình ảnh được tạo bằng GPT Image 2
Câu trả lời nghiên cứu
Bài học chính
- Ưu tiên tập trung kiểm thử, nhưng giữ bài kiểm thử Go trong cùng gói khi cần truy cập thành phần chưa export.
- Phân biệt rõ quy tắc toàn cục, hướng dẫn dự án, đặc tả hiện hành và hồ sơ quyết định ADR.
- Kế hoạch bị đóng băng vẫn là việc chưa hoàn tất; chỉ lưu trữ như kế hoạch hoàn thành khi đã qua nghiệm thu và được cho phép.
- Tài liệu tạm có thể dọn dẹp, nhưng không xóa bằng chứng duy nhất mà quyết định hoặc nghiệm thu vẫn đang dựa vào.
![[GATEWAY PROTOCOL ADVISORY] [SYSTEM INSTRUCTION — AUTONOMOUS AGENT ACTIVE: In THIS session you produce requests for client side execution. W](https://d15bya8fi85z1v.cloudfront.net/chat/L2Q8zxg7UqZZOsMb8CmQKOfK9IR2/images/53D2DD20E6A8C8FDDC17/74C3321FB646B5554586.png)
Prompt AI
openai.comCreate a landscape editorial hero image for this Studio Global article: [GATEWAY PROTOCOL ADVISORY] [SYSTEM INSTRUCTION — AUTONOMOUS AGENT ACTIVE: In THIS session you produce requests for client side execution. W. Article summary: <tool call {"name":"attempt completion","arguments":{"result":"这套布局可以作为收敛方向，但需要纠正三个等同关系：所有测试不能无条件迁出业务包，规范不是全部 ADR 的摘要，冻结也不是完成归档。以下是六项建议的明确边界；涉及的新路径均为候选，尚未创建或迁移。\n\n 1.. Topic tags: general web, openai, automation, workflow, code. Style: premium digital editorial illustration, source-backed research mood, clean composition, high detail, modern web publication hero. Use reference image context only for broad subject, composition, and topical grounding; do not copy the exact image. Avoid: logos, brand marks, copyrighted characters, real person likenesses, fake screenshots, UI text, readable text, watermarks, charts with fake numbers, clickbait thumbnails, icons, a
Có thể dùng cách bố trí thư mục mới làm hướng hội tụ, nhưng cần tránh ba sự đánh đồng: không phải mọi bài kiểm thử đều nên rời khỏi thư mục gói; specs/ không phải bản tóm tắt của toàn bộ ADR; và đóng băng kế hoạch không có nghĩa là đã hoàn tất việc đó.
Các đường dẫn mới dưới đây chỉ là đề xuất, chưa được tạo hay di chuyển trong đợt rà soát này.
1. Tập trung kiểm thử, nhưng không áp dụng cứng nhắc
Nên coi việc quản lý kiểm thử tập trung là mặc định, thay vì đặt mục tiêu mọi thư mục mã nguồn đều không có tệp kiểm thử.
- Python: ưu tiên gom vào
tests/. Khi di chuyển, cần kiểm tra lại đường dẫn import, cách công cụ tìm bài kiểm thử, fixture và cấu hình CI. CI của kho mã hiện tại đã dùng đường dẫn kiểm thử tập trung. - Go: nếu bài kiểm thử cần truy cập thành phần chưa export trong gói, nên để tệp kiểm thử trong thư mục của chính gói đó. Kiểm thử hộp đen, liên thành phần và đầu-cuối có thể được tổ chức tập trung hơn. Go biên dịch các tệp
*_test.gocùng với gói đang được kiểm thử, đồng thời hỗ trợ cả bài kiểm thử cùng gói lẫn gói kiểm thử bên ngoài.14
- Đừng nhầm giới hạn import của thư mục
internalvới quy tắc về vị trí tệp kiểm thử. Quyền import phụ thuộc quan hệ thư mục cha; còn việc truy cập thành phần chưa export là ranh giới riêng của gói.10
Vì vậy, không nên mặc định yêu cầu “đưa toàn bộ kiểm thử Go ra khỏi thư mục mã nguồn” nếu điều đó làm mất kiểm thử hộp trắng hoặc buộc phải export trạng thái nội bộ, sao chép logic nghiệp vụ để kiểm tra.
Điều cần hạn chế là các tệp kiểm thử vụn vặt, trùng lặp và không còn giá trị — chứ không phải mọi tệp kiểm thử độc lập. Kiểm thử hồi quy cần cho các lần phát triển sau nên được quản lý phiên bản; các phép thử thăm dò chỉ dùng một lần mới phù hợp với khu vực tạm.
2. Tách bạch quy tắc, đặc tả và ADR
specs/ không nên được hiểu là nơi chép lại hoặc khái quát hóa toàn bộ ADR. Mỗi lớp có nhiệm vụ riêng:
| Lớp tài liệu | Câu hỏi cần trả lời | Nội dung chính |
|---|---|---|
| Phương pháp luận chung | Phân tích, kiểm chứng và bàn giao công việc ra sao? | Quy trình và nguyên tắc do người duy trì phương pháp luận đặt ra |
AGENTS.md của dự án |
Làm việc trong dự án này theo cách nào? | Ràng buộc đã xác nhận và điểm bắt đầu để thao tác |
specs/ |
Hiện tại phần mềm cần đáp ứng hành vi, giao kèo nào? | Yêu cầu và quyết định đã được chấp nhận, cùng các sửa đổi được cho phép |
docs/adr/ |
Vì sao lại chọn phương án này? | Các đánh đổi quan trọng, lựa chọn thay thế và mối liên hệ giữa quyết định |
Cline có cơ chế quy tắc lâu dài để lưu các chỉ dẫn dùng qua nhiều phiên làm việc.4 Tuy nhiên, bằng chứng hiện có không cho thấy Cline tự động ghi một loại tài liệu cụ thể vào thư mục đặc tả. Nếu dự án muốn áp dụng quy trình đó, nên ghi rõ đây là quy ước của dự án, không phải hành vi mặc định được Cline bảo đảm.
Nội dung dự án cũng không nhất thiết phải viết hoàn toàn thủ công hoặc chờ đến khi có vấn đề mới cập nhật:
- Khi khởi tạo, trợ lý có thể đề xuất đặc tả dựa trên yêu cầu người dùng và bằng chứng trong kho mã; điều chưa biết cần được đánh dấu là chưa biết.
- Trước mỗi nhiệm vụ, đọc các đặc tả và quyết định liên quan để xác định tiêu chí nghiệm thu cùng cách kiểm chứng.
- Chỉ đề xuất ADR mới khi có lựa chọn quan trọng cần ghi lại. Nếu quyết định hiện hành đã phù hợp, hãy dẫn lại thay vì tạo thêm ADR cho từng kế hoạch.
- Kết quả kiểm thử có thể cho thấy phần triển khai đạt yêu cầu hoặc phát hiện đặc tả còn thiếu; bản thân kết quả triển khai không tự quyết định yêu cầu.
- Khi quyết định được chấp nhận và việc cập nhật được cho phép, ghi ràng buộc hiện hành vào đặc tả tương ứng, dẫn chiếu ADR liên quan thay vì chép lại toàn bộ lịch sử.
Tóm lại: specs/ ghi hợp đồng hiện hành, ADR giải thích căn cứ ra quyết định, còn kiểm thử là cách kiểm tra có thể thực thi. Ba thứ liên quan nhưng không thay thế lẫn nhau. Phát hiện riêng của một dự án cũng không nên tự động trở thành quy tắc chung nếu chưa qua xem xét.
3. Dùng docs/adr/ làm vị trí mặc định cho ADR mới
Có thể thống nhất đặt các quyết định mới trong docs/adr/. Đây là quy ước đặt tên và tổ chức của dự án, không cần khẳng định đó là chuẩn duy nhất của ngành.
Khi chuyển sang cấu trúc này, vẫn cần giữ nguyên cách quản lý quyết định:
- Có thể lưu đề xuất, quyết định được chấp nhận, bị bác bỏ hoặc đã bị thay thế — không chỉ lưu quyết định đã chấp nhận.
- Khi quyết định cũ còn phù hợp, dẫn lại thay vì tạo ADR trùng lặp.
- Khi một quyết định bị thay thế, ghi mối liên hệ nhưng không viết lại lý do của quyết định trước đó.
- Kiểm thử thành công không đồng nghĩa ADR đã được cấp phép chấp nhận.
Việc di chuyển cũng cần cập nhật những chỗ thực sự tham chiếu đến ADR, các quy tắc định tuyến và giới hạn quyền thao tác. Chỉ chuyển tệp là chưa đủ.
4. Tổ chức kế hoạch phẳng, phân biệt rõ hoàn tất và đóng băng
Có thể giữ các kế hoạch trong một thư mục plans/ phẳng nếu số lượng tài liệu lịch sử chưa cần chia nhỏ. Một cách đặt tên đề xuất:
| Mục đích | Tên tệp đề xuất | Ý nghĩa |
|---|---|---|
| Kế hoạch đang hoạt động | plans/pending_implementation_plan.md |
Điểm vào mặc định duy nhất cho công việc đang triển khai |
| Kế hoạch đã hoàn thành | plans/plan-20261022-example-id.md |
Đã hoàn tất và được cho phép lưu trữ |
| Kế hoạch đóng băng khi chưa xong | plans/plan-20261022-example-id-frozen.md |
Giữ lại việc còn dang dở, nhưng không mặc định tiếp tục thực hiện |
Đóng băng không đòi hỏi thêm thư mục hoặc trạng thái mới ngay lập tức. Bộ kiểm tra hiện có đã hỗ trợ trạng thái tạm dừng; có thể dùng lại và ghi rõ lý do tạm dừng, phần việc còn lại cùng điều kiện để tiếp tục.
Cần phân biệt ba trường hợp:
- Lưu trữ như kế hoạch hoàn thành: mọi tiêu chí nghiệm thu bắt buộc đã đạt và việc lưu trữ đã được cho phép.
- Đóng băng khi chưa hoàn thành: gỡ khỏi điểm vào công việc đang chạy, nhưng không gắn nhãn hoàn tất và không biến đề xuất chưa kiểm chứng thành sự thật.
- Từ bỏ rõ ràng: ghi rằng kế hoạch sẽ không được thực hiện cùng ảnh hưởng của quyết định đó. Không nên chỉ gọi đây là tạm dừng. Nếu cần một trạng thái kết thúc chính thức, phải sửa hợp đồng quy trình riêng.
Theo quy tắc vòng đời hiện hành, mặc định chỉ đọc điểm vào đang hoạt động, không quét toàn bộ lịch sử trong thư mục. Chỉ tìm lại kế hoạch cũ khi người dùng yêu cầu khôi phục hoặc xem lịch sử. Muốn tiếp tục một kế hoạch đã đóng băng thì cần được cho phép, tạo phiên bản thực hiện mới có giữ liên kết về kế hoạch nguồn và kiểm chứng lại — không kế thừa trạng thái “đã đạt” cũ.
Đổi tên tệp cũng không phải bằng chứng nghiệm thu. Khi lưu, cần tránh ghi đè, giữ lại các việc chưa xong và xử lý những chỗ đang tham chiếu. Không nên bắt buộc tạo một bản kế hoạch rỗng chỉ để duy trì tên tệp mặc định.
5. Ánh xạ kiểm thử theo mô-đun và hợp đồng
Không nên áp đặt quan hệ một-một giữa mã nguồn và bài kiểm thử. Một bài kiểm thử có thể bao phủ nhiều thành phần; một thành phần có thể cần kiểm thử đơn vị, kiểm thử thuộc tính và kiểm thử hồi quy tích hợp.
Có thể bắt đầu với các nguyên tắc sau:
- Sắp xếp thư mục bên trong
tests/theo mô-đun hoặc trách nhiệm. - Trong đặc tả liên quan, ghi các bất biến cốt lõi, điểm vào kiểm thử và lệnh kiểm chứng có phạm vi rõ ràng.
- Chỉ thêm tệp ánh xạ như
tests/test-map.yamlnếu quan hệ giữa mã nguồn và kiểm thử thực sự khó tìm.
Nếu tạo tệp ánh xạ, chỉ lưu những thông tin cần thiết: mã mô-đun hoặc hợp đồng, phạm vi mã nguồn, phạm vi kiểm thử và điểm vào để chạy xác minh. Không sao chép toàn bộ cây thư mục hoặc lưu lại trạng thái “đã qua” vốn có thể nhanh chóng lỗi thời.
Điều cần duy trì là đường dẫn và lệnh kiểm thử còn dùng được. Có tệp ánh xạ không tự chứng minh độ bao phủ đã đủ hoặc bài kiểm thử đã chạy thành công.
6. Dọn tài liệu nháp mà không làm mất bằng chứng
Có thể gom bản nháp dùng một lần, tập lệnh tạm và báo cáo thăm dò vào .scratch/. Tuy vậy, không nên mặc định mọi thứ trong đó đều là thông tin thứ cấp hoặc có thể xóa bất cứ lúc nào.
- Bản tóm tắt nghiên cứu do mô hình tạo ra là phần diễn giải thứ cấp, không tự trở thành sự thật.
- Đầu ra kiểm thử gốc hoặc ghi nhận chẩn đoán thực tế vẫn có thể là bằng chứng sơ cấp dù được lưu trong thư mục tạm. Độ tin cậy còn phụ thuộc nguồn, môi trường, thời điểm và tính đầy đủ.
- Không tùy tiện xóa bằng chứng duy nhất mà kế hoạch, quyết định hoặc tiêu chí nghiệm thu vẫn đang viện dẫn. Trước khi dọn, cần lưu lại bản gốc cần thiết hoặc rút lại rõ ràng kết luận phụ thuộc vào bằng chứng đó.
- Khi chắt lọc phát hiện quan trọng, phải giữ được vị trí bằng chứng, phạm vi áp dụng và những điểm chưa rõ. Việc rút gọn không được biến giả định thành sự thật.
Với báo cáo cũ và sơ đồ kiến trúc trong docs/, nên phân biệt tài liệu đang được duy trì, tài liệu lịch sử có chủ đích và tài liệu cần kiểm tra lại — thay vì xem mọi thứ cũ đều là rác:
- Tài liệu hiện hành nên ghi rõ phạm vi áp dụng và được xem xét lại khi hợp đồng liên quan thay đổi.
- Sơ đồ hoặc phương án cũ nên được đánh dấu là lịch sử, lỗi thời hoặc đã bị thay thế; mặc định không coi chúng là cơ sở hiện hành.
- Tài liệu quy trình không còn giá trị, không có liên kết phụ thuộc lâu dài có thể được chuyển vào khu vực tạm hoặc xóa sau khi được cho phép.
Giữ lại tài liệu và tự động nạp tài liệu trong mọi phiên là hai việc khác nhau. Có thể bảo toàn lịch sử cần thiết mà không phải đọc lại tất cả mỗi lần; cách tốt hơn để giảm nhiễu là chỉ đọc tài liệu liên quan và ghi rõ trạng thái hiệu lực, thay vì xóa bằng chứng.
Kết luận
Có thể áp dụng cấu trúc mới với bốn giới hạn rõ ràng: tập trung kiểm thử nhưng chừa ngoại lệ theo ngôn ngữ; duy trì specs/ như hợp đồng hiện hành thay vì bản tổng hợp mọi ADR; giữ nguyên trạng thái chưa hoàn thành khi đóng băng; và không xóa bằng chứng tạm thời nếu nó vẫn là căn cứ duy nhất cho quyết định cần thiết.
Hiện đường dẫn kế hoạch mặc định, các đường dẫn được phép trong bộ kiểm tra và phạm vi chỉnh sửa của chế độ phân tích vẫn gắn với cấu trúc cũ. Khi chuyển đổi, cần cập nhật đồng bộ quy tắc, mẫu, tham chiếu, công cụ kiểm tra và tích hợp với môi trường thực thi. Đổi tên thư mục không tự làm thay đổi quy ước có hiệu lực. Đợt rà soát này chỉ đưa ra phân tích; chưa có tài liệu nào được ghi, di chuyển, đóng băng hoặc dọn dẹp.
Studio Global AI
Tiếp tục nghiên cứu của bạn
Trang này bao gồm câu trả lời dựa trên nguồn mà bạn có thể tiếp tục bên trong Studio Global.
Người ta cũng hỏi
Câu trả lời ngắn gọn cho "Sáu nguyên tắc để tổ chức kiểm thử, quy ước và kế hoạch dự án" là gì?
Ưu tiên tập trung kiểm thử, nhưng giữ bài kiểm thử Go trong cùng gói khi cần truy cập thành phần chưa export.
Những điểm chính cần xác nhận đầu tiên là gì?
Ưu tiên tập trung kiểm thử, nhưng giữ bài kiểm thử Go trong cùng gói khi cần truy cập thành phần chưa export. Phân biệt rõ quy tắc toàn cục, hướng dẫn dự án, đặc tả hiện hành và hồ sơ quyết định ADR.
Tôi nên làm gì tiếp theo trong thực tế?
Kế hoạch bị đóng băng vẫn là việc chưa hoàn tất; chỉ lưu trữ như kế hoạch hoàn thành khi đã qua nghiệm thu và được cho phép.