bee-review

🐝 BeeReview - AI 蜂群代码审查

核心定位 (v1.6+)

BeeReview 是代码审查工具, 用自然语言即可使用。

用户不需要记参数, 直接说人话:

• ✅ /bee-review PhotoController.java
• ✅ /bee-review 看下 PaymentService.refund
• ✅ /bee-review 快速过一下 Util.java
• ✅ /bee-review 审查 src/payment 目录, 别外发
• ✅ 焦小糖, 帮我看下 OrderController.java (无 /bee-review, skill 自动触发)

5 个 Worker 角色

角色	关注点	模型
🛡 security	OWASP / 注入 / 鉴权	Claude Haiku 4.5
🧹 maintainability	KISS / SOLID / 命名	Claude Sonnet
🧠 logic	业务正确性 / 边界条件	DeepSeek-V4 Pro
⚡ performance	N+1 / 算法复杂度	Qwen3.6 Plus
😈 adversary	红队找其他人漏掉的问题	GPT-5

智能默认 (v1.6+)

用户不需要指定参数, 系统按文件类型/路径自动判断:

• Controller → 全 worker + 追依赖 1 层
• Service → security/logic/maintainability + 追依赖 1 层
• DTO/VO → 仅 maintainability
• 含敏感关键字 (auth/payment/credential) → 启用 L5 复审 + internal 隐私

反向确认 (v1.6+)

执行前展示参数解析结果, 用户可:

• Y 直接开始
• N 取消
• E 微调 (说"深度 2"/"加 L5"/"只看安全"等)
• 说"直接开始" / "别问了" → 跳过确认

偏好学习 (v1.6+)

系统记录用户每次实际用的参数, 6 个月后形成"个人默认":

• 老板审查 Controller 习惯 skip L5 → 自动 skip
• 老板审查 payment 目录习惯深度 2 → 自动深度 2

关键文件

• agents/bee-orchestrator.md - L1 编排器
• agents/bee-arbiter.md - L4 仲裁者
• commands/bee-review.md - Slash 命令入口
• scripts/lib/intent_parser.py - 自然语言解析
• scripts/lib/smart_defaults.py - 智能默认引擎
• scripts/lib/fuzzy_matcher.py - 模糊路径匹配
• scripts/lib/confirmation.py - 反向确认面板
• scripts/lib/preference_store.py - 偏好学习
• scripts/lib/render_html.py - HTML 报告渲染

不要做的事

• ❌ 强迫用户记参数 (有 Layer 1-3 自动处理)
• ❌ 没有确认就执行大成本操作 (Layer 4 强制)
• ❌ 不学习用户习惯 (Layer 5 持续优化)
• ❌ 把 BeeReview 当 git diff 工具

配置

• 主配置模板: ${CLAUDE_PLUGIN_ROOT}/scripts/config.json.template
• 用户配置: ~/.bee-review/config.json
• 用户偏好: ~/.bee-review/user-preferences.json (自动维护)
• 运行结果: ~/.bee-review/runs/<RUN_ID>/

故障排查

详见 ${CLAUDE_PLUGIN_ROOT}/docs/troubleshooting.md