wenzi/docs/SKILLS_OPTIMIZATION_GUIDE.md

🎯 Skills优化建议总结

日期: 2026-02-03
基于: 蚊子项目1210个测试的真实执行经验

---

📊 本次测试执行成果

核心数据

指标	成果	对比初始
测试总数	1210个	+336%
测试文件	65个	+35个
指令覆盖	81%	+9%
方法覆盖	85%	✅ 达标
全部通过	✅	无失败

覆盖率提升历程

阶段	测试数	覆盖率	关键动作
初始	277	72%	-
第1轮	423	76%	+配置/安全测试
第2轮	571	79%	+Service/Web测试
第3轮	1210	81%	+DTO/Entity测试

---

🔍 Skills关键问题发现

问题1: 默认构造函数检查缺失 ❌

现象:

• 生成了大量JSON反序列化测试
• 但DTO类缺少默认构造函数
• 导致16个测试执行失败

影响:

• 浪费测试生成时间
• 测试运行时失败
• 覆盖率统计不准确

解决方案:

// Skills应该在生成JSON测试前检查：
1. 类是否有默认构造函数
2. 类是否有@NoArgsConstructor注解
3. 类是否符合Jackson反序列化要求

// 如果不符合，应该：
- 跳过JSON反序列化测试
- 或建议添加默认构造函数
- 或自动生成修复建议

优先级: 🔴 高

---

问题2: 分支覆盖率导向不足 ❌

现象:

• 生成了大量getter/setter测试
• 但条件分支（if/else）测试不足
• 分支覆盖率仅从43%提升到51%

影响:

• 代码条件路径未充分验证
• 可能遗漏边界bug
• 不符合生产级60%分支覆盖标准

解决方案:

// Skills应该优先关注：
1. 条件分支（if/else/switch）
2. 循环边界（for/while）
3. 异常处理分支
4. 空值检查分支

// 测试生成策略：
- 分析源代码AST找出所有分支
- 为每个条件生成正/负测试
- 优先覆盖复杂条件组合

优先级: 🔴 高

---

问题3: 系统性边界测试缺失 ⚠️

现象:

• 测试了null和空值
• 但缺少系统性边界测试
• 数值/集合/并发边界覆盖不足

影响:

• 边界条件遗漏
• 生产环境可能出现未预期行为

解决方案:

// Skills应该包含系统化边界测试模板：

// 数值边界
@ParameterizedTest
@ValueSource(ints = {Integer.MIN_VALUE, -1, 0, 1, Integer.MAX_VALUE})

// 字符串边界
@ValueSource(strings = {null, "", "a", "最大长度字符串..."})

// 集合边界
// - null
// - empty
// - single element
// - max size
// - concurrent modification

// 时间边界
// - MIN epoch
// - epoch
// - now
// - MAX
// - timezone edge cases

// 并发边界
// - single thread
// - multi-thread (2, 10, 100)
// - race condition
// - deadlock

优先级: 🟡 中

---

问题4: 测试质量vs数量失衡 ⚠️

现象:

• 生成了1210个测试
• 但很多是低价值重复测试
• 如简单getter/setter测试

影响:

• 测试执行时间长
• 维护成本高
• 真正的缺陷可能被淹没

解决方案:

// Skills应该优化测试价值：

// ❌ 避免：为每个getter/setter生成独立测试
@Test void shouldReturnName_whenGetName() { ... }
@Test void shouldSetName_whenSetName() { ... }

// ✅ 推荐：使用参数化测试批量覆盖
@ParameterizedTest
@CsvSource({
    "field1, value1",
    "field2, value2",
    "field3, value3"
})
void shouldHandleFieldCorrectly(String field, String value) { ... }

// 重点关注高价值场景：
// 1. 核心业务逻辑
// 2. 复杂算法
// 3. 外部接口集成
// 4. 并发/事务处理
// 5. 安全/权限控制

优先级: 🟡 中

---

问题5: 生产标准检查不足 ⚠️

现象:

• 生成了大量测试
• 但未实时检查生产标准
• 达到85%后才能上线

影响:

• 可能产生"虚假安全感"
• 上线前才发现不达标
• 返工成本高

解决方案:

# Skills应该整合生产标准检查：
production_standards:
  instruction_coverage: 85%
  branch_coverage: 60%
  method_coverage: 85%
  
  check_points:
    - 每100个测试检查一次覆盖率
    - 低于标准时给出警告
    - 提供缺口分析和补充建议
    
  gatekeeping:
    - 未达到标准前标记"未完成"
    - 提供详细的修复指南

优先级: 🟡 中

---

✅ Skills有效实践

实践1: 分层测试结构 ⭐⭐⭐⭐⭐

@Nested
@DisplayName("构造函数测试")
class ConstructorTests { }

@Nested
@DisplayName("边界条件测试") 
class BoundaryTests { }

@Nested
@DisplayName("JSON序列化测试")
class JsonSerializationTests { }

优点:

• 结构清晰
• 易于维护
• 便于定位问题

---

实践2: BDD风格命名 ⭐⭐⭐⭐⭐

void shouldCreateErrorResponseWithDetails_whenUsingThreeParamError()
void shouldHandleNullValues_whenSettingFields()
void shouldThrowException_whenJsonIsMalformed()

优点:

• 意图明确
• 易于理解
• 自动生成文档

---

实践3: 参数化测试 ⭐⭐⭐⭐

@ParameterizedTest
@CsvSource({
    "0, 0, null",
    "-1, -1, empty",
    "MAX_VALUE, MAX_VALUE, large"
})
void shouldHandleBoundaryValues(long a, long b, String type)

优点:

• 减少重复代码
• 提高测试密度
• 便于扩展边界

---

🚀 Skills优化建议清单

立即优化 (P0)

• 默认构造函数检查机制

  • 生成JSON测试前检查类是否符合Jackson要求
  • 不符合时给出修复建议或跳过

• 分支覆盖率导向

  • 分析源代码AST找出所有分支点
  • 优先生成条件分支测试
  • 设置60%分支覆盖目标

短期优化 (P1)

• 系统性边界测试模板

  • 数值/字符串/集合/时间/并发边界
  • 自动生成参数化测试

• 测试价值评估

  • 评估每个测试的代码覆盖贡献
  • 去重低价值测试
  • 优化测试执行时间

• 生产标准实时检查

  • 每100个测试检查一次覆盖率
  • 低于标准时给出警告
  • 提供缺口分析

长期优化 (P2)

• 变异测试集成

  • 自动生成变异测试
  • 验证测试质量

• 智能测试生成

  • 基于代码复杂度生成测试
  • 优先覆盖高风险代码

• 安全测试场景

  • 自动生成安全边界测试
  • SQL注入/XSS/权限等

---

📈 优化效果预估

当前 vs 优化后

维度	当前	优化后	提升
有效测试比例	70%	90%	+20%
分支覆盖率	51%	65%	+14%
测试执行时间	40s	25s	-37%
缺陷发现率	3个	8个	+166%
生产就绪速度	4轮	2轮	-50%

---

📝 总结

Skills现状评估

• ✅ 测试结构优秀: 分层清晰，命名规范
• ⚠️ 质量控制不足: 缺少默认值检查，分支覆盖导向
• ⚠️ 生产标准薄弱: 实时检查机制缺失

核心改进方向

1. 质量控制前置: 生成前检查而非执行后发现
2. 分支导向优先: 关注条件路径而非简单语句
3. 系统化边界: 数值/字符串/集合/时间/并发
4. 生产标准集成: 实时检查85%/60%目标

预期收益

• 测试生成时间减少30%
• 有效测试比例提升至90%
• 分支覆盖率提升至65%+
• 生产就绪速度提升50%

---

基于蚊子项目1210个测试的真实经验总结
生成时间: 2026-02-03