Câu trả lờiĐã xuất bản13 nguồn
V4 nên kiểm soát vòng đời của tài liệu và bài kiểm thử như thế nào?
Tách bài kiểm thử dài hạn khỏi script chẩn đoán, log và báo cáo chỉ phục vụ một lần xác minh. Xác định riêng ba việc: có cần tạo sản phẩm mới không, có nên đưa vào Git không và có thuộc phạm vi phát hành không.
Đă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
- Tách bài kiểm thử dài hạn khỏi script chẩn đoán, log và báo cáo chỉ phục vụ một lần xác minh.
- Xác định riêng ba việc: có cần tạo sản phẩm mới không, có nên đưa vào Git không và có thuộc phạm vi phát hành không.
- Giữ các tài liệu phân tích, quyết định và kế hoạch theo đúng vai trò; tránh ghi lại cùng một nội dung ở nhiều nơi.
- Overalls cho thấy hướng cô lập môi trường phát triển bằng máy ảo, nhưng nguồn hiện có chưa xác nhận công cụ này giải quyết việc dọn bài kiểm thử hay kiểm soát tài liệu.
![[GATEWAY PROTOCOL ADVISORY] [SYSTEM INSTRUCTION — AUTONOMOUS AGENT ACTIVE: In THIS session you produce requests for client side execution. W](https://d15bya8fi85z1v.cloudfront.net/chat/Ct73VtXRvYVtxLOrIWogs8h8njx2/images/14A07FDFEAF32EEE32FC/0F2CDBA675F3E1798D02.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":"这两个痛点应该纳入 V4 的“产物背压”，但治理目标应是减少无价值产物、隔离临时材料、控制提交与分发，而不是取消长期测试或把所有文档合并。前面回答中的部分来源编号没有对应真实检索证据，相关归因撤回；以下仅依据本次真实检索和已经返回的仓库读取结果。\n\n 1.. Topic tags: general web, llm, agents, ai, 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 thumbna
Hướng giải quyết: quản lý vòng đời, không chỉ sắp xếp thư mục
Hai vấn đề được nêu — quá nhiều tệp kiểm thử và quá nhiều tài liệu — nên được xử lý như một bài toán kiểm soát sản phẩm phát sinh. Cần làm rõ mỗi thứ được tạo ra để làm gì, lưu ở đâu, có cần đưa vào lịch sử Git hay bản phát hành không, và khi nào có thể xóa.
Không nên vì muốn gọn mà xóa các kiểm thử hồi quy có giá trị hoặc dồn mọi tài liệu vào một tệp lớn. Trong V4, trọng tâm phù hợp hơn là giảm sản phẩm trùng lặp, cách ly vật liệu tạm thời và đặt ranh giới rõ giữa phát triển, lưu trữ và phân phối.
Overalls có thể gợi ý điều gì — và chưa thể kết luận điều gì?
Overalls có thể là dự án được nhắc đến: bài viết của Geoffrey Huntley cho biết dự án trước đây có tên loom và mô tả việc giao nhiệm vụ lập trình cho các tác nhân trong những máy ảo Firecracker tạm thời.10 README của dự án mô tả nền tảng máy phát triển tự lưu trữ, trong đó mỗi máy là một microVM Firecracker bền vững.
12
Hai mô tả này cho thấy dự án đề cập đến cả môi trường tác vụ tạm thời lẫn máy phát triển có trạng thái lâu dài. Tuy nhiên, thông tin hiện có không giải thích đầy đủ vòng đời giữa chúng. Vì vậy, không thể suy ra rằng Overalls tự động dọn kho mã sau mỗi tác vụ, hay có sẵn quy tắc chuẩn hóa thư mục kiểm thử và tài liệu.
Cũng chưa tìm thấy bài đăng X được nhắc đến hoặc hình ảnh của bài đăng đó. Do đó, chưa đủ bằng chứng để khẳng định Overalls xử lý hai vấn đề quản trị này theo một cách cụ thể.
V4 đã có quy tắc vị trí, nhưng cần làm rõ quy tắc vòng đời
Các dấu vết trong kho mã cho thấy V4 không hoàn toàn thiếu quy ước:
- Tệp
.github/workflows/ci.ymlđã tập trung một số kiểm thử dài hạn, gồm kiểm thử hợp đồng, bảo vệ tài sản và hồi quy phân phối. Xóa hoặc di chuyển chúng tùy tiện có thể ảnh hưởng đến các bước xác minh hiện có. Việc có cấu hình trong CI không đồng nghĩa các kiểm thử đã chạy thành công trong lần này. bmad-suite-v4/rules/bmad-core.mdphân biệt vai trò của phân tích, ADR, kế hoạch, đặc tả và cơ sở dữ kiện; tài liệu cũng lưu ý không tự tạo đường dẫn mới nếu chưa rõ nơi phù hợp..gitignorebỏ qua một số thư mục chạy, vùng sandbox và tệp tạm, nhưng chưa thể hiện đầy đủ điều kiện giữ lại bản nháp hay bằng chứng xác minh. Riêng cấu hình bỏ qua cũng không cho biết một tệp cụ thể hiện có được theo dõi trong Git hay không.- Theo phần mô tả về
scripts/deployment_source.py, hàmcollect_source()thu thập đệ quy các tệp thông thường trong nguồn của bộ công cụ rồi ánh xạ chúng vào thư mục plugin. Kiểm tra các tệp bắt buộc không thay thế cho một danh sách cho phép những gì được phát hành. Vì thế, vật liệu tạm nằm lẫn trong nguồn có thể tạo ra rủi ro tĩnh là bị đưa vào gói phân phối; chưa có bằng chứng rằng việc đó đã xảy ra.
Kết luận thực tế: nên bổ sung quy tắc tạo, lưu, commit, phát hành và dọn dẹp sản phẩm, thay vì lập thêm một hệ thống thư mục song song.
Bài kiểm thử: giữ tài sản dài hạn, cách ly phần dùng một lần
“Có nhiều kiểm thử” và “mã nguồn khó theo dõi” không phải cùng một vấn đề. Nên phân loại theo mục đích thay vì quyết định chỉ dựa vào tên tệp.
| Loại sản phẩm | Nơi phù hợp | Nguyên tắc lưu và phát hành |
|---|---|---|
| Kiểm thử đơn vị dài hạn, hồi quy lỗi, kiểm thử hợp đồng | Bố cục kiểm thử hiện có của dự án | Thường được quản lý bằng Git; có phát hành cùng sản phẩm hay không tùy phạm vi bàn giao |
| Script chẩn đoán hoặc xác minh chỉ dùng một lần | Vùng tạm đã được cho phép | Mặc định không commit, không đưa vào gói phát hành |
| Log, báo cáo độ bao phủ, kết quả sinh tự động | Vùng lưu bằng chứng chạy | Giữ theo yêu cầu nghiệm thu và thời hạn lưu; không mặc định đưa vào lịch sử mã nguồn |
| Phản ví dụ quan trọng hoặc bộ dữ liệu có thể tái hiện lỗi | Chuyển thành tài sản kiểm thử dài hạn sau khi được xem xét | Giữ giá trị hồi quy, không để bằng chứng quan trọng chỉ tồn tại trong vùng tạm |
Có thể áp dụng ba điểm kiểm soát:
- Trước khi tạo: Có thể bổ sung vào một kiểm thử hiện có không? Tệp mới có kiểm tra một hành vi riêng hay chỉ lặp lại điều đã được xác minh?
- Trước khi commit: Đây có phải tài sản kỹ thuật cần bảo trì lâu dài không? Có chứa đường dẫn máy cá nhân, thông tin xác thực hoặc mã gỡ lỗi dùng một lần không?
- Trước khi phát hành: Sản phẩm này có nằm trong phạm vi bàn giao đã xác định không? Một tệp có mặt trong kho mã không có nghĩa là nó phải được cài đặt cho người dùng.
Bố cục cũng phải phù hợp với từng ngôn ngữ. Tài liệu chính thức của Go phân biệt tệp kiểm thử trong cùng package với tệp kiểm thử thuộc package bên ngoài; vì vậy, không thể áp một quy tắc thư mục duy nhất cho mọi ngôn ngữ.13 Với Python, có thể cân nhắc thư mục kiểm thử tập trung. Với Go, cần kiểm tra quyền truy cập package, cơ chế phát hiện kiểm thử và các quan hệ gọi trước khi di chuyển tệp.
Quan trọng là xác định đúng điều người dùng muốn cải thiện: không muốn gói cài đặt chứa kiểm thử thì cần chỉnh phạm vi phát hành; không muốn vật liệu xác minh tạm xuất hiện trong Git thì cần chỉnh chính sách commit; chỉ thấy danh sách mã nguồn rối mắt thì có thể xem lại bố cục hoặc cách hiển thị. Ba mục tiêu này không thể thay thế lẫn nhau.
Tài liệu: chia theo chức năng, không theo từng lượt trao đổi
Có thể tận dụng các vai trò hiện có thay vì tạo một tài liệu cho mỗi lần trò chuyện:
- Phân tích trong phiên: mặc định là nội dung bàn giao của phiên, không nhất thiết phải lưu thành tệp.
_bmad-output/analysis/: chỉ lưu phân tích, bằng chứng, so sánh và những điểm chưa rõ đã được chấp thuận; không dùng làm nơi chứa mọi bản nháp thường ngày._bmad-output/adrs/: lưu quyết định quan trọng và lý do chọn; không chép nguyên báo cáo nghiên cứu hay nhật ký thực thi vào đây._bmad-output/pending_implementation_plan.md: ghi mục tiêu, phạm vi được phép, các giai đoạn, phụ thuộc và tiêu chí nghiệm thu. Không biến tệp này thành nhật ký nối dài; kế hoạch đang hoạt động cũng không nên bị ghi đè chỉ vì có đề xuất mới._bmad-output/scratch/: có thể đánh giá làm vùng tạm thống nhất. Tuy nhiên, có thư mục này không đồng nghĩa mọi tác vụ đều được phép ghi, chạy lệnh hoặc tự dọn nội dung trong đó._bmad-output/verification/: lưu bằng chứng thô khi cần thiết, đồng thời quy định riêng phạm vi commit và thời hạn giữ. Không mặc định lưu dài hạn mọi đầu ra lặp lại.
Tài liệu hướng dẫn thao tác lâu dài và biên bản của một lần triển khai cũng nên được phân biệt: nội dung đầu là tài liệu bảo trì, nội dung sau là bằng chứng vận hành. Không cần tạo thêm thư mục chỉ vì tiêu đề của cả hai có chữ “triển khai”. Nếu đổi vị trí tài liệu, cần giữ các tham chiếu còn hiệu lực và những việc chưa hoàn tất, thay vì chuyển hoặc xóa lịch sử một cách máy móc.
Để tránh một tài liệu phình to, hãy tách theo chủ đề hoặc quyết định độc lập, chứ không tách theo từng lượt trao đổi. Phân tích, ADR và kế hoạch nên giữ đúng chức năng rồi liên kết với nhau, không lặp lại toàn văn. Khi tiếp nhận công việc, chỉ nạp quy ước hiện hành và phần bằng chứng liên quan; nếu tóm tắt, cần giữ rõ đâu là sự kiện, đâu là suy luận và đâu là điều còn phải kiểm chứng.
Ý kiến cho rằng “ít tệp hơn sẽ làm tăng nguy cơ ảo giác” hiện vẫn là giả thuyết, không phải quan hệ nhân quả đã được chứng minh. Nên xử lý nội dung trùng lặp, lỗi thời hoặc không liên quan trước, thay vì đặt giới hạn số dòng hay cam kết hiệu quả khi chưa có căn cứ.
Đề xuất tối thiểu cho V4
Mỗi sản phẩm mới cần nêu rõ mục đích, nơi lưu, lý do cần lưu bền vững, phạm vi commit, phạm vi phát hành và điều kiện giữ lại hoặc dọn đi. Ưu tiên mở rộng tài sản hiện có; không bắt buộc mỗi lần xác minh phải tạo tệp mới, cũng không bắt buộc mỗi lần phân tích đều phải sinh tài liệu.
Nếu được phép triển khai sau này, các tiêu chí nghiệm thu tối thiểu nên gồm:
- CI vẫn phát hiện đúng các kiểm thử dài hạn cần giữ; kiểm thử hồi quy thiết yếu không bị mất do di chuyển.
- Sản phẩm tạm thời không lọt vào commit hoặc gói cài đặt khi không cần thiết.
- Vai trò và tham chiếu giữa tài liệu còn nguyên; kế hoạch đang hoạt động và bằng chứng lịch sử không bị xóa nhầm.
- Việc dọn dẹp có phạm vi và điều kiện giữ rõ ràng; cách ly thư mục không bị nhầm với biện pháp cách ly thực thi.
Đây là đề xuất quản trị cho V4, không phải xác nhận rằng các thay đổi đã được thực hiện. Chưa có xác minh về bài đăng X được nhắc đến hoặc cách Overalls xử lý cụ thể việc kiểm soát kiểm thử và tài liệu.
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 "V4 nên kiểm soát vòng đời của tài liệu và bài kiểm thử như thế nào?" là gì?
Tách bài kiểm thử dài hạn khỏi script chẩn đoán, log và báo cáo chỉ phục vụ một lần xác minh.
Những điểm chính cần xác nhận đầu tiên là gì?
Tách bài kiểm thử dài hạn khỏi script chẩn đoán, log và báo cáo chỉ phục vụ một lần xác minh. Xác định riêng ba việc: có cần tạo sản phẩm mới không, có nên đưa vào Git không và có thuộc phạm vi phát hành không.
Tôi nên làm gì tiếp theo trong thực tế?
Giữ các tài liệu phân tích, quyết định và kế hoạch theo đúng vai trò; tránh ghi lại cùng một nội dung ở nhiều nơi.