SuperAPI AI 工具集

improvement

编程与开发

查看项目

更新于 10-16 06:56

技能介绍

用途

本技能用于对 ClaudeBar 的现有功能进行改进,采用 TDD(测试驱动开发)与富领域设计。它适用于增强已有行为,而不是新增功能。技能文档中给出了与其他技能的区分:增强现有行为使用 improvement(本技能),修复损坏行为使用 fix-bug,新增功能使用 implement-feature,新增 AI 提供方使用 add-provider。

工作流程

技能定义了三个步骤:

  1. 理解当前状态:阅读现有代码,理解当前行为,确定要改进的内容。
  2. 为改进后的行为编写测试(Red):测试描述改进后的行为,初始应当失败,同时保持现有测试通过。
  3. 实现并验证(Green):实现改进,新测试通过,所有现有测试仍然通过。

改进类型

技能将改进分为四类,并给出示例与测试方法:

  1. UX 改进:在不改变核心逻辑的前提下增强用户体验,例如设置视图在小屏幕上可滚动、更好的加载指示器、改进可访问性、更清晰的视觉布局。测试方法为 UI 行为测试或手动验证。
  2. 领域改进:增强领域模型行为,例如为常见查询添加计算属性、改进状态计算、添加便捷方法、更好的封装。测试方法为基于状态的领域测试。文档中给出示例:为 UsageSnapshot 添加 lowestQuota 便捷属性,并用 #expect 断言。
  3. 基础设施改进:增强探针、存储或适配器,例如更好的错误消息、更健壮的解析、改进的超时处理、缓存支持。测试方法为使用模拟依赖的行为测试。
  4. 性能改进:优化现有功能,例如减少冗余 API 调用、懒加载、并行执行、缓存。测试方法为行为测试(结果相同,性能更好)。

TDD 模式(芝加哥学派)

技能给出测试结构示例:使用 @Suite 定义测试套件,用 @Test 描述改进后的行为,采用 Given-When-Then 结构,并用 #expect 验证改进后的属性。同时强调改进不应破坏现有行为,需运行 swift test 确保无回归。

架构参考

完整文档位于 docs/ARCHITECTURE.md。技能列出各层位置及改进示例:

  • Domain:Sources/Domain/,示例为新增计算属性、便捷方法。
  • Infrastructure:Sources/Infrastructure/,示例为更好的解析、错误处理。
  • App:Sources/App/,示例为 UI 增强、可访问性。

准则

应做:保持改动聚焦且最小化;维持现有行为;为新行为添加测试;遵循现有代码模式;更新 CHANGELOG。

不应做:对简单改进过度设计;改动无关代码;破坏现有测试;新增功能(应使用 implement-feature);因改动“很小”而跳过测试。

检查清单

技能提供了一份检查清单:理解当前行为;定义改进范围(最小化);编写改进行为的测试;测试在实现前失败;实现改进;新测试通过;所有现有测试通过(swift test);CHANGELOG 已更新。

限制

本技能仅针对 ClaudeBar 项目的现有功能改进,不适用于新增功能、修复缺陷或新增 AI 提供方。文档未提供具体的安装命令、收费信息或平台支持范围。