用途
本技能用于对 ClaudeBar 的现有功能进行改进,采用 TDD(测试驱动开发)与富领域设计。它适用于增强已有行为,而不是新增功能。技能文档中给出了与其他技能的区分:增强现有行为使用 improvement(本技能),修复损坏行为使用 fix-bug,新增功能使用 implement-feature,新增 AI 提供方使用 add-provider。
工作流程
技能定义了三个步骤:
- 理解当前状态:阅读现有代码,理解当前行为,确定要改进的内容。
- 为改进后的行为编写测试(Red):测试描述改进后的行为,初始应当失败,同时保持现有测试通过。
- 实现并验证(Green):实现改进,新测试通过,所有现有测试仍然通过。
改进类型
技能将改进分为四类,并给出示例与测试方法:
- UX 改进:在不改变核心逻辑的前提下增强用户体验,例如设置视图在小屏幕上可滚动、更好的加载指示器、改进可访问性、更清晰的视觉布局。测试方法为 UI 行为测试或手动验证。
- 领域改进:增强领域模型行为,例如为常见查询添加计算属性、改进状态计算、添加便捷方法、更好的封装。测试方法为基于状态的领域测试。文档中给出示例:为 UsageSnapshot 添加 lowestQuota 便捷属性,并用 #expect 断言。
- 基础设施改进:增强探针、存储或适配器,例如更好的错误消息、更健壮的解析、改进的超时处理、缓存支持。测试方法为使用模拟依赖的行为测试。
- 性能改进:优化现有功能,例如减少冗余 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 提供方。文档未提供具体的安装命令、收费信息或平台支持范围。