mturac/promptguard

🔍 PromptGuard: Kiểm tra hợp đồng prompt cho các agent AI

Như một linter cho trách nhiệm, an toàn và hợp đồng thực thi — trước khi agent làm việc.

PromptGuard là công cụ kiểm tra prompt hoạt động như hợp đồng hành vi. Dành cho các workflow agent nơi prompt mơ hồ dẫn đến kết quả kém, đặc biệt khi agent sắp sửa file, ghi đè system prompt, hoặc ship code.

✨ Điểm nổi bật

• Audit hành vi: Kiểm tra xem task có rõ ràng, agent có trách nhiệm rõ ràng, output có định dạng rõ ràng không.
• Phát hiện đầy đủ: Báo cáo lỗi cụ thể bằng mã PG001–PG015 (ví dụ: xung đột bảo mật, ranh giới agent, thiếu hợp đồng output).
• Zero dependency: Chạy ngay bằng python3 -m promptguard audit, không cần cài đặt hay API model.
• Agent-native: Cài đặt adapter riêng cho Codex, Claude Code, OpenCode, OpenClaw — kiểm tra prompt trước khi ghi.
• Báo cáo chi tiết: Cho biết quyết định còn thiếu, câu hỏi cần hỏi, hợp đồng cần có, cách sửa prompt.
• Tích hợp CI/CD: Xuất báo cáo dưới dạng JSON, Markdown, table; lưu vào .promptguard/reports.jsonl.
• Portable skill: Bundle skills/promptguard có thể cài vào bất kỳ agent nào mà không cần cài toàn cục.
• Eval cases: Bộ test mẫu trong eval/ giúp đánh giá chất lượng prompt.

💡 Vì sao đáng chú ý

Không chỉ nói "prompt xấu", PromptGuard phân tích nguyên nhân và gợi ý cách sửa cụ thể. Thích hợp với các team dùng agent AI để dev, nơi prompt mơ hồ dễ gây lỗi nghiêm trọng. Cài đặt adapter và khởi động lại agent — mọi thay đổi prompt-like sẽ được kiểm tra tự động trước khi ghi.

#PromptGuard #AIAgents #PromptEngineering #DevOps #OpenSource #TiniX