🥊 Sparring
AI 写代码，另一个 AI 找茬。
像拳击陪练一样，互相推动变强——直到代码值得上线。
一句话： 你描述任务，Claude 写方案+代码，Cursor/Codex/GLM 找茬，人类只在关键节点拍板。
Sparring 是 Claude Code 的插件。它给 Claude 配一个"对手"——专门挑毛病的第二个 AI，以"假设有 bug，找到它"的心态审查方案和代码。最多 5 轮，直到双方一致。
English
📰 What's New
- 2026-05 · 🔥 支持智谱 GLM 作为第三个审查后端，配合主/备降级机制；新增 JSON 配置系统（
~/.config/sparring/config.json + .sparring/config.json），支持团队共享；仓库正式更名为 sparring（旧 workflow 命令保留为软链兼容）
- 2026-04 · 🎯 新增 Codex CLI 后端 + 后台 review job（长耗时 review 可异步跑）
- 2026-03 · 首发：Claude + Cursor 双 AI 协作 + 最多 5 轮 review 机制；GitHub Issue 驱动工作流（从 Project 看板接任务，讨论自动同步到 Issue 评论）
🌟 核心特性
🥊 双 AI 对抗式审查
一个 AI 写，另一个 AI 找茬。不是互相夸奖，是像拳击陪练那样互相逼出更好的输出。最多 5 轮，直到双方一致才放行。
|
🎛️ 三后端可选 + 主备降级
cursor / codex / glm 任选，还能配主+备。主 backend CLI 调用失败时（超时 / 网络错 / 进程异常退出）自动切备，工作流不阻塞。
|
⚙️ 四层配置系统
内置默认 → 全局 config → 项目 config → 环境变量。API key 放全局（chmod 600），backend 选型放项目（团队共享），临时覆盖走 env。一键 sparring config init 初始化。
|
📋 GitHub Issue 驱动
从 Project 看板认领 Issue，AI 讨论自动同步到 Issue 评论，完成后开 PR。全程带身份标记（🧠 Claude / 🤖 Cursor / 🧪 Codex / 🌟 GLM），协作过程可追溯。
|
🤔 为什么需要
AI 写代码快，但会犯错——幻觉 API、漏掉边界、引入回归。让人逐行 review？不现实。
| 没有 Sparring | 有 Sparring |
|---|
| AI 的每个结论 | 直接告诉你 | 先过另一个 AI 审一遍 |
| 漏掉边界情况 | 🤷 发 PR 才发现 | 🛡️ reviewer 在 review 环节抓住 |
| 看起来对但有隐患 | 😬 上线后出事 | 🎯 "假设有 bug 找它" 的视角挑出来 |
| Cursor/Codex 挂了 | ❌ 工作流卡住 | 🔄 自动降级到备用 backend |
| 两个 AI 视角不一致 | — | ✅ 必然至少两种意见，降低盲区 |
效果：AI 产出更可靠，人工 review 更少，心智负担更低。
🚀 快速开始
1. 安装插件
# 在 Claude Code 里
/plugin marketplace add krislavten/sparring
/plugin install sparring@sparring
2. 初始化（自动装依赖 + 选模型）
# 退出 Claude Code 后重新打开
/sparring:setup
3. 开干
/sparring:workflow 给登录接口加 rate limiting
就这样。Claude 写方案 → Cursor 找茬 → 你确认 → Claude 实现 → Cursor 再找茬 → 你合并。
🎮 三种模式
| 模式 | 命令 | 适用场景 |
|---|
| 💬 普通 | /sparring:workflow <任务> | 你参与方案讨论，AI 双方自动完成审查，你最后拍板 |
| 🚀 YOLO | /sparring:yolo <任务> | AI 全自动，你只确认最终提交。小改动 / 明确任务 |
| 🎫 Issue | /sparring:issue <看板URL> [编号] | 从 GitHub Issue 接任务，讨论同步到 Issue 评论 |
🔁 工作流程
你描述任务
↓
┌─────────────────┐
│ Claude 写方案 │
└────────┬────────┘
↓
┌─────────────────┐ CONCERNS
│ Reviewer 挑战方案 │─────────┐
└────────┬────────┘ ↓
↓ APPROVE Claude 修改
↓ (最多 5 轮)
你确认
↓
┌─────────────────┐
│ Claude 写代码 │
└────────┬────────┘
↓
┌─────────────────┐ CONCERNS
│ Reviewer 挑战代码 │─────────┐
└────────┬────────┘ ↓
↓ APPROVE Claude 修复
↓ (最多 5 轮)
你确认并提交
交叉审查原则：Claude 给你任何建议或结论之前，都会先让 reviewer 审一遍。"建议用 Redis 做缓存" → 先让 reviewer 质疑 → 确认或调整 → 再告诉你。
🎛️ 审查后端
三种 backend，可自由组合主备：
| Backend | 账号 | 特点 | 推荐场景 |
|---|
🤖 cursor | Cursor 订阅 | 默认后端，gpt-5.5-extra-high | 日常主力 |
🧪 codex | OpenAI 订阅 | Codex CLI，reasoning 可调 | Codex 额度充足 |
🌟 glm | 智谱按量付费 | 国产、API key 就能用 | 降级兜底 / 无订阅 |
主 + 备降级
主 backend 调用失败（超时 / 网络错 / CLI 异常）时自动切到备，工作流不阻塞：
⚠ 主 backend Cursor Agent 调用失败，降级到 GLM...
三种典型组合：
// A) Cursor 主 + GLM 备（推荐，Cursor 抽风也不阻塞）
{ "review": { "backend": "cursor", "fallback": "glm" } }
// B) Codex 主 + GLM 备（Codex 额度省着用）
{ "review": { "backend": "codex", "fallback": "glm" } }
// C) 纯 GLM（无订阅，按量付费）
{ "review": { "backend": "glm" } }
⚙️ 配置系统
四层优先级（低→高）：内置默认 → 全局 → 项目 → 环境变量。
sparring config init # 生成 ~/.config/sparring/config.json（chmod 600，存 api_key）
sparring config init project # 生成 .sparring/config.json（团队共享，不放 key）
sparring config show # 看合并后的配置（key 自动掩码）
sparring config get glm.api_key # 取单值（敏感字段掩码）
