Agent Harness (Khung điều phối agent)
Biến một mục tiêu thành kế hoạch công việc có thể kiểm chứng, rồi chạy vòng lặp agent có giới hạn với xác minh bằng máy, hạn mức thử lại và cơ chế báo lên người.
Tự động hóaNâng cao★ 26,260⑂ 3,699Điểm AI 9/10Cập nhật lần cuối: 30 thg 8, 2026
Làm được gì
- Biên dịch mục tiêu thành kế hoạch có thể kiểm chứng (plan.json); nếu mục tiêu quá chung chung thì từ chối (exit 3) và đưa ra các câu hỏi bắt buộc.
- Chọn manifest theo domain (18 domain có sẵn) để biết skill, tool và check nào tồn tại.
- Bộ điều khiển vòng lặp chạy
execute → verifytừng task một và tự thực thi lệnh kiểm tra qua subprocess, ghi log bằng chứng. Agent không được tự tuyên bố 'đã đạt'. - Hết hạn mức (3 lần thử/task, 12 vòng lặp) thì escalate cho con người, tuyệt đối không báo thành công giả.
- Trạng thái nằm trong
.agent-harness/state.json, phiên mới chỉ cần đọc file đó là tiếp tục được.
Phù hợp với ai
- Lập trình viên, tech lead muốn giao việc dài cho agent nhưng chặn kiểu 'báo cáo xong mà chưa xong'
- Người xây pipeline tự động ghép nhiều skill, cần khả năng resume theo state
- Ai cần hạn mức thử lại, cổng phê duyệt và log kiểm toán cho công việc lặp lại
Ví dụ sử dụng
- Đưa mục tiêu "audit dịch vụ thanh toán và thiết kế SLO kèm error budget" vào harness engineering để chạy tới khi mọi task được verify
- Thiết lập vòng lặp cho domain marketing: tạo sản phẩm chiến dịch → chạy check → close
- Dùng
--sampleđể xem một lần verify thất bại tiêu tốn một attempt và chỉ close khi có bằng chứng pass
· · · Hướng dẫn cài đặt · · ·
Dùng thử ngay, không cần cài
Dán đoạn dưới vào Claude là dùng được skill này mà không cần cài đặt.
Hãy đọc hướng dẫn trong tệp này và làm theo để giúp mình: https://raw.githubusercontent.com/alirezarezvani/claude-skills/HEAD/.gemini/skills/agent-harness/SKILL.md Mình muốn: (viết việc bạn cần ở đây)
Nếu Claude không mở được liên kết, hãy mở liên kết và copy nội dung vào rồi dán.
↓ Thấy hữu ích thì tải ZIP bên dưới và cài. Sau đó skill tự chạy, không phải dán lại mỗi lần.
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 .gemini/skills/agent-harness từ repo GitHub alirezarezvani/claude-skills vào ~/.claude/skills/agent-harness/ 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/alirezarezvani/claude-skills.git && mkdir -p ~/.claude/skills/agent-harness && cp -r claude-skills/.gemini/skills/agent-harness/* ~/.claude/skills/agent-harness/⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.
- Mở terminal và clone repo:
git clone https://github.com/alirezarezvani/claude-skills.git - Tạo thư mục skill:
mkdir -p ~/.claude/skills/agent-harness - Copy nội dung:
cp -r claude-skills/.gemini/skills/agent-harness/* ~/.claude/skills/agent-harness/ - Kiểm tra đã copy đủ
scripts/,assets/harnesses/,references/(thiếu thì vòng lặp không chạy được). - Đảm bảo có Python 3:
python3 --version - Chạy thử:
python3 ~/.claude/skills/agent-harness/scripts/loop_controller.py --sample, kết thúc với mã 0 là ổn. - Khởi động lại Claude Code và yêu cầu kiểu "chạy mục tiêu này qua agent harness" để kích hoạt skill.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT