oh-my-openagent-toolkit - Bộ công cụ vận hành cục bộ bắt đầu từ Claude Code và ổn định với OpenCode/oh-my-openagent

Xin chào.
Từ hồi dùng Claude Code rất nhiều, tôi đã cảm thấy rằng khi thực sự gắn AI coding agent vào dự án để sử dụng, cuối cùng điều cần thiết không chỉ là bản thân mã nguồn mà còn là một lớp giải thích “trong dự án này thì nên làm việc như thế nào”.

Ví dụ như những thứ sau:

• Yêu cầu nào thì nên được định tuyến đi đâu
• Nên gắn built-in helper nào thì phù hợp
• Phạm vi hỗ trợ nào là thứ có thể khẳng định mạnh mẽ ngay lúc này
• Nên tạo tác vụ mới ở đâu, và nên xử lý dự án hiện có như thế nào
• Với phần refinement thuộc UI thì nên bắt đầu từ đâu và chồng lên như thế nào cho đúng

Ban đầu tôi cứ tiếp tục tinh chỉnh theo cách của mình ở phía Claude Code, rồi giữa chừng cũng thử chuyển sang OpenCode, và hiện tại thì đã ổn định trên nền oh-my-openagent, gói nó lại thành một dạng có thể dùng nhất quán hơn trong các dự án cục bộ.
Lần này tôi đã công khai nó với tên gọi oh-my-openagent-toolkit.

GitHub:
https://github.com/HanTechnology/oh-my-openagent-toolkit

Đây là gì?

Nếu nói trong một dòng,
đây là một project-local companion toolkit dùng trên OpenCode + oh-my-openagent.

Cụ thể hơn một chút,
nó không nhằm thay thế upstream harness mà gần với việc đặt thêm một lớp lên trên để làm rõ hơn lớp vận hành cục bộ.
Những gì repo này bổ sung chủ yếu là các phần sau.

• thin routing
  • Sắp xếp việc yêu cầu nên được gửi đi đâu
  • Hướng dẫn rõ ràng hơn category / helper nào là phù hợp
• skill surface
  • Sắp xếp top-level entrypoint dưới .opencode/skills/
  • Hiện có 43 entrypoint, trong đó 40 là core surface, 3 là planned adjacent pack
• support boundary
  • Tách validated / guided / planned
  • Phân biệt giữa “có vẻ làm được” với “thứ hiện tại có thể công khai khẳng định mạnh mẽ”
• workspace convention
  • Sắp xếp cách đọc từ repo root và lấy đâu làm cơ sở để làm việc
• UI refinement layer
  • Gói nhóm impeccable lại trong môi trường cục bộ
  • Để khi làm UI có thể chồng thêm refinement layer lên trên primary route

Vì sao tạo ra nó?

Khi gắn AI coding agent vào dự án thực tế, sẽ có lúc bạn nhận ra rằng điều quan trọng hơn việc “agent có thông minh hay không” là “trong dự án này agent phải vận hành theo quy tắc nào”.

Đặc biệt khi có nhiều domain trộn lẫn thì lại càng như vậy.

• frontend / backend / systems / data / security / QA
• Ranh giới giữa triển khai và kiểm chứng
• Sự phân biệt giữa tài liệu hóa và validated surface thực tế
• Khi nào nên gắn agent helper và khi nào thì không

Thay vì mỗi lần đều viết dài trong prompt hoặc chỉ giữ những điều đó trong đầu người dùng,
tôi nghĩ tốt hơn là để lại chúng như một lớp vận hành mỏng bên trong dự án nên đã tạo ra repo này.
Tôi cũng ghi rõ những gì repo này không định làm.

Đây không phải ba điều dưới đây.

• (X) Bản phân phối upstream chính thức của oh-my-openagent
• (X) Một runtime mới thay thế harness
• (X) Thêm một control plane khác ở môi trường cục bộ

Tức là đây là một companion toolkit đặt trên upstream,
chứ không phải hướng tới việc tạo thêm một framework mới nữa.

Hiện tại làm được tới đâu?

Ở đây tôi cũng cố không đặt ra các ràng buộc quá mức.
Hiện repo này có broad skill surface (43 kỹ năng bao trùm việc phát triển nói chung),
nhưng những gì hiện đang để ở trạng thái validated là 4 mục sau.

• frontend-product-delivery
• backend-service-delivery
• cloud-release-readiness
• ai-data-product-delivery

Các phần còn lại được phân loại là guided hoặc planned.

Phù hợp với ai?

Nó có thể phù hợp với những người như sau.

• Những người đã dùng OpenCode hoặc đang muốn thử dùng
• Những người muốn có lớp vận hành dự án cục bộ rõ ràng hơn trên nền oh-my-openagent
• Những người đang vận hành AI coding agent thực tế theo đơn vị repo/worktree
  và muốn sắp xếp routing / support boundary / workspace rule
• Những người muốn để lại tri thức vận hành ngay trong dự án thay vì chỉ viết prompt thật dài

Thử nhanh

Với repo này, về cơ bản bạn có thể làm theo thứ tự như sau.

1. Cài đặt OpenCode
2. Thiết lập oh-my-openagent
3. Clone repo
4. Chạy opencode
5. Vibe coding với tổ hợp Sisyphus hoặc Prometheus + Atlas của oh-my-openagent

Cuối cùng

Thay vì là một thứ đã hoàn thiện,
nó gần hơn với một bộ công cụ vận hành cục bộ mà tôi tự sắp xếp vì thực sự cần đến trong quá trình chuyển từ Claude Code → OpenCode → oh-my-openagent.

Nếu có ai từng có những trăn trở tương tự, rất mong nhận được phản hồi.

Repo:

https://github.com/HanTechnology/oh-my-openagent-toolkit