用途:面向团队制定代码规范、配置 Lint/Formatter、建立 Code Review 标准,并识别与偿还技术债。
主要能力:整理 SOLID 五原则(含正反例)、命名规范(函数动词开头、布尔 is_/has_/can_、常量 UPPER_SNAKE_CASE 等)、函数设计(理想 <20 行、上限 <50 行,参数 ≤3,嵌套 ≤3 层,早返回)、代码异味速查(Long Method、Duplicate Code、Magic Number、God Class、Feature Envy 等)与对应解法;Code Review 必查清单(业务正确性、代码质量、测试、安全、性能、可维护性)、Comment 标签([blocking]/[suggestion]/[nit]/[question]/[praise])与作者/评审者实践;重构时机与步骤、技术债识别、记录与偿还。
配置示例:ESLint(complexity 10、max-lines-per-function 50)、Prettier、Checkstyle(MethodLength 50、ParameterNumber 4、CyclomaticComplexity 10)、Ruff + mypy + black、golangci-lint(启用 govet、errcheck、staticcheck、gosec、gocyclo、dupl 等);SonarQube 通过 sonar-scanner 与 check-quality-gate 接入 CI,质量门禁含新代码覆盖率 ≥80%、重复率 ≤3%、严重漏洞/Bug 为 0 等。另含 templates/code-review-checklist.md。
限制:以上为资料中的建议性规范与示例,具体阈值、门禁标准及工具版本需按团队实际调整;资料未提供具体安装命令、价格与平台支持信息。