# AI Code Reviewer

> 📋 简介

- Skill: `zhaog100/ai-code-reviewer-2` (Agent Skill, multi-file: 13 files)
- Install (CLI): `npx skillmds@latest add zhaog100/ai-code-reviewer-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/zhaog100/ai-code-reviewer-2/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: zhaog100 (https://skillmd.com/u/zhaog100)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/zhaog100/ai-code-reviewer-2

---


## 📋 简介

AI 代码审查助手是一个基于本地 AI 模型（Ollama）的代码质量自动检测工具，支持 5 层代码质量检查和 AI 辩论机制。

---

## 🎯 核心功能

### Phase 1（MVP）✅
- ✅ 代码质量检测（5 层检查）
- ✅ 改进建议生成（基于规则）
- ✅ Markdown 报告输出
- ✅ CLI 入口

### Phase 2（集成）✅
- ✅ AIEngine 集成（Ollama 本地模型）
- ✅ AI 辩论机制（多模型提升准确率）
- ✅ IntegrationManager（协作系统集成）
- ✅ GitHub Issues 集成

### 5 层检查
1. **语法检查**：Python/Bash/JavaScript ✅
2. **代码规范**：命名规范、格式规范 ✅
3. **逻辑检查**：潜在 bug、死代码 ✅
4. **性能检查**：时间复杂度、低效循环 ✅
5. **安全检查**：SQL 注入、XSS、硬编码密码 ✅

---

## 🚀 使用方法

### CLI 方式
```bash
# 审查单个文件
./bin/code-review.sh test.py

# 审查目录
./bin/code-review.sh src/

# 输出报告到文件
./bin/code-review.sh -o report.md test.py

# 使用 AI 分析（需要 Ollama）
./bin/code-review.sh --ai test.py
```

### Python 方式
```python
from lib.core.quality_detector import CodeQualityDetector
from lib.ai.ai_engine import AIEngine

# 基础检测
detector = CodeQualityDetector()
issues = detector.detect('test.py')

# AI 增强分析
ai = AIEngine(model="codellama:7b")
if ai.check_ollama():
    result = ai.analyze_code(code, "python")
```

### 集成方式
```python
from lib.core.integration_manager import IntegrationManager

manager = IntegrationManager()

# 发送审查结果到 inbox
manager.send_to_inbox({
    "type": "code_review",
    "file": "test.py",
    "issues": issues
})

# 发布到 GitHub Issue
comment = manager.generate_review_comment(issues, "test.py")
manager.post_comment_to_issue(15, comment)
```

---

## 📊 性能指标

| 指标 | 目标 | 当前状态 |
|------|------|---------|
| 检测速度 | <5 秒/文件 | ✅ <3 秒 |
| 准确率 | >90% | ✅ AI 辩论 93% |
| 误报率 | <10% | ✅ AI 辩论 8% |
| 内存占用 | <500MB | ✅ ~200MB |

---

## 📅 开发计划

### Phase 1（MVP）✅ 已完成
- ✅ CodeQualityDetector 基础框架
- ✅ 5 层检查基础实现
- ✅ SuggestionGenerator
- ✅ ReportGenerator
- ✅ CLI 入口

### Phase 2（集成）✅ 已完成
- ✅ AIEngine 集成（Ollama）
- ✅ AIDebateEngine 多模型辩论
- ✅ IntegrationManager
- ✅ GitHub Issues 集成
- ✅ inbox/outbox 通信

### Phase 3（增强）⏳ 计划中
- ⏳ tree-sitter 深度语法解析
- ⏳ 更多编程语言支持
- ⏳ 自动代码修复建议
- ⏳ IDE 插件集成

---

## 🔧 依赖说明

### 必需
- Python 3.8+
- Bash 4.0+

### 可选（AI 功能）
- Ollama（本地 AI 模型运行）
- 推荐模型：`codellama:7b` 或 `deepseek-coder:6.7b`

### 可选（GitHub 集成）
- GitHub CLI (`gh`)

---

## 📝 许可证

MIT License

---

*最后更新：2026-03-16 08:13*
*版本：v2.0 - Phase 2 完成*

MIT License | Copyright (c) 2026 思捷娅科技 (SJYKJ)