Claude Skill MartKhám phá skillCâu dùng ngayHọc qua videoDùng terminalSkill là gì?
 
← Về danh sách

Adversarial Spec — Tinh chỉnh tài liệu đặc tả bằng tranh luận đa LLM

Cho GPT, Gemini, Grok... và Claude tranh luận qua nhiều vòng để hoàn thiện 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òngNâng cao★ 553⑂ 48Điểm AI 8/10Cập nhật lần cuối: 22 thg 1, 2026

Làm được gì

Biến bản nháp đặc tả thành tài liệu sẵn sàng triển khai thông qua các vòng phản biện giữa nhiều mô hình.

  • Hai loại tài liệu: PRD (vấn đề, persona, user story, chỉ số thành công, phạm vi) hoặc Tech Spec (kiến trúc, hợp đồng API, mô hình dữ liệu, bảo mật, observability, triển khai).
  • Chế độ phỏng vấn: đặt câu hỏi sâu theo 8 nhóm chủ đề (vấn đề, người dùng, yêu cầu, ràng buộc kỹ thuật, UX, đánh đổi, rủi ro, tiêu chí thành công) trước khi viết bản nháp.
  • Gọi song song nhiều nhà cung cấp: qua litellm (OpenAI, Anthropic, Google, xAI, Mistral, Groq, DeepSeek, OpenRouter, Zhipu), hoặc CLI codex/gemini, hoặc toàn bộ qua AWS Bedrock cho doanh nghiệp.
  • Chống đồng thuận hời hợt: nếu mô hình nói [AGREE] ở vòng 1–2, dùng cờ --press để bắt nó chứng minh đã đọc hết tài liệu.
  • Tính năng nâng cao: --focus, --persona, --context để nạp tài liệu/schema hiện có, lưu và tiếp tục session, checkpoint từng vòng, --preserve-intent, thống kê chi phí token, thông báo Telegram.
  • Khi đồng thuận, tài liệu cuối được ghi vào spec-output.md; nếu là PRD có thể tiếp tục sinh Tech Spec.

Phù hợp với ai

  • PM hoặc founder không có đội reviewer để phản biện đặc tả.
  • Tech lead muốn phát hiện lỗ hổng thiết kế và edge case trước khi bắt đầu sprint.
  • Đội doanh nghiệp cần định tuyến mọi lời gọi mô hình qua AWS Bedrock vì yêu cầu tuân thủ.

Ví dụ sử dụng

  1. "Viết PRD cho tính năng đối soát thanh toán, bắt đầu bằng chế độ phỏng vấn" → phỏng vấn sâu, ra bản nháp, rồi gpt-4o và gemini chỉ ra chỉ số mơ hồ qua 3–4 vòng.
  2. Nạp ./docs/auth-spec.md với --focus security --persona security-engineer để soi kỹ xác thực, phân quyền và kiểm tra dữ liệu vào.
  3. Chu kỳ 1 dùng mô hình rẻ để kiểm tra tính đầy đủ, chu kỳ 2 dùng mô hình mạnh (o1, opus) để xác nhận lần cuối.

· · · 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)
  1. Tải tệp ZIP bằng nút bên dưới.
  2. Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
  3. Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.
↓ Tải ZIP
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.

  1. Chuẩn bị: cài Python 3.10+ rồi chạy pip install litellm. Không cài gói llm của Simon Willison.
  2. Thiết lập xác thực: đặt ít nhất một API key, ví dụ export OPENAI_API_KEY=sk-... hoặc export GEMINI_API_KEY=.... Nếu dùng gói thuê bao: npm install -g @openai/codex && codex login hoặc npm install -g @google/gemini-cli && gemini auth.
  3. Cài skill: 
    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/
  4. Kiểm tra provider: chạy python3 "$(find ~/.claude -name debate.py -path '*adversarial-spec*' | head -1)" providers.
  5. Xử lý xung đột đăng nhập: nếu báo lỗi vừa có token claude.ai vừa có ANTHROPIC_API_KEY, hãy unset ANTHROPIC_API_KEY hoặc claude /logout.
  6. Dùng thử: khởi động lại Claude Code và yêu cầu "tinh chỉnh PRD theo kiểu adversarial"; skill sẽ hỏi loại tài liệu và mô hình đối thủ.
  7. (Tùy chọn) Telegram: tạo bot qua @BotFather, đặt TELEGRAM_BOT_TOKEN và TELEGRAM_CHAT_ID, rồi thêm cờ --telegram.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT