# Hướng dẫn Đóng góp cho Moltbot

Chào mừng bạn đến với "bể tôm hùm"! 🦞 Rất vui vì bạn đã ở đây.

## Đường dẫn nhanh (Quick Links)
- **GitHub Repo:** [moltbot/moltbot](https://github.com/moltbot/moltbot)
- **Discord Cộng đồng:** [Tham gia ngay](https://discord.gg/qkhbAGHRBT)
- **Theo dõi cập nhật:** [@steipete](https://x.com/steipete) / [@moltbot](https://x.com/moltbot)

## Đội ngũ Phát triển

- **Peter Steinberger** - Bếp trưởng (Benevolent Dictator)
  - GitHub: [@steipete](https://github.com/steipete)
- **Shadow** - Phụ trách Discord + Slack
  - GitHub: [@thewilloftheshadow](https://github.com/thewilloftheshadow)
- **Jos** - Phụ trách Telegram, API & Nix mode
  - GitHub: [@joshp123](https://github.com/joshp123)

## Làm sao để đóng góp?

1.  **Gặp lỗi (Bug) hoặc muốn sửa nhỏ:** Cứ thoải mái mở Pull Request (PR) nhé!
2.  **Tính năng mới / Thay đổi kiến trúc:** Khoan hãy code vội. Hãy mở một [Thảo luận trên GitHub](https://github.com/moltbot/moltbot/discussions) hoặc vào Discord hỏi trước để tránh mất công vô ích.
3.  **Có câu hỏi:** Vào kênh `#setup-help` trên Discord.

## Trước khi gửi PR (Checklist)

- [ ] Đã chạy thử code trên máy của bạn (chưa toang là được).
- [ ] Chạy linter để code sạch đẹp: `npm run lint`.
- [ ] Giữ PR tập trung: 1 PR giải quyết 1 vấn đề thôi.
- [ ] Mô tả rõ ràng: Bạn làm cái gì, và tại sao lại làm thế?

## PR do AI viết (Vibe-Coded)? Thoải mái luôn! 🤖

Bạn dùng Codex, Claude, ChatGPT để viết code? **Tuyệt vời! Chúng tôi ủng hộ điều đó.**

Nhưng hãy giúp reviewer bằng cách:
- [ ] Ghi rõ "AI-assisted" trong tiêu đề hoặc mô tả PR.
- [ ] Cho biết bạn đã test kỹ đến đâu (Chưa test / Test sơ sơ / Test kỹ càng).
- [ ] Nếu được, đính kèm cả prompt hoặc log chat với AI (cái này cực hữu ích để học hỏi lẫn nhau).
- [ ] Quan trọng nhất: **Xác nhận là bạn hiểu đoạn code đó làm gì**. Đừng copy-paste mù quáng nhé.

*Chúng tôi coi các PR từ AI là công dân hạng nhất. Chỉ cần minh bạch để mọi người dễ làm việc.*

## Lộ trình phát triển hiện tại (Roadmap) 🗺

Chúng tôi đang tập trung vào đâu?
- **Ổn định (Stability):** Sửa các lỗi vặt khi kết nối kênh (WhatsApp/Telegram).
- **Trải nghiệm (UX):** Làm cho quá trình cài đặt (onboarding) mượt hơn, thông báo lỗi dễ hiểu hơn.
- **Kỹ năng (Skills):** Làm giàu thư viện kỹ năng có sẵn và giúp dev tạo kỹ năng mới dễ hơn.
- **Hiệu suất (Performance):** Tiết kiệm token và tối ưu bộ nhớ.

Bạn chưa biết bắt đầu từ đâu? Hãy tìm các issue có nhãn ["good first issue"](https://github.com/moltbot/moltbot/issues) nhé!