用途
implement-feature 是 tddworks/claudebar 项目中的一项开发技能,用于指导在 ClaudeBar 中实现新功能。它规定了一套从架构设计到测试驱动开发的完整工作流,适用于需要遵循项目既有架构约定来扩展功能的开发场景。
主要能力
该技能围绕以下核心原则组织实现过程:
- 架构优先设计:在编写任何代码之前,必须先分析需求、创建 ASCII 架构图、记录组件交互,并获得用户明确批准。
- 富领域模型:领域模型封装行为,而不仅仅是数据。例如 UsageQuota 结构体不仅持有 percentRemaining,还提供 status、isDepleted、needsAttention 等由状态计算得出的领域行为。
- Swift 6.2 模式:不设 ViewModel/AppState 层,视图直接消费来自 QuotaMonitor 的领域模型。QuotaMonitor 作为单一事实来源,通过 nonisolated 委托方法供 UI 访问。
- 基于协议的依赖注入:使用 @Mockable 定义协议(如 UsageProbe),便于测试。
- 芝加哥学派 TDD:基于状态测试,验证状态变化和返回值,而非方法调用;Mock 用于桩化依赖返回数据,而非验证调用。
使用方式
工作流分为两个主要阶段:
阶段 0:架构设计(强制)
- 步骤 1:分析需求,识别需要的新模型/类型、将被修改的现有组件、组件间的数据流、外部依赖(CLI、API 等)。
- 步骤 2:创建 ASCII 架构图,展示所有组件及其交互。
- 步骤 3:记录组件交互,列出每个组件的用途、输入、输出和依赖。
- 步骤 4:提交用户审批。使用 AskUserQuestion 工具提供选项(“批准 - 继续实现”或“修改 - 我对设计有反馈”),在用户明确批准前不得进入阶段 1。
阶段 1-3:TDD 实现(芝加哥学派)
- 阶段 1:领域模型测试。测试状态和计算属性,遵循 Given/When/Then 结构。
- 阶段 2:基础设施测试。桩化依赖返回数据,断言结果状态。
- 阶段 3:集成。在 ClaudeBarApp.swift 中接线并创建视图。
实现循环为:编写断言预期状态的失败测试(红)→ 编写最小代码使测试通过(绿)→ 在保持测试通过的前提下重构。
适用场景
- 为 ClaudeBar 添加新功能
- 添加新的 AI 提供商(示例中展示了 NewUsageProbe、NewProvider 的架构图)
- 需要遵循项目架构分层(Domain / Infrastructure / App)和 TDD 约定的开发任务
架构分层
| 层级 | 位置 | 用途 |
|---|---|---|
| Domain | Sources/Domain/ | QuotaMonitor(单一事实来源)、富模型、协议 |
| Infrastructure | Sources/Infrastructure/ | 探针、存储、适配器 |
| App | Sources/App/ | 直接消费领域模型的 SwiftUI 视图(无 ViewModel) |
关键模式包括:带 ISP 的仓库模式(提供商特定的子协议,如 ZaiSettingsRepository、CopilotSettingsRepository)、基于协议的依赖注入(@Mockable)、芝加哥学派 TDD、无 ViewModel 层。
限制
- 阶段 0 架构设计为强制步骤,未获用户批准不得进入实现阶段。
- 该技能针对 ClaudeBar 项目及其 Swift 6.2 技术栈,其他项目需调整。
- 关于该技能的具体安装命令、收费方式、平台支持等信息,资料中暂未提供。