Dual-Brain — Kỹ năng gắn ‘quy trình tranh biện kiểu não trái·não phải’ vào Codex/Claude Code

Xin chào. Gần đây khi dùng Codex hoặc Claude Code trong công việc thực tế, tôi muốn giới thiệu Dual-Brain, một giao thức skill mở đang được phát triển dưới dạng mã nguồn mở nhằm giảm các vấn đề như LLM dễ bị quá tải khi viết mã phức tạp hoặc lật lại những quyết định trước đó.

Dual-Brain không giống cách chia cho AI các vai trò như “PM / developer / QA”, mà gần hơn với việc tách riêng các chức năng tư duy để nhìn nhận vấn đề.

Thay vì để một agent đưa ra câu trả lời ngay lập tức, nó buộc phải đi qua lần lượt phần thẩm vấn ngữ cảnh của vai trò não phải và phần kiểm chứng logic của vai trò não trái, rồi orchestrator mới tổng hợp kết quả cuối cùng.

1. Ba kiểu thất bại của cách chạy agent đơn lẻ hiện có

Khi giao cho LLM thiết kế kiến trúc phức tạp hoặc refactor ngay trong terminal trong một lần, thường sẽ hay gặp các vấn đề sau.

• Cái bẫy của việc tiếp nhận nguyên xi câu chữ
  Nó chấp nhận nguyên trạng các yêu cầu mơ hồ rồi tự tin build ra đoạn mã hoàn toàn lệch hướng.
• Địa ngục của chi tiết
  Nó sa lầy vào cú pháp mã ở cấp vi mô và các edge case, khiến bỏ lỡ một hướng đi kiến trúc đơn giản và tốt hơn.
• Vòng lặp mất trí nhớ
  Khi phiên làm việc kết thúc, ngữ cảnh trước đó biến mất, nên đến phiên sau lại lật lại hướng kiến trúc đã quyết từ tuần trước.

2. Giải pháp: hai chức năng tư duy

Khi tải Dual-Brain, agent chính đảm nhận vai trò orchestrator và không trả lời ngay. Thay vào đó, nó thực thi hai bước rà soát nội bộ theo đúng thứ tự đã định.

• Não phải, Right Brain: ngữ cảnh / mẫu hình / thẩm vấn
  Nó không triển khai ngay yêu cầu của người dùng mà trước tiên sẽ nghi ngờ. Nó xem xét các câu hỏi như “Điểm mù của yêu cầu này là gì?”, “Nó có xung đột với các quyết định trước đây không?”, “Thuật ngữ có mơ hồ không?”.
• Não trái, Left Brain: logic / kiểm chứng / mã
  Nó đối chiếu phần định nghĩa vấn đề do não phải tạo ra với codebase thực tế, tài liệu chính thức và bộ nhớ dự án. Nó lọc bỏ API ảo giác, các giả định đã lỗi thời, các thiết kế không thể triển khai, rồi tinh chỉnh thành dạng có thể thực thi.

Cuối cùng, orchestrator tổng hợp hai kết quả để tiếp tục tới thay đổi mã, tài liệu hóa và cập nhật memory.

3. Hệ thống phân cấp bộ nhớ

Skill lưu bộ nhớ dài hạn trong .dual-brain/MEMORY.md ở thư mục gốc của dự án.

Tuy nhiên, khi dự án càng lớn, có thể phát sinh vấn đề là các quyết định từ rất lâu trước đây và các ràng buộc đang còn hiệu lực từ tuần trước bị trộn lẫn với cùng một trọng số. Để giải quyết điều này, memory không được xử lý như một tài liệu phẳng mà như bộ nhớ phân tầng.

• Hot Memory
• Warm Memory
• Cold Memory
• Archived Decisions

Hot Memory là các quyết định và ràng buộc đang hoạt động, có ảnh hưởng mạnh tới công việc hiện tại.

Warm Memory là ngữ cảnh hữu ích chỉ được đọc trong các công việc liên quan.

Cold Memory và Archived Decisions sẽ không được đọc toàn bộ theo mặc định, mà chỉ được tra cứu khi cần tìm kiếm từ khóa hoặc kiểm tra xung đột.

refs không tăng chỉ vì đã đọc, mà chỉ tăng khi thực sự ảnh hưởng đến câu hỏi / kiểm chứng / tổng hợp / triển khai.

Các ký ức đã cũ hoặc trùng lặp sẽ được nén tự động, còn các quyết định mâu thuẫn hoặc đã bị loại bỏ sẽ được chuyển sang Archived.

Thông tin nhạy cảm, token, key và dữ liệu cá nhân sẽ không được lưu hoặc tóm tắt, mà được xử lý như đối tượng cần loại bỏ/không lưu.

Điểm quan trọng là memory không phải là nguồn chân lý. Trong Dual-Brain, memory là advisory context, và mã hiện tại cùng tài liệu chính thức được ưu tiên hơn stale memory.

4. Benchmark

Trong repo có kèm một benchmark harness nhỏ để so sánh cách single-agent và Dual-Brain theo tiêu chuẩn của Codex.

Dual-Brain không phải là cách nhanh hơn. Ngược lại, mục tiêu của nó là khiến hệ thống suy nghĩ nhiều hơn ở giai đoạn đầu, để giảm vòng lặp con người phải quay lại sửa và giải thích về sau.

5. Cài đặt

Nếu dùng SkillsGate, bạn có thể cài đặt và quản lý skill trong môi trường Codex CLI và Claude Code.

npx skillsgate add sleeplesshan/dual-brain -g  
Cũng có thể cài đặt thủ công.  
 - Codex  
Bash  
git clone [https://github.com/sleeplesshan/dual-brain.git](https://github.com/sleeplesshan/dual-brain.git) ~/.codex/skills/dual-brain  
 - Claude Code  
Bash  
git clone [https://github.com/sleeplesshan/dual-brain.git](https://github.com/sleeplesshan/dual-brain.git) ~/.claude/skills/dual-brain  
Sau khi cài đặt, bạn có thể gọi nó bằng ngôn ngữ tự nhiên như bình thường.  
  
6. Khi nào nên dùng
Dual-Brain là quá mức cần thiết cho các chỉnh sửa đơn giản. Không nhất thiết phải dùng cho việc đổi tên biến, sửa lỗi một dòng hay boilerplate rõ ràng.
Thay vào đó, nó phù hợp với các tình huống sau.
- refactor với yêu cầu mơ hồ
- quyết định kiến trúc
- tích hợp API hoặc SDK chưa quen thuộc
- các thay đổi có thể xung đột với quyết định trước đó
- công việc mà hallucinated API có thể dẫn tới sự cố thực tế
- công việc kiểu “thậm chí tôi cũng không chắc mình đang đặt đúng câu hỏi hay không”
  
Toàn bộ `SKILL.md` và benchmark harness đã được công khai dưới dạng mã nguồn mở (giấy phép MIT).
 Tôi muốn nhận phản hồi từ những người quan tâm đến thiết kế LLM orchestration, prompt engineering và agent memory.