Trợ lý QA cho opencode
Kỹ năng chuyên dụng để kiểm thử CLI, HTTP server, plugin hook/event, TUI của opencode và tra cứu phiên làm việc trong SQLite DB.
Lập trìnhNâng cao★ 67,531⑂ 5,507Điểm AI 7/10Cập nhật lần cuối: 9 thg 8, 2026
Kỹ năng này làm gì
Đây là bộ công cụ QA dành riêng cho chính agent opencode. Nó chia nhu cầu kiểm thử thành bốn tình huống, mỗi tình huống gắn với một script đã được kiểm chứng và một tài liệu tham chiếu chuyên sâu.
- Case A – CLI: chạy
opencode run --format jsonđể kiểm tra kết quả theo từng sự kiện, không cần tương tác. - Case B – Server / hook / event: mở luồng SSE tại
/eventđể chứng minh một hook hay sự kiện thực sự được kích hoạt; smoke test/global/health,/docvà hành vi 401 khi thiếu xác thực. - Case C – TUI: khởi chạy TUI trong tmux ở môi trường cô lập, xác nhận nó render và nhận phím; nếu cần bằng chứng hình ảnh cho PR thì dùng web terminal xterm.js.
- Case D – Điều tra DB: đọc (chỉ đọc) SQLite DB để tìm phiên theo id, tiêu đề hoặc nội dung tin nhắn, và xuất toàn bộ phiên ra JSON.
Mọi script đều có --self-test, và bất kỳ thao tác nào khởi chạy opencode đều dùng sandbox XDG cô lập nên DB thật không bị ghi rác.
Phù hợp với ai
- Lập trình viên đóng góp cho opencode hoặc duy trì một bản fork, cần kiểm thử hồi quy.
- Người viết plugin opencode và muốn xác minh hook có thực sự chạy hay không.
- Người cần tìm nhanh một cuộc hội thoại trong DB phiên đã phình lên hàng chục GB.
Ví dụ sử dụng
- "Chứng minh hook
message.part.updatedcủa plugin tôi có chạy" → gắn SSE probe vào server thật rồi gửi prompt bằngprompt_asyncđể bắt sự kiện. - "Tìm các phiên có chữ 'permission denied' trong 7 ngày qua" →
db-session-by-text.sh --since "7 days"rồi xuất phiên tìm được ra JSON. - "Kiểm tra TUI bản build mới có khởi động bình thường không" →
tui-smoke.sh --self-testvà đối chiếu số phiên trong DB thật trước/sau.
· · · Hướng dẫn cài đặt · · ·
Cài vào ứng dụng Claude (không cần terminal)
- Tải tệp ZIP bằng nút bên dưới.
- Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
- Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.
Cài vào Claude Code
Để Claude làm — dán câu dưới đây vào Claude Code
Hãy cài skill mình tìm thấy trên Claude Skill Mart. Copy thư mục .agents/skills/opencode-qa từ repo GitHub code-yeongyu/oh-my-openagent vào ~/.claude/skills/opencode-qa/ của mình. Sau khi cài xong, cho mình biết skill này làm được gì trong một câu.
Cài bằng lệnh thủ công
git clone https://github.com/code-yeongyu/oh-my-openagent.git && mkdir -p ~/.claude/skills && cp -r oh-my-openagent/.agents/skills/opencode-qa ~/.claude/skills/⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.
- Cài các phụ thuộc:
opencode,sqlite3,curl,jq,tmux(trên macOS:brew install sqlite jq tmux). - Tải mã nguồn:
git clone https://github.com/code-yeongyu/oh-my-openagent.git - Sao chép thư mục kỹ năng:
mkdir -p ~/.claude/skills && cp -r oh-my-openagent/.agents/skills/opencode-qa ~/.claude/skills/ - Khởi động lại Claude Code và kiểm tra
opencode-qaxuất hiện trong danh sách kỹ năng. - Kiểm tra bộ khung:
cd ~/.claude/skills/opencode-qa && bash scripts/lib/common.sh --self-check - Chạy
opencode --version(tài liệu viết theo v1.17.7) rồi gọi kỹ năng bằng câu như "QA giúp mình opencode". - Lưu ý: đọc DB là an toàn, nhưng mọi thao tác khởi chạy opencode nên đi qua script để dùng sandbox cô lập.
Xem mã nguồn trên GitHub ↗Giấy phép: NOASSERTION