Astronclaw Code Review

# AI Code Review Assistant

Safety Notice

This listing is from the official public ClawHub registry. Review SKILL.md and referenced scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "Astronclaw Code Review" with this command: npx skills add shixiangyu2/astronclaw-code-review

AI Code Review Assistant

🏆 科大讯飞 AstronClaw 养虾挑战赛参赛作品
🧠 AI驱动的智能代码审查助手，自动化代码质量、安全和性能分析

📋 技能概述

AI Code Review Assistant 是一个基于 AstronClaw 平台的智能代码审查技能，通过AI技术自动化分析代码质量、安全漏洞和性能问题，帮助开发者提升代码质量，降低技术债务。

核心价值

  • 🚀 自动化审查：一键式代码质量、安全、性能多维度分析
  • 🧠 AI智能建议：集成讯飞星火API，提供个性化改进建议
  • 🛡️ 安全加固：检测常见安全漏洞和风险模式
  • ⚡ 性能优化：识别性能瓶颈，提供优化方案
  • 📊 专业报告：生成详细审查报告（Markdown/HTML/JSON）

🚀 快速开始

安装方式

通过 AstronClaw SkillHub 安装

# 在 AstronClaw 平台搜索 "AI Code Review Assistant"
# 或通过 SkillHub 直接安装

本地开发模式

# 1. 克隆项目
git clone <repository-url>
cd astronclaw-code-review

# 2. 安装依赖
npm install

# 3. 运行测试
npm test

# 4. 启动开发服务
npm run dev

基本使用

// 在 AstronClaw 环境中使用
import { CodeReviewAssistant } from 'code-review-assistant';

// 初始化助手
const assistant = new CodeReviewAssistant({
  reviewLevel: 'standard',
  aiEnabled: true,
  includeSecurity: true,
  includePerformance: true
});

await assistant.init();

// 执行代码审查
const result = await assistant.reviewCode({
  filePath: 'src/main.js',
  code: `function example() { /* your code */ }`,
  options: {
    language: 'javascript'
  }
});

// 生成报告
const report = await assistant.generateReport({
  reviewResults: result,
  format: 'markdown'
});

🔧 可用工具

本技能提供5个核心工具，可在AstronClaw中直接使用：

1. CodeReview - 综合代码审查

描述: 质量、安全、性能多维度分析，集成AI智能建议
参数:

  • filePath (可选): 要审查的文件路径
  • code (可选): 直接提供代码内容
  • options.language: 编程语言（默认: 'javascript'）
# 使用示例
astronclaw CodeReview --filePath "src/app.js" --options.language "javascript"

2. CodeQualityScan - 代码质量专项扫描

描述: 规范检查、复杂度分析、重复代码检测
参数:

  • filePath (可选): 要扫描的文件路径
  • code (可选): 直接提供代码内容
# 使用示例
astronclaw CodeQualityScan --filePath "src/utils.js"

3. SecurityAudit - 安全审计

描述: 漏洞检测、敏感信息扫描、依赖安全检查
参数:

  • filePath (可选): 要审计的文件路径
  • code (可选): 直接提供代码内容
# 使用示例
astronclaw SecurityAudit --filePath "src/auth.js"

4. PerformanceAnalysis - 性能分析

描述: 瓶颈识别、优化建议、内存使用分析
参数:

  • filePath (可选): 要分析的文件路径
  • code (可选): 直接提供代码内容
# 使用示例
astronclaw PerformanceAnalysis --filePath "src/optimize.js"

5. GenerateReviewReport - 生成审查报告

描述: 生成Markdown/HTML/JSON格式的详细审查报告
参数:

  • reviewResults: 审查结果对象
  • format: 报告格式 ('markdown', 'html', 'json')
  • includeDetails: 是否包含详细问题列表（默认: true）
# 使用示例
astronclaw GenerateReviewReport --format "markdown" --includeDetails true

⚙️ 配置说明

技能配置 (skill.json)

{
  "reviewLevel": {
    "level": "standard",
    "includeSecurity": true,
    "includePerformance": true
  },
  "aiSettings": {
    "enabled": true,
    "provider": "iflytek-spark",
    "model": "spark-3.0"
  }
}

环境变量

# AI API配置
IFLYTEK_SPARK_API_KEY=your_api_key
IFLYTEK_SPARK_API_SECRET=your_api_secret

# 审查配置
REVIEW_LEVEL=advanced
AI_ENABLED=true

审查级别说明

  • basic: 基础审查 - 仅代码质量检查
  • standard: 标准审查 - 质量 + 安全 + 性能（默认）
  • advanced: 高级审查 - 包含架构评估和深度分析

📊 性能指标

审查能力

  • 支持语言: JavaScript/TypeScript (可扩展)
  • 分析速度: < 5秒/1000行代码
  • 准确率: > 85% (基于测试数据)
  • 报告生成: < 2秒

资源使用

  • 内存占用: < 100MB
  • CPU使用: < 30%
  • 网络请求: 仅AI分析时需外网

🎯 使用示例

示例1：综合代码审查

import { getCodeReviewAssistant } from './src/index.js';

async function example() {
  const assistant = getCodeReviewAssistant();
  
  const result = await assistant.reviewCode({
    code: `
      function processUserData(user) {
        // 硬编码API密钥（安全风险）
        const apiKey = "sk_live_1234567890";
        
        // SQL拼接（安全风险）
        const query = "SELECT * FROM users WHERE name = '" + user.name + "'";
        
        // 循环中字符串拼接（性能问题）
        let output = "";
        for (let i = 0; i < 1000; i++) {
          output += user.name + "-" + i;
        }
        
        return { query, output };
      }
    `,
    options: {
      language: 'javascript'
    }
  });
  
  console.log('审查结果:', result.summary);
  console.log('总体评分:', result.summary.overallScore);
  
  // 生成报告
  const report = await assistant.generateReport({
    reviewResults: result,
    format: 'html'
  });
  
  // 保存报告到文件
  require('fs').writeFileSync('code-review-report.html', report.content);
}

示例2：批量审查文件

const fs = require('fs');
const path = require('path');

async function reviewProject(projectPath) {
  const assistant = getCodeReviewAssistant();
  
  const files = fs.readdirSync(projectPath)
    .filter(file => file.endsWith('.js') || file.endsWith('.ts'))
    .map(file => path.join(projectPath, file));
  
  const results = [];
  
  for (const file of files) {
    console.log(`审查文件: ${file}`);
    
    const result = await assistant.reviewCode({
      filePath: file
    });
    
    results.push({
      file,
      score: result.summary.overallScore,
      issues: result.analysis.quality.issues.length + 
              (result.analysis.security?.issues?.length || 0) +
              (result.analysis.performance?.issues?.length || 0)
    });
  }
  
  // 生成项目总览报告
  const projectSummary = {
    totalFiles: results.length,
    averageScore: results.reduce((sum, r) => sum + r.score, 0) / results.length,
    totalIssues: results.reduce((sum, r) => sum + r.issues, 0),
    files: results
  };
  
  console.log('项目审查完成:', projectSummary);
  return projectSummary;
}

🧪 测试验证

运行测试

# 运行所有测试
npm test

# 运行特定测试
node test/basic.test.js

测试覆盖

  • ✅ 系统初始化测试
  • ✅ 综合代码审查测试
  • ✅ 专项工具测试
  • ✅ 报告生成测试
  • ✅ AI建议生成测试

🔍 技术架构

架构概述

┌─────────────────────────────────────────────┐
│            AstronClaw Platform             │
├─────────────────────────────────────────────┤
│      AI Code Review Assistant Skill         │
│  ┌─────────────────────────────────────┐   │
│  │          Core Engine                │   │
│  │  ┌─────────┐ ┌─────────┐ ┌───────┐ │   │
│  │  │ Tool    │ │ AI      │ │ Report│ │   │
│  │  │ System  │ │ Engine  │ │ Gen   │ │   │
│  │  └─────────┘ └─────────┘ └───────┘ │   │
│  └─────────────────────────────────────┘   │
│  ┌─────────────────────────────────────┐   │
│  │        Analysis Modules             │   │
│  │  • Code Quality                     │   │
│  │  • Security Audit                   │   │
│  │  • Performance Analysis             │   │
│  └─────────────────────────────────────┘   │
└─────────────────────────────────────────────┘

核心技术

  • 工具系统: 模块化工具架构，支持动态扩展
  • 规则引擎: 基于模式的代码分析规则
  • AI集成: 讯飞星火API智能分析
  • 报告系统: 模板化报告生成引擎

🛠️ 开发指南

项目结构

astronclaw-code-review/
├── SKILL.md              # 本文件
├── README.md             # 详细文档
├── package.json          # 项目配置
├── skill.json           # AstronClaw技能配置
├── src/
│   ├── index.js         # 主入口文件
│   ├── tool-system/     # 工具系统框架
│   └── tools/           # 5大核心工具
├── test/
│   └── basic.test.js    # 功能测试
└── examples/            # 使用示例

扩展技能

要添加新的分析工具：

  1. 在 src/tools/ 目录下创建新工具文件
  2. 实现工具类，包含 static async execute(args, context) 方法
  3. 在 src/index.js 的 registerCoreTools() 方法中注册工具
  4. 更新 skill.json 中的 capabilities.tools 列表

📞 支持与反馈

问题报告

贡献指南

  1. Fork 项目
  2. 创建功能分支 (git checkout -b feature/awesome-feature)
  3. 提交更改 (git commit -m 'Add awesome feature')
  4. 推送到分支 (git push origin feature/awesome-feature)
  5. 创建 Pull Request

代码规范

  • 使用 TypeScript 开发
  • 遵循 ESLint 规则
  • 添加单元测试
  • 更新相关文档

📄 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。

🙏 致谢

  • 科大讯飞: 提供 AstronClaw 平台和比赛机会
  • 讯飞星火: 提供AI能力支持
  • 开源社区: 众多优秀的开源项目参考

让每一行代码都经得起审查，让每一次提交都充满信心

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Open Registry RecordOpen in ClawHub

Related Skills

Related by shared tags or category signals.

General

Huo15 Openclaw Enhance

火一五·克劳德·龙虾增强插件 v5.7.8 — 全面适配 openclaw 2026.4.24：peerDep ^4.24 + build/compat 同步到 4.24 + 14 处 api.on 全部去掉 as any 改成 typed hook（hookName 联合类型 + handler 自动推断 Pl...

Registry SourceRecently Updated
3030zhaobod1
General

Content Trend Analyzer

Aggregates and analyzes content trends across platforms to identify hot topics, user intent, content gaps, and generates data-driven article outlines.

Registry SourceRecently Updated
260openlark
General

Prompt Debugger

Debug prompts that produce unexpected AI outputs — diagnose failure modes, identify ambiguity and conflicting instructions, test variations, compare model re...

Registry SourceRecently Updated
120charlie-morrison
General

Indie Maker News

独行者 Daily - 变现雷达。读对一条新闻，少走一年弯路。每天5分钟，给创业者装上商业雷达。聚焦一人公司、副业、创业变现资讯，智能分类，行动导向。用户下载即能用，无需本地部署！

Registry SourceRecently Updated
300kylnwu