Adversarial Spec (Tranh luận đa LLM để hoàn thiện spec)
Kỹ năng cho nhiều mô hình (GPT, Gemini, Grok...) cùng Claude phản biện lẫn nhau để tinh chỉnh PRD hoặc tài liệu kỹ thuật cho đến khi tất cả đồng thuận.
Tài liệu · Văn phòngTrung cấp★ 556⑂ 49Điểm AI 9/10Cập nhật lần cuối: 22 thg 1, 2026
Làm được gì
- Cung cấp hai khung tài liệu: PRD (yêu cầu sản phẩm) và Technical Spec (kiến trúc), kèm bộ tiêu chí phê bình riêng cho từng loại.
- Gửi tài liệu song song tới các mô hình bạn chọn (GPT, Gemini, Grok, Mistral, Groq, Deepseek, GLM, Codex CLI, Gemini CLI...) để nhận phê bình; Claude cũng tự đưa ra phê bình độc lập rồi tổng hợp.
- Lặp tối đa 10 vòng cho đến khi mọi bên trả
[AGREE]; nếu mô hình đồng ý quá sớm, dùng cờ--pressđể buộc chứng minh đã đọc kỹ. - Có chế độ phỏng vấn sâu trước khi tranh luận, chọn trọng tâm (security, scalability, performance, ux, reliability, cost), gán persona (security-engineer, QA, legal-compliance...), nạp tài liệu ngữ cảnh, lưu/khôi phục session, checkpoint từng vòng và thống kê chi phí token.
- Kết quả cuối được in ra và ghi vào
spec-output.md; sau PRD có thể tiếp tục sinh tech spec tương ứng.
Phù hợp với ai
- PM, founder viết tài liệu sản phẩm một mình và lo bỏ sót yêu cầu.
- Dev/kiến trúc sư trong nhóm nhỏ, thiếu người review thiết kế.
- Người đã có API key nhiều nhà cung cấp hoặc Codex/Gemini CLI và chấp nhận chi phí gọi mô hình.
Ví dụ sử dụng
- "Viết PRD cho luồng onboarding thanh toán mới" → phỏng vấn yêu cầu, tạo bản nháp, gửi cho gpt-4o và gemini phản biện, sau 3 vòng lưu PRD đã đồng thuận vào
spec-output.md. - Nạp file
./docs/auth-spec.mdrồi chạy--focus security --persona security-engineerđể soi lỗ hổng xác thực và kiểm tra đầu vào. - Vòng 1 dùng mô hình nhanh/rẻ để kiểm tra cấu trúc, vòng 2 dùng o1 hoặc claude-opus để xác thực lại, cuối cùng xem báo cáo tổng số vòng và thay đổi chính.
· · · 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/zscole/adversarial-spec/HEAD/skills/adversarial-spec/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 skills/adversarial-spec từ repo GitHub zscole/adversarial-spec vào ~/.claude/skills/adversarial-spec/ 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/zscole/adversarial-spec.git /tmp/adversarial-spec && mkdir -p ~/.claude/skills && cp -r /tmp/adversarial-spec/skills/adversarial-spec ~/.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.
- Tải repo:
git clone https://github.com/zscole/adversarial-spec.git - Sao chép kỹ năng vào thư mục skills của Claude Code:
mkdir -p ~/.claude/skills && cp -r adversarial-spec/skills/adversarial-spec ~/.claude/skills/ - Đảm bảo có Python 3.10+ và cài gói bắt buộc:
pip install litellm(đừng cài góillmcủa Simon Willison). - Khai báo API key cho nhà cung cấp bạn dùng, ví dụ:
export OPENAI_API_KEY=...,export GEMINI_API_KEY=...(thêm vào~/.zshrcđể dùng lâu dài). - Nếu muốn dùng gói đăng ký thay vì API key:
npm install -g @openai/codex && codex loginhoặcnpm install -g @google/gemini-cli && gemini auth. - Kiểm tra cấu hình:
python3 "$(find ~/.claude -name debate.py -path '*adversarial-spec*' | head -1)" providers - Khởi động lại Claude Code và yêu cầu ví dụ: "Hãy tinh chỉnh PRD này bằng tranh luận đa mô hình".
- (Tùy chọn) Nếu gặp lỗi xung đột xác thực giữa token claude.ai và
ANTHROPIC_API_KEY, chạyunset ANTHROPIC_API_KEY.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT