用途
quality 是一个综合代码质量评估技能,用于在提交、合并或发布代码之前,对 spaces/[project]/ 目录下的项目进行全面的质量检查,帮助团队保持一致的代码质量标准。
主要能力
该技能通过多智能体(multi-agent)分析,从多个维度评估代码质量:
- 代码质量:圈复杂度、代码重复、SOLID 原则、死代码检测
- 安全:OWASP Top 10、认证/授权模式、输入验证、代码中的密钥
- 性能:N+1 查询检测、低效算法、打包体积、缓存机会
- 测试:行/分支覆盖率、测试质量、边界情况覆盖、集成测试缺口
评估结果以评分(0-100)和状态呈现:
- 90-100:Excellent,可发布
- 80-89:Good,需小幅改进
- 70-79:Acceptable,应尽快处理
- 60-69:Concerning,合并前需修复
- <60:Critical,必须修复
使用方式
命令支持指定项目,并可通过 --focus 标志聚焦特定维度。
/quality yourbench # 完整评估
/quality yourbench --focus security # 安全聚焦
/quality coordinatr --focus testing # 测试覆盖率聚焦
各聚焦维度对应的分析内容与负责智能体:
| 标志 | 分析 | 智能体 |
|---|---|---|
| (无) | 所有维度 | 所有专业智能体 |
| --focus security | OWASP、漏洞 | security-auditor |
| --focus performance | 瓶颈、N+1 | performance-optimizer |
| --focus testing | 覆盖率、测试质量 | test-engineer |
| --focus code | 可维护性 | code-reviewer |
执行流程
- 定位项目
ls spaces/[project]/
- 运行自动化检查
cd spaces/[project]
npm test -- --coverage
npm run lint
npm run type-check # if TypeScript
- 智能体分析
通过 Task 工具协调各专业智能体:
- code-reviewer:复杂度、最佳实践
- security-auditor:OWASP Top 10
- performance-optimizer:N+1 查询、瓶颈
- test-engineer:覆盖率、测试质量
- 生成报告
报告格式如下:
## Quality Assessment: [project]
**Overall Score: XX/100** [status]
### Code Quality: XX/100
- Issues found
- Recommendations
### Security: XX/100
- Critical/High/Medium issues
- Recommendations
### Performance: XX/100
- Bottlenecks identified
- Recommendations
### Testing: XX/100
- Coverage percentage
- Untested areas
### Priority Actions
1. **CRITICAL**: [action]
2. **HIGH**: [action]
3. **MEDIUM**: [action]
适用场景
- 重大发布之前
- 接手新代码库时
- 定期健康检查
- 重构之前
限制
资料未提供该技能所依赖的运行时或平台要求、安装方式、收费模式、支持的编程语言范围,以及各自动化检查脚本的具体配置要求。