{"id":51569251,"url":"https://github.com/saqqdy/ai-code-reviewer-plus","last_synced_at":"2026-07-10T18:01:18.618Z","repository":{"id":369230489,"uuid":"1275869645","full_name":"saqqdy/ai-code-reviewer-plus","owner":"saqqdy","description":"AI-powered intelligent code reviewer — multi-dimensional semantic analysis, five-tier severity classification, actionable fix suggestions via Claude Code Skill","archived":false,"fork":false,"pushed_at":"2026-07-04T07:54:48.000Z","size":423,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-07-04T09:14:06.795Z","etag":null,"topics":["ai-code-reviewer-plus","claude-code","claude-code-plugin","claude-code-skill","code-review","intelligent-review","pr-review","semantic-analysis"],"latest_commit_sha":null,"homepage":"https://www.saqqdy.com/ai-code-reviewer-plus","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/saqqdy.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-21T08:36:21.000Z","updated_at":"2026-07-04T08:17:23.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/saqqdy/ai-code-reviewer-plus","commit_stats":null,"previous_names":["saqqdy/ai-code-reviewer"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/saqqdy/ai-code-reviewer-plus","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saqqdy%2Fai-code-reviewer-plus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saqqdy%2Fai-code-reviewer-plus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saqqdy%2Fai-code-reviewer-plus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saqqdy%2Fai-code-reviewer-plus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/saqqdy","download_url":"https://codeload.github.com/saqqdy/ai-code-reviewer-plus/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saqqdy%2Fai-code-reviewer-plus/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35338653,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-10T02:00:06.465Z","response_time":60,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-code-reviewer-plus","claude-code","claude-code-plugin","claude-code-skill","code-review","intelligent-review","pr-review","semantic-analysis"],"created_at":"2026-07-10T18:00:54.645Z","updated_at":"2026-07-10T18:01:18.569Z","avatar_url":"https://github.com/saqqdy.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🚀 AI Code Reviewer Plus\n\n\u003e AI-powered intelligent code reviewer — multi-dimensional semantic analysis, five-tier severity classification, actionable fix suggestions via Claude Code Skill.\n\n[![npm version](https://img.shields.io/npm/v/ai-code-reviewer-plus.svg)](https://www.npmjs.com/package/ai-code-reviewer-plus)\n[![license](https://img.shields.io/npm/l/ai-code-reviewer-plus.svg)](https://github.com/saqqdy/ai-code-reviewer-plus/blob/master/LICENSE)\n\n[中文文档](README_CN.md) | [完整文档](https://ai-code-reviewer-plus.vercel.app)\n\n---\n\n## 🎯 The Problem It Solves\n\nTraditional linters catch syntax errors, but miss **semantic issues**:\n\n```typescript\n// Linter: ✅ No syntax errors\nfunction processUser(input: any) {\n  return input.name.trim()  // Runtime: 💥 if input is null\n}\n```\n\nQuestions linters can't answer:\n- Is this business logic correct?\n- Are there security vulnerabilities?\n- Will this cause performance issues?\n- Is this maintainable?\n\n| Scenario | Traditional Linter | AI Code Reviewer |\n|----------|-------------------|------------------|\n| \"Is this safe?\" | Pattern matching, can't understand context | AI understands business semantics |\n| \"How to fix?\" | Reports error only | Provides executable fix snippets |\n| \"Is it critical?\" | Binary pass/fail | 5-tier severity: BLOCKER → SUGGESTION |\n\n---\n\n## ✨ The Solution\n\nAI Code Reviewer uses **semantic understanding** across five dimensions:\n\n| Dimension | Focus | Example Rules |\n|-----------|-------|---------------|\n| **Correctness** | Logic errors, null pointers | COR-001: Null check missing |\n| **Security** | XSS, SQL injection, data leakage | SEC-001: User input unsanitized |\n| **Performance** | N+1 queries, memory leaks | PER-001: Loop inside loop |\n| **Maintainability** | Duplicate code, complexity | MAIN-001: Duplicated logic |\n| **Best Practices** | Framework conventions | BP-001: Vue reactive rules |\n\n## 📊 Five-Tier Severity\n\nNot all issues are equal. AI Code Reviewer classifies by impact:\n\n| Level | Icon | Meaning | Action |\n|-------|------|---------|--------|\n| **BLOCKER** | 🚫 | Must fix, blocks merge | Fix immediately |\n| **HIGH** | 🔴 | Critical, breaks functionality | Fix this iteration |\n| **MEDIUM** | 🟡 | Important, affects quality | Plan to fix |\n| **LOW** | 🟢 | Minor, polish level | Fix later |\n| **SUGGESTION** | 💡 | Optional improvement | Optional |\n\n---\n\n## ✨ Core Features\n\n### 🔍 Multi-Dimensional Analysis\n\n- **Correctness** — Logic errors, null pointers, boundary conditions\n- **Security** — XSS, SQL injection, data leakage\n- **Performance** — N+1 queries, memory leaks, unnecessary re-renders\n- **Maintainability** — Duplicate code, complexity, naming\n- **Best Practices** — Framework conventions, code style\n\n### 📊 Five-Tier Severity Classification\n\n| Level | Meaning | Action |\n|-------|---------|--------|\n| 🚫 BLOCKER | Must fix, blocks merge | Fix immediately |\n| 🔴 HIGH | High priority | Fix this iteration |\n| 🟡 MEDIUM | Medium priority | Plan to fix |\n| 🟢 LOW | Low priority | Fix later |\n| 💡 SUGGESTION | Optional improvement | Optional |\n\n---\n\n## 🚀 Getting Started\n\n### Option 1: Claude Code Plugin (Recommended)\n\n```bash\n# In Claude Code, run:\n/plugin marketplace add saqqdy/ai-code-reviewer-plus\n/plugin install ai-code-reviewer-plus\n```\n\n#### Available Commands\n\n| Command | Description |\n|---------|-------------|\n| `/review [branch]` | Review diff against target branch |\n| `/review-file \u003cfile\u003e` | Review a single file |\n| `/review-commit \u003chash\u003e` | Review a specific commit |\n\n### Option 2: CLI (Zero-Install)\n\n```bash\nnpx ai-code-reviewer-plus review --branch main\nnpx ai-code-reviewer-plus review-file src/index.ts\nnpx ai-code-reviewer-plus review-commit abc1234\n```\n\n### Option 3: Programmatic Usage\n\n```bash\npnpm add ai-code-reviewer-plus\n```\n\n```typescript\nimport { collectDiff, detectProject } from 'ai-code-reviewer-plus'\n\nconst diffs = await collectDiff({\n  root: process.cwd(),\n  targetBranch: 'main'\n})\n\nconst project = await detectProject(process.cwd())\n```\n\n---\n\n## 📋 Example Output\n\n```\n/review main\n\n🔍 Reviewing diff against main...\n\n📁 Project: vue3 (typescript)\n📝 Files changed: 3\n\n📊 Review Summary:\n- Total findings: 12\n- 🚫 Blockers: 1\n- 🔴 High: 3\n- 🟡 Medium: 5\n- 🟢 Low: 2\n- 💡 Suggestions: 1\n\n🚫 Blockers (Must Fix):\n\n- 🚫 **SEC-001** [BLOCKER] `src/auth.ts:45`\n  **XSS vulnerability in user input**\n  \n  User input is directly rendered without sanitization.\n  ```typescript\n  element.innerHTML = userInput  // 💥 Dangerous!\n  ```\n  \n  💡 **Fix**: Sanitize user input before rendering.\n  ```typescript\n  element.textContent = sanitize(userInput)\n  ```\n  \n  Confidence: 🟢 High\n```\n\n---\n\n## 🚀 Quick Experience\n\nNot sure where to start? Follow this path:\n\n| Step | Method | Time | What You'll See |\n|------|--------|------|-----------------|\n| 1 | CLI | 1 min | Diff collection + project detection |\n| 2 | API example | 3 min | Programmatic interface + formatting |\n| 3 | Skill | 5 min | **Full review** (rules + AI analysis) |\n\n**Fastest path**: Install the Skill, run `/review main` — one command, full experience.\n\n```bash\n# Step 1: Try CLI instantly (in any git repo)\nnpx ai-code-reviewer-plus review --branch main\n\n# Step 2: Run the API example\ngit clone https://github.com/saqqdy/ai-code-reviewer-plus.git\ncd ai-code-reviewer-plus \u0026\u0026 pnpm install\nnpx tsx examples/basic-usage.ts\n\n# Step 3: Full AI-powered review (in Claude Code)\n/plugin install ai-code-reviewer-plus\n/review main\n```\n\n---\n\n## ⚙️ Configuration\n\nCreate `.ai-code-reviewer-plus.yml` to customize:\n\n```yaml\nrules:\n  enabled:\n    - COR-001  # Null pointer check\n    - SEC-001  # XSS prevention\n    - SEC-002  # SQL injection\n    - PER-001  # N+1 query detection\n  disabled:\n    - STYLE-001  # Naming conventions\n  severityOverrides:\n    SEC-001: BLOCKER  # XSS must fix immediately\n\nexcludePaths:\n  - node_modules/\n  - dist/\n  - coverage/\n\nmaxFindingsPerFile: 20\noutputFormat: markdown\n```\n\n---\n\n## 🗂️ Project Structure\n\n```\nai-code-reviewer-plus/\n├── .claude/skills/ai-code-reviewer-plus/  # Claude Code Skill\n├── src/                               # TypeScript source\n│   ├── collectors/                    # Git data collectors\n│   ├── utils/                         # Utilities\n│   └── types.ts                       # Type definitions\n├── docs/                              # VitePress docs\n└── examples/                          # Usage examples\n```\n\n---\n\n## 🛠️ Development\n\n```bash\npnpm install          # Install dependencies\npnpm run lint         # ESLint check\npnpm run typecheck    # TypeScript check\npnpm run test         # Run tests\npnpm run build        # Build (ESM + CJS)\npnpm run docs:dev     # Start docs server\n```\n\n---\n\n## 📋 Version Roadmap\n\n| Version | Theme | Status |\n|---------|-------|--------|\n| v0.1.0 | Core framework + CLI + Skill | ✅ Current |\n| v0.2.0 | Rule library + AI analysis engine | 📋 Planned |\n| v1.0.0 | Production-ready + Marketplace | 📋 Planned |\n\n---\n\n## 📄 License\n\n[MIT](./LICENSE)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsaqqdy%2Fai-code-reviewer-plus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsaqqdy%2Fai-code-reviewer-plus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsaqqdy%2Fai-code-reviewer-plus/lists"}