（11862期）afrexai-code-reviewer – 企业级代码质量评估框架

企业级代码质量评估框架 基于SPEAR框架的企业级代码审查指南，提供Security/Performance/Error Handling/Architecture/Reliability五维评分体系，帮助团队标准化代码质量评估流程。 使用说明 核心用法 afrexai-code-reviewer 是一个纯文档型的企业级代码审查框架，通过 SPEAR 五维评估体系 为代码审查提供结构化方法论。用户可通过自然语言指令触发审查，支持 GitHub PR、本地 diff、单文件或粘贴代码四种输入模式。核心工作流程为：输入代码 → 自动套用 SPEAR 框架 → 生成标准化评分报告。 SPEAR 框架的五个维度及其权重分别为：Security（安全，3x）、Performance（性能，2x）、Error Handling（错误处理，2x）、Architecture（架构，1.5x）、Reliability（可靠性，1.5x）。每个维度下设 10-12 项具体检查点，覆盖 60+ 种语言特定模式（TypeScript/Python/Go/Java/SQL 等）。评分采用扣分制：CRITICAL 问题扣 3 分、HIGH 扣 2 分、MEDIUM 扣 1 分、LOW 扣 0.5 分，最终换算为 0-100 分并给出五级 verdict（EXCELLENT/GOOD/NEEDS WORK/SIGNIFICANT ISSUES/BLOCK）。 显著优点 框架化思维：将主观代码审查转化为可量化的评分体系，大幅降低评审者认知负担，同时保证审查覆盖面的完整性。Security 维度 3 倍权重的设计体现了"安全优先"的工程原则。 语言覆盖全面：不仅提供通用检查项，还针对主流语言列出典型反模式（如 Python 的 bare except、Go 的 error 丢弃、JavaScript 的 any 类型滥用），实用性极强。 输出标准化：强制使用统一的 Markdown 报告模板，包含执行摘要、维度得分表、分级 findings、正向反馈、优先建议五大模块，便于团队沉淀审查知识。 零依赖设计：纯指导性 Skill，无需安装任何工具链或配置环境，开箱即用。 潜在缺点与局限性 执行依赖人工：该 Skill 仅为审查指南，不自动分析代码，所有检查需评审者手动完成，无法替代静态分析工具（如 SonarQube、CodeQL）的自动化能力。 评分主观性：虽然提供了扣分标准，但"God function >50 行"等阈值、以及问题严重程度的判定仍依赖评审者经验，不同人可能给出差异较大的评分。 语言更新滞后：新兴语言特性（如 Rust 的 async、Zig 的 comptime）或框架特定模式（如 React Server Components）可能未被及时覆盖。 大型 PR 适配性：虽提及>500 行 PR 应拆分，但未提供有效的增量审查策略，实际执行中可能因信息量过大而流于形式。 适合的目标群体 技术团队负责人：需要建立团队代码审查规范，统一评审标准 初级/中级开发者：希望系统学习代码质量维度，提升审查能力 开源项目维护者：处理外部贡献时快速评估 PR 质量 代码审计顾问：为客户提供结构化审查报告时作为方法论支撑 使用风险 性能风险：无。纯文档型 Skill，无计算开销。 依赖风险：无第三方依赖，但需注意该 Skill 本身不产生审查结果，实际效果完全取决于使用者的工程判断力。 误用风险：过度依赖评分可能导致"分数导向"而非"质量导向"的审查文化；建议将 SPEAR 作为辅助框架，而非唯一决策依据。 原始说明 Enterprise-grade code review agent. Reviews PRs, diffs, or code files for security vulnerabilities, performance issues, error handling gaps, architecture smells, and test coverage. Works with any language, any repo, no dependencies required.