holetexvn/oncall-agent
8 stars · Last commit 2026-08-22
Claude Code chạy theo sự kiện trên VPS: nhiều khách gặp cùng một lỗi → agent tái hiện, tìm root cause, fix + test, mở PR, xin duyệt qua Telegram. Kèm bộ ví dụ đầy đủ về skill, hook, MCP, subagent, plugin.
README preview
# oncall-agent
Claude Code **chạy theo sự kiện** trên VPS, như bài toán production thật:
lỗi xảy ra → **đủ ngưỡng nhiều khách hàng gặp** mới kích hoạt → agent **verify (tái hiện)** → phân tích theo **skill** → fix + test → mở PR → Telegram **xin duyệt kèm link** → **người bấm Merge/Close** ngay trên Telegram.
Repo demo cho video HoleTex × Hostinger. Đã test với Claude Code **2.1.235**.
```
khách 1,2,3 ──lỗi──▶ Sentry ──webhook──▶ receiver/ (đếm: ≥3 khách trong 30 phút?) ──▶ worker/ (claude -p + skill incident-triage)
│ verify → root cause → fix → test → gh pr create
▼
reporter/ Telegram [🔗 PR] [✅ Merge] [❌ Đóng]
│
approve-bot.js: người bấm → gh pr merge --squash
```
## Luồng demo (Section 7 của video)
1. `demo-app/simulate-customers.sh http://<VPS>:3000 3` — 3 khách khác nhau gặp cùng lỗi
2. Receiver log: `users=1/3 → chờ`, `2/3 → chờ`, `3/3 → TRIGGER` (dưới ngưỡng thì **không** tốn tiền)
3. Worker chạy skill `incident-triage`: tái hiện bằng curl → đọc log → root cause → branch `fix/incident-<id>` → test → PR `[on-call]`
4. Telegram nhận: tiêu đề, 👥 số khách, root cause, confidence, nút **🔗 PR / ✅ Merge / ❌ Đóng**