Có thể thống nhất phiên bản công khai theo dạng v4.3, v4.4; nhưng rà soát hiện tại chưa đủ căn cứ để gọi kho mã là bản v4.3 sạch và sẵn sàng triển khai. Bản rà soát chỉ đọc: chưa sửa phiên bản, xóa tệp, chạy kiểm thử hay triển khai.
Đăng bởiHình ảnh được tạo bằng GPT Image 2
Câu trả lời nghiên cứ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/JRtyWXL5XMODkxxCStM9mCCPWvd2/thumbnails/BA7A4AFCF2EA752F7BFC/8C87F7C130DEC1EBD017-medium-640.webp)
Create 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.3,采用轻量发布管理;但目前不能认定工作树已经是“干净且完整可部署的 v4.3”。本轮完成的是只读审查,没有更新仓库、修改版本、删除历史、运行测试或执行部署。\n\n 版本与历史清理\n\n 对外使用 v4.3、v4.4 这样的两段版本;内部套件身份继续保留 V4,不必为了展示版. Topic tags: general web, llm, agents, ai, automation. 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 wit
Có thể thống nhất cách ghi phiên bản công khai thành v4.3, v4.4…, đồng thời giữ nguyên danh tính nội bộ của bộ công cụ là V4. Không cần đổi tên toàn bộ thư mục, viết lại lịch sử hay dựng thêm một hệ thống quản lý phiên bản phức tạp.
Tuy nhiên, việc đổi nhãn chưa đủ để kết luận kho mã đã trở thành một bản v4.3 sạch và sẵn sàng triển khai. Rà soát hiện tại chỉ đọc: không sửa kho mã, đổi phiên bản, xóa lịch sử, chạy kiểm thử hoặc triển khai.
Hiện README vẫn ghi v4.2.0 (README.md:3), còn hướng dẫn chính của bộ công cụ ghi V4.2 (bmad-suite-v4/skills/bmad/SKILL.md:11). Bản đồ phiên bản trong scripts/suite_versions.py:28 chỉ nhận diện V4, chưa có một nguồn duy nhất cho phiên bản phụ. Cũng chưa có bằng chứng đối chiếu được về mối liên hệ giữa thẻ v4.3 trên máy chủ từ xa và commit trong kho. Vì vậy, chỉ sửa huy hiệu hoặc dòng giới thiệu sẽ không chứng minh được các thành phần đã đồng bộ.
Hướng gọn nhẹ là chọn một nguồn phiên bản duy nhất, rồi dùng nó cho tài liệu, hướng dẫn cài đặt và kiểm tra nhất quán trong CI. Commit và dấu vân tay tệp vẫn hữu ích để truy nguyên nguồn và bảo vệ tài sản của người dùng, nhưng không cần biến chúng thành một tầng quản lý phiên bản bổ sung.
Thư mục .versions/v4.0.0/ là ứng viên có thể xem xét dọn dẹp, nhưng trước khi xóa cần kiểm tra xem có bản triển khai hoặc liên kết hiện hành nào còn trỏ tới đó không. Điểm tích cực là scripts/tag-cache.py:109 đã từ chối tự động tái sử dụng bộ nhớ đệm theo cách đặt tên thẻ cũ.
Không nên gom mọi thứ có vẻ “cũ” vào cùng một danh sách xóa. Thư mục verification/legacy-bmad-output/ vẫn được một ADR hiện có dẫn chiếu (docs/adrs/ADR-20261012-bmad-solo-anti-bureaucracy-and-programmatic-guards.md:232). Thư mục kỹ năng lịch sử _bmad-solo-source/legacy-skills/ lại chứa tư liệu quan trọng để hiểu nguồn gốc kỹ năng thượng nguồn. Cả hai không thể mặc định xem là bộ nhớ đệm vô dụng; đợt rà soát này không xóa tài sản nào.
Bộ cài đặt hiện đã có những biện pháp bảo vệ đáng giữ lại: install.sh:50 từ chối ghi đè cây làm việc đang có thay đổi chưa lưu; bs.sh:298 yêu cầu cập nhật kiểu fast-forward và chuyển sang dùng tập lệnh mới; còn bộ điều phối có quản lý kiểm tra xung đột trước khi ghi (scripts/deploy-managed-cli.py:104). Đơn giản hóa cách ghi phiên bản không đồng nghĩa với việc bỏ các chốt này.
Những thiếu sót nằm ở trải nghiệm và mức hỗ trợ môi trường. install.sh:14 hiện chỉ nhận tham số tương thích V4, chưa chuyển tiếp lựa chọn môi trường chủ, chế độ kiểm tra chỉ đọc hay mục tiêu chế độ. Các yêu cầu phụ thuộc chủ yếu nằm trong README (README.md:30), chưa có bước kiểm tra trước thống nhất ngay tại lối vào cài đặt.
Việc xác minh nguồn cũng cần hoàn thiện: cài đặt hiện có đi qua lối vào của kho cục bộ, còn cập nhật sử dụng địa chỉ từ xa trong cấu hình (bs.sh:305). Những lối vào đã xem chưa xác nhận địa chỉ đó có còn đúng là kho dự kiến hay không.
Nên giữ ranh giới trách nhiệm đơn giản: bộ cài đặt lấy nguồn đáng tin cậy, kiểm tra điều kiện ban đầu và chuyển tiếp tham số; bộ triển khai xử lý tương thích môi trường chủ, kiểm tra trước, cập nhật, gỡ cài đặt và bảo vệ tài sản. Không cần thêm một khung điều phối phiên bản nữa.
Workflow hiện tại (.github/workflows/ci.yml:3) chạy khi có cập nhật lên nhánh chính và khi mở yêu cầu hợp nhất, nhưng chưa kích hoạt theo thẻ phát hành. Phần kiểm tra plugin (.github/workflows/ci.yml:41) xem cấu trúc và tên gọi, không kiểm tra định dạng phiên bản phát hành.
Bộ kiểm tra thẻ trong scripts/suite_versions.py:99 mới xem xét dấu hiệu của phiên bản chính. Các kiểm thử hiện có còn cho phép phiên bản ba phần và thẻ không theo định dạng phiên bản (tests/roo_distribution/test_suite_versions.py:80). Do đó, chưa thể nói quy tắc phiên bản hai phần đã được áp dụng.
Mức bổ sung tối thiểu nên gồm: thẻ phát hành mới theo dạng v4.<số>; thẻ khớp với nguồn phiên bản duy nhất; và nội dung hiển thị trong các tài liệu hiện hành nhất quán. Không cần viết lại lịch sử hay áp dụng quy tắc này cho phiên bản phụ thuộc bên thứ ba.
CI cũng nên gọi bộ kiểm tra tính toàn vẹn gói kỹ năng. Trình kiểm tra đã có tại bmad-suite-v4/skills/bmad/scripts/validate-solo-package.py:5, nhưng workflow hiện tại chưa chạy nó (.github/workflows/ci.yml:55). Ngoài tham chiếu trong kho, cần kiểm tra cả các liên kết và đường dẫn sau khi cài đặt.
Luồng hoạt động hiện trỏ tới các quy trình trong chính bộ công cụ (bmad-suite-v4/skills/bmad/references/capability-map.md:3). Bản đồ phân phối thu thập nội dung trong thư mục bộ công cụ, không thu thập thư mục kỹ năng lịch sử bên ngoài (scripts/deployment_source.py:64). Trong mã nguồn hoạt động đã xem, chưa thấy cơ chế kiểm tra hoặc cập nhật kỹ năng thượng nguồn theo thời gian thực.
Điều đó có nghĩa kỹ năng thượng nguồn hiện không phải phụ thuộc chạy trực tiếp của các lối vào cục bộ. Nhưng khi nguồn thượng nguồn được cập nhật, các quy trình đã trích xuất và chỉnh sửa trong kho này cũng không tự cập nhật. Đây là rủi ro lệch nội dung cần quản lý, không phải bằng chứng rằng đã có cơ chế cách ly tương thích.
Cũng không thể chỉ chép một tệp hướng dẫn cũ vào rồi xem như đã tích hợp xong. Chẳng hạn, kỹ năng trợ giúp lịch sử còn cần cấu hình, danh sách thư mục và chương trình phân tích (_bmad-solo-source/legacy-skills/bmad-help/SKILL.md:25); kỹ năng xây dựng lịch sử cần chương trình kết xuất (_bmad-solo-source/legacy-skills/bmad-build-auto/SKILL.md:6).
Hướng phù hợp là giữ ổn định các lối vào phân tích và kỹ thuật cục bộ, rồi chỉ kết nối những kỹ năng thượng nguồn đã được duyệt theo bản đồ năng lực. Mỗi lần cập nhật cần ghi lại commit nguồn và tài sản phụ thuộc bắt buộc, phát hiện nội dung thêm, xóa hoặc đổi phụ thuộc, rồi chạy các kiểm tra liên quan trước khi thay thế. Không nên để tác vụ đang chạy đọc trực tiếp một nhánh thượng nguồn liên tục thay đổi.
Cũng nên tách phát hiện có bản cập nhật khỏi tự động thay thế nóng. Có thể kiểm tra khi cài đặt hoặc cập nhật và chọn gửi nhắc nhở định kỳ; không nhất thiết phải mặc định chạy tiến trình giám sát nền.
Cline có cả giao diện dòng lệnh lẫn plugin IDE, đồng thời phân biệt cấu hình toàn cục áp dụng rộng và cấu hình riêng cho dự án.4
1
Trong kho hiện tại chỉ có một mẫu định tuyến mỏng chưa được kích hoạt (bmad-suite-v4/cline/templates/bmad-router.md:3). Kiểm thử phân phối còn yêu cầu mẫu này nằm trong bản sao không hoạt động, không được đưa vào lối nạp quy tắc Cline thật (tests/roo_distribution/test_host_adaptation.py:85). Vì vậy, có mẫu tệp không đồng nghĩa với đã hỗ trợ cài đặt.
Nên duy trì một bộ nội dung phương pháp luận dùng chung, rồi tạo lớp thích ứng mỏng riêng cho CLI và plugin. Phân vai phân tích và thực thi nên ánh xạ vào chế độ Plan/Act gốc của Cline; không bắt người dùng nhớ câu lệnh kỹ năng riêng và cũng không nhập thẳng cấu hình chế độ của Roo. Ngoài ra, đường dẫn trong mẫu hiện được giải theo gốc của kho này (bmad-suite-v4/cline/templates/bmad-router.md:8), nên khi triển khai sang dự án khác cần phân giải lại vị trí tài nguyên, không thể chép nguyên mẫu rồi mặc định liên kết vẫn đúng.
Với Roo, bản đồ phân phối có các quy tắc toàn cục và một số chế độ được chọn (scripts/deployment_source.py:86). Nhưng tệp có mặt trên đĩa không chứng minh môi trường chủ đã nạp nó. Đáng chú ý, hai chế độ tùy chỉnh hiện không khai báo quyền MCP (bmad-suite-v4/roo/settings/custom_modes.yaml:5), trong khi bộ kiểm tra lại cố định nhóm quyền đó (scripts/validate-roo-contracts.py:158). Nếu kết nối công cụ chưng cất, cần xem xét cả cấu hình lẫn các thành phần kiểm tra, không chỉ sửa nội dung hướng dẫn.
Với Gemini, cách hiện tại là sao chép vật lý thư mục plugin và quy tắc (scripts/deployment_source.py:81), chưa phải một lượt cài đặt tiện ích mở rộng gốc đã được xác minh. Tiện ích mở rộng Gemini CLI có thể đóng gói kỹ năng và máy chủ MCP; khi cài đặt, Gemini tạo một bản sao và có cơ chế cập nhật riêng.11
9 Vì vậy, cần phân biệt rõ luồng sao chép hiện có với luồng tiện ích mở rộng gốc, thay vì gộp cả hai thành một cam kết hỗ trợ.
Rà soát cũng phát hiện một khoảng trống ở đường dẫn sau khi cài: quy tắc lõi toàn cục tham chiếu tương đối tới kỹ năng (bmad-suite-v4/rules/bmad-core.md:38), nhưng bản đồ phân phối đặt bản sao quy tắc và kỹ năng ở các vị trí khác nhau (scripts/deployment_source.py:83). Nếu phân giải đường dẫn tương đối theo vị trí tệp, liên kết đó không thể trỏ thẳng tới kỹ năng đã phân phối.
Ngoài ra, quy trình quản lý dự án còn có hai cách dùng song song. Lối vào dự án chọn một con trỏ nhiệm vụ duy nhất (specs/tasks/_active.md:10), trong khi quy tắc lõi phân phối vẫn dò kế hoạch hoạt động kiểu cũ (bmad-suite-v4/roo/rules/02-bmad-core.md:8). Phạm vi chỉnh sửa của chế độ phân tích cũng chưa bao gồm các vị trí tài liệu dự án mới (bmad-suite-v4/roo/settings/custom_modes.yaml:8).
Ranh giới nên rõ: cài đặt toàn cục chỉ chứa phương pháp luận, kỹ năng và lớp thích ứng môi trường có thể tái sử dụng; cấp dự án chỉ giữ lối vào, quy ước chuyên môn, quyết định và nhiệm vụ của chính dự án. Việc nguồn phân phối hiện không gom toàn bộ tài liệu dự án (scripts/deployment_source.py:64) là một ranh giới nên giữ.
Hướng đề xuất là để môi trường chủ gọi một máy chủ MCP cục bộ độc lập. Dịch vụ đọc dự án được cho phép, tạo tài liệu ứng viên và đưa tài liệu vào dự án qua lối xuất bản được duyệt. Phần phương pháp luận nên mô tả cách phát hiện và gọi dịch vụ, thay vì gộp toàn bộ mã nguồn dịch vụ vào gói quy tắc.
Khả năng dùng được phải được xác nhận theo chức năng. Quy trình xử lý dự án hiện có yêu cầu kiểm tra phiên bản, khai báo công cụ, độ phủ ngôn ngữ, thành phần gọi dịch vụ và khả năng chia nhỏ nội dung (bmad-suite-v4/skills/bmad/references/procedures/brownfield-distill-governance.md:22). Nhưng trong đợt rà soát này chưa đọc mã nguồn hiện tại của dịch vụ, nên không thể khẳng định giao diện hay cơ chế tự đăng ký đã sẵn sàng.
Với phân tích và lập trình thông thường, MCP nên là năng lực bổ sung. Với quy trình khởi tạo yêu cầu rõ ràng phải có bộ máy chưng cất, dịch vụ mới là điều kiện bắt buộc. Nếu thiếu dịch vụ, chỉ chặn bước phụ thuộc vào nó; không làm tê liệt toàn bộ phương pháp luận và cũng không được xem thao tác đọc tệp thông thường là đã nghiệm thu bộ máy chưng cất.
Quét ngoại tuyến, xác thực nguồn và năng lực diễn đạt tùy chọn của mô hình nên được tách lớp. Khi mô hình không khả dụng, hệ thống có thể giữ lại bằng chứng cấu trúc và ghi nhận điều chưa biết; không nên hứa rằng hiệu quả chưng cất ngữ nghĩa vẫn đầy đủ. Cách phân tầng này phù hợp với giới hạn ngoại tuyến trong quy trình hiện có (bmad-suite-v4/skills/bmad/references/procedures/brownfield-distill-governance.md:24).
Không nên lấy mô hình “GitHub cộng đường hầm SSH” làm kiến trúc mặc định. Vị trí phát hành mã nguồn và vị trí chạy dịch vụ là hai chuyện khác nhau. Máy chủ từ xa chỉ nên là lựa chọn khi có nhu cầu cụ thể, kèm quy định riêng về dữ liệu gửi ra ngoài, xác thực, cách ly dự án, mất kết nối và phụ thuộc vào dịch vụ mô hình. Đường hầm tự nó không giải quyết được các vấn đề đó.
Việc kết nối tự động cũng nên chia thành ba bước: đăng ký có chấp thuận lúc cài đặt, xác nhận năng lực khi sử dụng và gắn phiên bản dịch vụ vào đầu tác vụ. Không nên tự tải xuống, tự khởi động thử nghiệm hoặc nới lỏng quyền.
Đây là phạm vi công việc tiếp theo, không phải những hạng mục đã hoàn tất. Điểm nghẽn chính không nằm ở việc quy tắc phiên bản quá chặt, mà ở chỗ nguồn, đường phân phối, cơ chế nạp của từng môi trường và các thành phần tiêu thụ quy trình dự án chưa khép kín. Chỉ nên xem v4.3 là bản giao được sau khi hoàn tất các kiểm tra cần thiết — không phải ngay khi dòng phiên bản được đổi.
Studio Global AI
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.
Có thể thống nhất phiên bản công khai theo dạng v4.3, v4.4; nhưng rà soát hiện tại chưa đủ căn cứ để gọi kho mã là bản v4.3 sạch và sẵn sàng triển khai.
Có thể thống nhất phiên bản công khai theo dạng v4.3, v4.4; nhưng rà soát hiện tại chưa đủ căn cứ để gọi kho mã là bản v4.3 sạch và sẵn sàng triển khai. Bản rà soát chỉ đọc: chưa sửa phiên bản, xóa tệp, chạy kiểm thử hay triển khai.
Các điểm cần ưu tiên gồm một nguồn phiên bản duy nhất, kiểm tra CI, sửa tham chiếu sau cài đặt và xác minh riêng việc tích hợp Cline, Roo, Gemini.
Có thể thống nhất phiên bản công khai theo dạng v4.3, v4.4; nhưng rà soát hiện tại chưa đủ căn cứ để gọi kho mã là bản v4.3 sạch và sẵn sàng triển khai. Bản rà soát chỉ đọc: chưa sửa phiên bản, xóa tệp, chạy kiểm thử hay triển khai.
Đăng bởiHình ảnh được tạo bằng GPT Image 2
Câu trả lời nghiên cứ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/JRtyWXL5XMODkxxCStM9mCCPWvd2/thumbnails/BA7A4AFCF2EA752F7BFC/8C87F7C130DEC1EBD017-medium-640.webp)
Create 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.3,采用轻量发布管理;但目前不能认定工作树已经是“干净且完整可部署的 v4.3”。本轮完成的是只读审查,没有更新仓库、修改版本、删除历史、运行测试或执行部署。\n\n 版本与历史清理\n\n 对外使用 v4.3、v4.4 这样的两段版本;内部套件身份继续保留 V4,不必为了展示版. Topic tags: general web, llm, agents, ai, automation. 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 wit
Có thể thống nhất cách ghi phiên bản công khai thành v4.3, v4.4…, đồng thời giữ nguyên danh tính nội bộ của bộ công cụ là V4. Không cần đổi tên toàn bộ thư mục, viết lại lịch sử hay dựng thêm một hệ thống quản lý phiên bản phức tạp.
Tuy nhiên, việc đổi nhãn chưa đủ để kết luận kho mã đã trở thành một bản v4.3 sạch và sẵn sàng triển khai. Rà soát hiện tại chỉ đọc: không sửa kho mã, đổi phiên bản, xóa lịch sử, chạy kiểm thử hoặc triển khai.
Hiện README vẫn ghi v4.2.0 (README.md:3), còn hướng dẫn chính của bộ công cụ ghi V4.2 (bmad-suite-v4/skills/bmad/SKILL.md:11). Bản đồ phiên bản trong scripts/suite_versions.py:28 chỉ nhận diện V4, chưa có một nguồn duy nhất cho phiên bản phụ. Cũng chưa có bằng chứng đối chiếu được về mối liên hệ giữa thẻ v4.3 trên máy chủ từ xa và commit trong kho. Vì vậy, chỉ sửa huy hiệu hoặc dòng giới thiệu sẽ không chứng minh được các thành phần đã đồng bộ.
Hướng gọn nhẹ là chọn một nguồn phiên bản duy nhất, rồi dùng nó cho tài liệu, hướng dẫn cài đặt và kiểm tra nhất quán trong CI. Commit và dấu vân tay tệp vẫn hữu ích để truy nguyên nguồn và bảo vệ tài sản của người dùng, nhưng không cần biến chúng thành một tầng quản lý phiên bản bổ sung.
Thư mục .versions/v4.0.0/ là ứng viên có thể xem xét dọn dẹp, nhưng trước khi xóa cần kiểm tra xem có bản triển khai hoặc liên kết hiện hành nào còn trỏ tới đó không. Điểm tích cực là scripts/tag-cache.py:109 đã từ chối tự động tái sử dụng bộ nhớ đệm theo cách đặt tên thẻ cũ.
Không nên gom mọi thứ có vẻ “cũ” vào cùng một danh sách xóa. Thư mục verification/legacy-bmad-output/ vẫn được một ADR hiện có dẫn chiếu (docs/adrs/ADR-20261012-bmad-solo-anti-bureaucracy-and-programmatic-guards.md:232). Thư mục kỹ năng lịch sử _bmad-solo-source/legacy-skills/ lại chứa tư liệu quan trọng để hiểu nguồn gốc kỹ năng thượng nguồn. Cả hai không thể mặc định xem là bộ nhớ đệm vô dụng; đợt rà soát này không xóa tài sản nào.
Bộ cài đặt hiện đã có những biện pháp bảo vệ đáng giữ lại: install.sh:50 từ chối ghi đè cây làm việc đang có thay đổi chưa lưu; bs.sh:298 yêu cầu cập nhật kiểu fast-forward và chuyển sang dùng tập lệnh mới; còn bộ điều phối có quản lý kiểm tra xung đột trước khi ghi (scripts/deploy-managed-cli.py:104). Đơn giản hóa cách ghi phiên bản không đồng nghĩa với việc bỏ các chốt này.
Những thiếu sót nằm ở trải nghiệm và mức hỗ trợ môi trường. install.sh:14 hiện chỉ nhận tham số tương thích V4, chưa chuyển tiếp lựa chọn môi trường chủ, chế độ kiểm tra chỉ đọc hay mục tiêu chế độ. Các yêu cầu phụ thuộc chủ yếu nằm trong README (README.md:30), chưa có bước kiểm tra trước thống nhất ngay tại lối vào cài đặt.
Việc xác minh nguồn cũng cần hoàn thiện: cài đặt hiện có đi qua lối vào của kho cục bộ, còn cập nhật sử dụng địa chỉ từ xa trong cấu hình (bs.sh:305). Những lối vào đã xem chưa xác nhận địa chỉ đó có còn đúng là kho dự kiến hay không.
Nên giữ ranh giới trách nhiệm đơn giản: bộ cài đặt lấy nguồn đáng tin cậy, kiểm tra điều kiện ban đầu và chuyển tiếp tham số; bộ triển khai xử lý tương thích môi trường chủ, kiểm tra trước, cập nhật, gỡ cài đặt và bảo vệ tài sản. Không cần thêm một khung điều phối phiên bản nữa.
Workflow hiện tại (.github/workflows/ci.yml:3) chạy khi có cập nhật lên nhánh chính và khi mở yêu cầu hợp nhất, nhưng chưa kích hoạt theo thẻ phát hành. Phần kiểm tra plugin (.github/workflows/ci.yml:41) xem cấu trúc và tên gọi, không kiểm tra định dạng phiên bản phát hành.
Bộ kiểm tra thẻ trong scripts/suite_versions.py:99 mới xem xét dấu hiệu của phiên bản chính. Các kiểm thử hiện có còn cho phép phiên bản ba phần và thẻ không theo định dạng phiên bản (tests/roo_distribution/test_suite_versions.py:80). Do đó, chưa thể nói quy tắc phiên bản hai phần đã được áp dụng.
Mức bổ sung tối thiểu nên gồm: thẻ phát hành mới theo dạng v4.<số>; thẻ khớp với nguồn phiên bản duy nhất; và nội dung hiển thị trong các tài liệu hiện hành nhất quán. Không cần viết lại lịch sử hay áp dụng quy tắc này cho phiên bản phụ thuộc bên thứ ba.
CI cũng nên gọi bộ kiểm tra tính toàn vẹn gói kỹ năng. Trình kiểm tra đã có tại bmad-suite-v4/skills/bmad/scripts/validate-solo-package.py:5, nhưng workflow hiện tại chưa chạy nó (.github/workflows/ci.yml:55). Ngoài tham chiếu trong kho, cần kiểm tra cả các liên kết và đường dẫn sau khi cài đặt.
Luồng hoạt động hiện trỏ tới các quy trình trong chính bộ công cụ (bmad-suite-v4/skills/bmad/references/capability-map.md:3). Bản đồ phân phối thu thập nội dung trong thư mục bộ công cụ, không thu thập thư mục kỹ năng lịch sử bên ngoài (scripts/deployment_source.py:64). Trong mã nguồn hoạt động đã xem, chưa thấy cơ chế kiểm tra hoặc cập nhật kỹ năng thượng nguồn theo thời gian thực.
Điều đó có nghĩa kỹ năng thượng nguồn hiện không phải phụ thuộc chạy trực tiếp của các lối vào cục bộ. Nhưng khi nguồn thượng nguồn được cập nhật, các quy trình đã trích xuất và chỉnh sửa trong kho này cũng không tự cập nhật. Đây là rủi ro lệch nội dung cần quản lý, không phải bằng chứng rằng đã có cơ chế cách ly tương thích.
Cũng không thể chỉ chép một tệp hướng dẫn cũ vào rồi xem như đã tích hợp xong. Chẳng hạn, kỹ năng trợ giúp lịch sử còn cần cấu hình, danh sách thư mục và chương trình phân tích (_bmad-solo-source/legacy-skills/bmad-help/SKILL.md:25); kỹ năng xây dựng lịch sử cần chương trình kết xuất (_bmad-solo-source/legacy-skills/bmad-build-auto/SKILL.md:6).
Hướng phù hợp là giữ ổn định các lối vào phân tích và kỹ thuật cục bộ, rồi chỉ kết nối những kỹ năng thượng nguồn đã được duyệt theo bản đồ năng lực. Mỗi lần cập nhật cần ghi lại commit nguồn và tài sản phụ thuộc bắt buộc, phát hiện nội dung thêm, xóa hoặc đổi phụ thuộc, rồi chạy các kiểm tra liên quan trước khi thay thế. Không nên để tác vụ đang chạy đọc trực tiếp một nhánh thượng nguồn liên tục thay đổi.
Cũng nên tách phát hiện có bản cập nhật khỏi tự động thay thế nóng. Có thể kiểm tra khi cài đặt hoặc cập nhật và chọn gửi nhắc nhở định kỳ; không nhất thiết phải mặc định chạy tiến trình giám sát nền.
Cline có cả giao diện dòng lệnh lẫn plugin IDE, đồng thời phân biệt cấu hình toàn cục áp dụng rộng và cấu hình riêng cho dự án.4
1
Trong kho hiện tại chỉ có một mẫu định tuyến mỏng chưa được kích hoạt (bmad-suite-v4/cline/templates/bmad-router.md:3). Kiểm thử phân phối còn yêu cầu mẫu này nằm trong bản sao không hoạt động, không được đưa vào lối nạp quy tắc Cline thật (tests/roo_distribution/test_host_adaptation.py:85). Vì vậy, có mẫu tệp không đồng nghĩa với đã hỗ trợ cài đặt.
Nên duy trì một bộ nội dung phương pháp luận dùng chung, rồi tạo lớp thích ứng mỏng riêng cho CLI và plugin. Phân vai phân tích và thực thi nên ánh xạ vào chế độ Plan/Act gốc của Cline; không bắt người dùng nhớ câu lệnh kỹ năng riêng và cũng không nhập thẳng cấu hình chế độ của Roo. Ngoài ra, đường dẫn trong mẫu hiện được giải theo gốc của kho này (bmad-suite-v4/cline/templates/bmad-router.md:8), nên khi triển khai sang dự án khác cần phân giải lại vị trí tài nguyên, không thể chép nguyên mẫu rồi mặc định liên kết vẫn đúng.
Với Roo, bản đồ phân phối có các quy tắc toàn cục và một số chế độ được chọn (scripts/deployment_source.py:86). Nhưng tệp có mặt trên đĩa không chứng minh môi trường chủ đã nạp nó. Đáng chú ý, hai chế độ tùy chỉnh hiện không khai báo quyền MCP (bmad-suite-v4/roo/settings/custom_modes.yaml:5), trong khi bộ kiểm tra lại cố định nhóm quyền đó (scripts/validate-roo-contracts.py:158). Nếu kết nối công cụ chưng cất, cần xem xét cả cấu hình lẫn các thành phần kiểm tra, không chỉ sửa nội dung hướng dẫn.
Với Gemini, cách hiện tại là sao chép vật lý thư mục plugin và quy tắc (scripts/deployment_source.py:81), chưa phải một lượt cài đặt tiện ích mở rộng gốc đã được xác minh. Tiện ích mở rộng Gemini CLI có thể đóng gói kỹ năng và máy chủ MCP; khi cài đặt, Gemini tạo một bản sao và có cơ chế cập nhật riêng.11
9 Vì vậy, cần phân biệt rõ luồng sao chép hiện có với luồng tiện ích mở rộng gốc, thay vì gộp cả hai thành một cam kết hỗ trợ.
Rà soát cũng phát hiện một khoảng trống ở đường dẫn sau khi cài: quy tắc lõi toàn cục tham chiếu tương đối tới kỹ năng (bmad-suite-v4/rules/bmad-core.md:38), nhưng bản đồ phân phối đặt bản sao quy tắc và kỹ năng ở các vị trí khác nhau (scripts/deployment_source.py:83). Nếu phân giải đường dẫn tương đối theo vị trí tệp, liên kết đó không thể trỏ thẳng tới kỹ năng đã phân phối.
Ngoài ra, quy trình quản lý dự án còn có hai cách dùng song song. Lối vào dự án chọn một con trỏ nhiệm vụ duy nhất (specs/tasks/_active.md:10), trong khi quy tắc lõi phân phối vẫn dò kế hoạch hoạt động kiểu cũ (bmad-suite-v4/roo/rules/02-bmad-core.md:8). Phạm vi chỉnh sửa của chế độ phân tích cũng chưa bao gồm các vị trí tài liệu dự án mới (bmad-suite-v4/roo/settings/custom_modes.yaml:8).
Ranh giới nên rõ: cài đặt toàn cục chỉ chứa phương pháp luận, kỹ năng và lớp thích ứng môi trường có thể tái sử dụng; cấp dự án chỉ giữ lối vào, quy ước chuyên môn, quyết định và nhiệm vụ của chính dự án. Việc nguồn phân phối hiện không gom toàn bộ tài liệu dự án (scripts/deployment_source.py:64) là một ranh giới nên giữ.
Hướng đề xuất là để môi trường chủ gọi một máy chủ MCP cục bộ độc lập. Dịch vụ đọc dự án được cho phép, tạo tài liệu ứng viên và đưa tài liệu vào dự án qua lối xuất bản được duyệt. Phần phương pháp luận nên mô tả cách phát hiện và gọi dịch vụ, thay vì gộp toàn bộ mã nguồn dịch vụ vào gói quy tắc.
Khả năng dùng được phải được xác nhận theo chức năng. Quy trình xử lý dự án hiện có yêu cầu kiểm tra phiên bản, khai báo công cụ, độ phủ ngôn ngữ, thành phần gọi dịch vụ và khả năng chia nhỏ nội dung (bmad-suite-v4/skills/bmad/references/procedures/brownfield-distill-governance.md:22). Nhưng trong đợt rà soát này chưa đọc mã nguồn hiện tại của dịch vụ, nên không thể khẳng định giao diện hay cơ chế tự đăng ký đã sẵn sàng.
Với phân tích và lập trình thông thường, MCP nên là năng lực bổ sung. Với quy trình khởi tạo yêu cầu rõ ràng phải có bộ máy chưng cất, dịch vụ mới là điều kiện bắt buộc. Nếu thiếu dịch vụ, chỉ chặn bước phụ thuộc vào nó; không làm tê liệt toàn bộ phương pháp luận và cũng không được xem thao tác đọc tệp thông thường là đã nghiệm thu bộ máy chưng cất.
Quét ngoại tuyến, xác thực nguồn và năng lực diễn đạt tùy chọn của mô hình nên được tách lớp. Khi mô hình không khả dụng, hệ thống có thể giữ lại bằng chứng cấu trúc và ghi nhận điều chưa biết; không nên hứa rằng hiệu quả chưng cất ngữ nghĩa vẫn đầy đủ. Cách phân tầng này phù hợp với giới hạn ngoại tuyến trong quy trình hiện có (bmad-suite-v4/skills/bmad/references/procedures/brownfield-distill-governance.md:24).
Không nên lấy mô hình “GitHub cộng đường hầm SSH” làm kiến trúc mặc định. Vị trí phát hành mã nguồn và vị trí chạy dịch vụ là hai chuyện khác nhau. Máy chủ từ xa chỉ nên là lựa chọn khi có nhu cầu cụ thể, kèm quy định riêng về dữ liệu gửi ra ngoài, xác thực, cách ly dự án, mất kết nối và phụ thuộc vào dịch vụ mô hình. Đường hầm tự nó không giải quyết được các vấn đề đó.
Việc kết nối tự động cũng nên chia thành ba bước: đăng ký có chấp thuận lúc cài đặt, xác nhận năng lực khi sử dụng và gắn phiên bản dịch vụ vào đầu tác vụ. Không nên tự tải xuống, tự khởi động thử nghiệm hoặc nới lỏng quyền.
Đây là phạm vi công việc tiếp theo, không phải những hạng mục đã hoàn tất. Điểm nghẽn chính không nằm ở việc quy tắc phiên bản quá chặt, mà ở chỗ nguồn, đường phân phối, cơ chế nạp của từng môi trường và các thành phần tiêu thụ quy trình dự án chưa khép kín. Chỉ nên xem v4.3 là bản giao được sau khi hoàn tất các kiểm tra cần thiết — không phải ngay khi dòng phiên bản được đổi.
Studio Global AI
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.
Có thể thống nhất phiên bản công khai theo dạng v4.3, v4.4; nhưng rà soát hiện tại chưa đủ căn cứ để gọi kho mã là bản v4.3 sạch và sẵn sàng triển khai.
Có thể thống nhất phiên bản công khai theo dạng v4.3, v4.4; nhưng rà soát hiện tại chưa đủ căn cứ để gọi kho mã là bản v4.3 sạch và sẵn sàng triển khai. Bản rà soát chỉ đọc: chưa sửa phiên bản, xóa tệp, chạy kiểm thử hay triển khai.
Các điểm cần ưu tiên gồm một nguồn phiên bản duy nhất, kiểm tra CI, sửa tham chiếu sau cài đặt và xác minh riêng việc tích hợp Cline, Roo, Gemini.