SuperAPI AI 工具集

implement-feature

编程与开发

查看项目

更新于 10-16 06:56

技能介绍

用途

implement-feature 是 tddworks/claudebar 项目中的一项开发技能,用于指导在 ClaudeBar 中实现新功能。它规定了一套从架构设计到测试驱动开发的完整工作流,适用于需要遵循项目既有架构约定来扩展功能的开发场景。

主要能力

该技能围绕以下核心原则组织实现过程:

  1. 架构优先设计:在编写任何代码之前,必须先分析需求、创建 ASCII 架构图、记录组件交互,并获得用户明确批准。
  2. 富领域模型:领域模型封装行为,而不仅仅是数据。例如 UsageQuota 结构体不仅持有 percentRemaining,还提供 status、isDepleted、needsAttention 等由状态计算得出的领域行为。
  3. Swift 6.2 模式:不设 ViewModel/AppState 层,视图直接消费来自 QuotaMonitor 的领域模型。QuotaMonitor 作为单一事实来源,通过 nonisolated 委托方法供 UI 访问。
  4. 基于协议的依赖注入:使用 @Mockable 定义协议(如 UsageProbe),便于测试。
  5. 芝加哥学派 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 技术栈,其他项目需调整。
  • 关于该技能的具体安装命令、收费方式、平台支持等信息,资料中暂未提供。