TDD开发

superpowers-tdd

by axelhu

Use when implementing any feature or bugfix, before writing implementation code - enforces RED-GREEN-REFACTOR cycle: write failing test first, verify it fails, write minimal code, verify it passes, then refactor

4.2k编码与调试未扫描2026年3月30日

安装

claude skill add --url https://github.com/openclaw/skills

文档

Superpowers TDD - 测试驱动开发

核心准则

先写测试,看着它失败,写最少的代码让它通过。

如果没看过测试失败,就不知道测试的是不是对的东西。

违反规则的字面意思 = 违反规则的精神。

铁律

code
没有失败的测试,就不能写生产代码

先写代码后写测试?删除它。从头开始。

没有例外:

  • 不要留着当"参考"
  • 不要在写测试时"改编"它
  • 不要看它
  • 删除就是删除

红-绿-重构循环

RED - 写失败的测试

写一个最小测试,展示应该发生什么。

python
# Good: 清晰名称,测试真实行为,一件事
def test_retries_failed_operations_3_times():
    attempts = 0
    def operation():
        nonlocal attempts
        attempts += 1
        if attempts < 3:
            raise Exception('fail')
        return 'success'
    
    result = retry_operation(operation)
    assert result == 'success'
    assert attempts == 3
code
❌ Bad: 模糊名称,测试 mock 而不是真实代码
def test_retry_works():
    mock = MagicMock()
    mock.side_effect = [Exception(), Exception(), 'success']

要求:

  • 一个行为
  • 清晰名称
  • 真实代码(除非不可避免才用 mock)

验证 RED - 看着它失败

必须执行,从不跳过。

bash
pytest tests/path/test_name.py -v
# 或项目对应的测试命令

确认:

  • 测试失败(不是错误)
  • 失败信息符合预期
  • 失败是因为功能缺失(不是拼写错误)

测试通过了? 你在测试已有行为。修复测试。

GREEN - 最少代码

写最简单的代码让测试通过。

python
# Good: 刚好够通过测试
def retry_operation(fn, max_retries=3):
    for i in range(max_retries):
        try:
            return fn()
        except Exception as e:
            if i == max_retries - 1:
                raise e
code
❌ Bad: 过度设计,加入了测试没要求的功能
def retry_operation(fn, options={max_retries=3, backoff='linear', onRetry=...})
    # YAGNI - 你不需要这个

不要添加功能、不要重构其他代码、不要"改进"超过测试要求。

验证 GREEN - 看着它通过

必须执行。

bash
pytest tests/path/test_name.py -v

确认:

  • 测试通过
  • 其他测试仍然通过
  • 输出干净(无错误、无警告)

测试失败? 修代码,不是测试。

其他测试失败? 立刻修。

REFACTOR - 重构

只有在 green 之后:

  • 移除重复
  • 改进名称
  • 提取辅助函数

保持测试 green。不添加行为。

重复

下一个失败测试对应下一个功能。

好测试的特征

质量
最小一件事。名称里有"and"?拆开它。test_validates_email_and_domain_and_whitespace
清晰名称描述行为test_test1
展示意图展示期望的 API掩盖代码应该做什么

常见借口(别信)

借口现实
"太简单了不用测"简单代码也会坏。测试只用30秒。
"我之后测"测试立即通过什么也证明不了。
"之后测试也能达到同样目标"之后测试 = "这代码干了什么?" 先写测试 = "这代码应该干什么?"
"我已经手动测试了"手动测试是随意的。没有记录,不能重跑。
"删除 X 小时的工作太浪费"沉没成本谬误。留着不可信的代码是技术债。
"留着当参考"你会改编它。那就是之后测试。删除就是删除。
"TDD 太教条"TDD 是务实的:比事后调试快。

红旗 - 停止并从头开始

  • 先写代码后写测试
  • 实现之后才写测试
  • 测试立即通过
  • 说不清为什么测试失败
  • "之后"添加的测试
  • 合理化"就这一次"
  • "我已经手动测试了"
  • "之后测试能达到同样目的"
  • "这是精神不是仪式"
  • "留着当参考"或"改编现有代码"

所有这些意味着:删除代码。从头用 TDD。

Bug 修复示例

Bug: 空邮箱被接受

RED

python
def test_rejects_empty_email():
    result = submit_form({'email': ''})
    assert result['error'] == 'Email required'

Verify RED

code
$ pytest
FAIL: expected 'Email required', got undefined

GREEN

python
def submit_form(data):
    if not data.get('email', '').strip():
        return {'error': 'Email required'}
    # ...

Verify GREEN

code
$ pytest
PASS

REFACTOR 如需要可提取多字段验证。

完成前检查表

  • 每个新函数/方法都有测试
  • 实现前看过每个测试失败
  • 每个测试失败原因符合预期(功能缺失,不是 typo)
  • 写了最少的代码让每个测试通过
  • 所有测试通过
  • 输出干净(无错误、无警告)
  • 测试使用真实代码(除非不可避免才用 mock)
  • 覆盖了边界情况和错误

不能全部打勾?跳过了 TDD。从头开始。

相关 Skills

网页构建器

by anthropics

Universal
热门

面向复杂 claude.ai HTML artifact 开发,快速初始化 React + Tailwind CSS + shadcn/ui 项目并打包为单文件 HTML,适合需要状态管理、路由或多组件交互的页面。

在 claude.ai 里做复杂网页 Artifact 很省心,多组件、状态和路由都能顺手搭起来,React、Tailwind 与 shadcn/ui 组合效率高、成品也更精致。

编码与调试
未扫描119.1k

前端设计

by anthropics

Universal
热门

面向组件、页面、海报和 Web 应用开发,按鲜明视觉方向生成可直接落地的前端代码与高质感 UI,适合做 landing page、Dashboard 或美化现有界面,避开千篇一律的 AI 审美。

想把页面做得既能上线又有设计感,就用前端设计:组件到整站都能产出,难得的是能避开千篇一律的 AI 味。

编码与调试
未扫描119.1k

网页应用测试

by anthropics

Universal
热门

用 Playwright 为本地 Web 应用编写自动化测试,支持启动开发服务器、校验前端交互、排查 UI 异常、抓取截图与浏览器日志,适合调试动态页面和回归验证。

借助 Playwright 一站式验证本地 Web 应用前端功能,调 UI 时还能同步查看日志和截图,定位问题更快。

编码与调试
未扫描119.1k

相关 MCP 服务

GitHub

编辑精选

by GitHub

热门

GitHub 是 MCP 官方参考服务器,让 Claude 直接读写你的代码仓库和 Issues。

这个参考服务器解决了开发者想让 AI 安全访问 GitHub 数据的问题,适合需要自动化代码审查或 Issue 管理的团队。但注意它只是参考实现,生产环境得自己加固安全。

编码与调试
83.9k

by Context7

热门

Context7 是实时拉取最新文档和代码示例的智能助手,让你告别过时资料。

它能解决开发者查找文档时信息滞后的问题,特别适合快速上手新库或跟进更新。不过,依赖外部源可能导致偶尔的数据延迟,建议结合官方文档使用。

编码与调试
52.9k

by tldraw

热门

tldraw 是让 AI 助手直接在无限画布上绘图和协作的 MCP 服务器。

这解决了 AI 只能输出文本、无法视觉化协作的痛点——想象让 Claude 帮你画流程图或白板讨论。最适合需要快速原型设计或头脑风暴的开发者。不过,目前它只是个基础连接器,你得自己搭建画布应用才能发挥全部潜力。

编码与调试
46.4k

评论