SuperAPI AI 工具集

fix-bug

通用与其它

查看项目

更新于 10-16 06:14

技能介绍

用途:在 ClaudeBar 项目中使用芝加哥学派 TDD、根因分析和富领域设计来修复缺陷。技能触发场景包括用户报告 bug 或意外行为等。

主要能力与工作流分三阶段:第一阶段复现与理解,按精确步骤复现缺陷,区分预期行为与实际行为,并在代码中定位根因;可对照架构文档判断问题所在层(领域层 Sources/Domain/、基础设施层 Sources/Infrastructure/、应用层 Sources/App/),并检查是否违反领域不变量。第二阶段编写失败测试(红灯):采用状态式测试,验证状态变化与返回值而非交互,不使用 verify() 调用,而是断言最终状态;测试应验证正确行为,修复前必须失败。测试位置按缺陷所在层对应(如 Sources/Domain/Monitor/ 对应 Tests/DomainTests/Monitor/)。第三阶段修复与验证(绿灯):尽量做最小改动,优先在领域层修复,保持不变量,避免无关重构;领域应在构造时自我校验,公开 API 隐藏实现细节,用私有方法维护内部不变量。

使用方式:先运行 swift test --filter "{TestSuiteName}" 确认测试失败,修复后再运行该命令确认通过,最后运行 swift test 确认无回归。技能提供检查清单:复现并理解缺陷、定位根因、编写暴露缺陷的失败测试、修复前测试失败、最小修复、修复后测试通过、全部既有测试通过、维持领域不变量、更新 CHANGELOG。

适用场景:ClaudeBar 项目中用户报告缺陷或异常行为时;需要以测试驱动方式修复并防止回归的缺陷处理。

限制:具体支持的平台、收费与价格、可用版本等资料暂未提供;仅适用于 ClaudeBar 项目,且依赖其领域架构与测试目录约定。