mcpField
0
054-design-tdd

054-design-tdd

github.com/jabrena测试与质量456157 次安装1 天前更新
代码仓库

关于 054-design-tdd

054-design-tdd 是一项交互式技能,引导 Java 开发者以小步红—绿—重构循环进行测试驱动开发。它维护候选测试列表,用失败测试明确接口,并报告验证缺口和风险。

主要功能

  1. 01维护候选测试列表
  2. 02每轮选择一个行为
  3. 03先写失败测试再写生产代码
  4. 04只实现通过所选测试所需的代码
  5. 05在测试保持通过时重构
  6. 06报告跳过的检查与风险

适用场景

  1. 01以测试优先开发 Java 功能
  2. 02通过失败测试明确 API
  3. 03实现期间跟踪边界情况
  4. 04报告未完成的验证

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/jabrena/plinth --skill 054-design-tdd

安装后在 Claude Code 中输入/054-design-tdd确认已加载。

附带文件references/054-design-tdd.md

详细介绍

测试驱动开发设计

指导 Java 开发者在实现工作中进行测试驱动开发。这是一个交互式 SKILL。

此 Skill 涵盖哪些内容?

  • 维护或完善候选测试用例列表
  • 在编辑生产代码前,选择下一个有用的行为或测试用例
  • 先编写失败的测试,以明确代码的公共接口、API 形式或用法
  • 只编写足以通过所选测试的功能性生产代码
  • 在测试保持通过的情况下重构新增代码和现有代码
  • 将新发现的测试用例添加到列表中,同时不打断当前 TDD 周期
  • 验证不完整时,报告跳过的检查、缺失的测试和剩余风险

约束

实现工作必须遵循红—绿—重构循环,每次小改动由一个选定的行为驱动。

  • MUST 在应用 TDD 指导前阅读 references/054-design-tdd.md
  • MUST 当范围内涉及多个行为、边缘情况或问题时,维护或完善测试列表
  • MUST 在编写生产代码前,选择下一个有用的行为或测试用例
  • MUST 先编写或描述失败的测试,并用它明确公共接口或用法
  • MUST 只实现通过所选失败测试所需的功能性生产代码
  • MUST 仅在所选测试通过后重构新增代码和现有代码,并保持测试通过
  • MUST 验证不完整时,报告跳过的检查、缺失的测试和剩余风险

何时使用此技能

  • 应用 TDD
  • 使用测试驱动开发
  • 用测试驱动此 Java 改动
  • 先编写失败的测试
  • 对此功能采用红—绿—重构
  • 先用测试构建此行为

工作流

  1. 构建测试列表

阅读 references/054-design-tdd.md,然后列出可能需要测试的候选行为、边缘情况、错误路径、集成边界和设计问题。随着工作推进,将新发现的情况添加到列表中。

  1. 选择下一个行为

选择下一个有用的测试用例:规模足够小,可在一个周期内实现;价值足够高,能推动设计向前;具体程度足够明确,能揭示预期的可观察结果。

  1. 先编写失败的测试

在编写生产代码前,编写或描述失败的单元测试、集成测试、验收测试或特征测试。用测试明确代码的公共接口、API 形式、输入、输出、错误或用法。

  1. 让测试通过

实现通过所选测试所需的最少功能性生产代码。避免添加当前失败测试并不需要的推测性分支、抽象、框架接线或清理工作。

  1. 在测试通过时重构

所选测试通过后,重构新增代码和现有代码,改进命名、重复代码、职责分配、类型设计和测试清晰度,同时保持相关测试通过。

  1. 报告并继续

报告所选行为、先编写失败测试的信号、为使测试通过而添加的代码、执行的重构、验证结果、跳过的检查、缺失的测试和剩余风险。回到测试列表,开始下一个周期。

参考

详细指导、示例和约束请参阅 references/054-design-tdd.md。

评论

支持 Markdown