Community写作与编辑github.com

端到端200/技能集

日常工作中使用的代理技能合集,涵盖工程与非工程领域。

技能集 是什么?

该技能专注于测试驱动开发(TDD),详细介绍了红—绿—重构循环中的关键实践。它定义了什么是好的测试、测试应该放置在哪里(即“接缝”处)、常见的反模式以及循环的具体规则。技能强调测试应通过公共接口验证行为,而非实现细节,以确保测试在代码重构后仍能存活。同时,它提供了具体的反模式案例,如与实现耦合、同义反复和水平切片,并指导开发者通过垂直切片工作,每个测试像“追踪子弹”一样响应实际需求。此技能适用于多种AI代理平台,如Claude Code、Cursor和Codex,帮助开发者在每个周期中系统性地应用TDD原则,生成值得保留的测试。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add endalk200/skills

Installed? Explore more 写作与编辑 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

测试驱动开发

TDD 是红 → 绿 → 重构循环。此技能是让该循环产生值得保留的测试的参考:好的测试是什么、测试放在哪里、反模式以及循环的规则。每个部分在每个周期中都有用——在循环之前和期间参考它们,而不是之后。

在探索代码库时,请阅读 CONTEXT.md(如果存在),以便测试名称和接口词汇与项目的领域语言匹配,并尊重您所涉及区域的 ADR。

什么是好的测试

测试通过公共接口验证行为,而不是实现细节。代码可以完全改变;测试不应该。好的测试读起来像规范——"用户可以使用有效购物车结账" 准确地告诉您存在什么功能——并且因为不关心内部结构,在重构后依然有效。

参见 tests.md 获取示例,以及 mocking.md 获取模拟指南。

接缝——测试放在哪里

接缝是被测试模块呈现其接口的地方:您在不深入内部的情况下观察行为。测试位于接缝处,绝不针对内部。

在编写测试之前,先确定被测试的接缝。如果现有的公共接口是明显的接缝,就声明它并继续。如果接缝是新的或不明确的,请先与用户确认。您无法测试所有内容——有意识地选择接缝是让测试工作落在关键路径和复杂逻辑上,而不是每个边缘情况上的方式。

提问:"公共接口是什么,我们应该测试哪些接缝?"

反模式

  • 与实现耦合——模拟内部协作对象、测试私有方法,或通过侧通道(查询数据库而不是使用接口)进行验证。迹象:当您重构但行为未改变时,测试失败。
  • 同义反复——断言以与代码相同的方式重新计算期望值(expect(add(a, b)).toBe(a + b),以相同方式手动推导的快照,断言等于自身的常量),所以它通过构造直接通过,永远无法与代码不一致。期望值必须来自独立的真相源——已知正确的字面量、已计算的示例或规范。
  • 水平切片——先编写所有测试,然后实现所有代码。批量测试验证的是_想象_中的行为:您测试的是事物的_形状_而非用户可见的行为,测试对实际变化不敏感,并且在理解实现之前就承诺了测试结构。应该以垂直切片方式工作——一个测试 → 一个实现 → 重复,每个测试都是一个追踪子弹,响应上一个循环教给您的信息。

循环的规则

  • 先红后绿。 先编写失败的测试,然后只编写足够通过它的代码。不要预期未来的测试或添加推测性的功能。
  • 一次一个切片。 每个循环只有一个接缝、一个测试、一个最小实现。
  • 绿后重构。 在保持行为不变且测试通过的情况下改进名称和结构。不要在重构期间添加新行为;更广泛的架构更改属于审查阶段(参见 code-review 技能)。

相关技能