AGENT SKILL

tdd

测试驱动开发。适用于用户想用先写测试的方式构建功能或修复缺陷、提到 “red-green-refactor”,或需要集成测试时。

License 许可
MIT
最近更新
2026-11-06
Stars
★ 55
Forks
7

01 前言 Front Matter

name
tdd
description
测试驱动开发。适用于用户想用先写测试的方式构建功能或修复缺陷、提到 “red-green-refactor”,或需要集成测试时。

02 资源文件 3

03 SKILL.md 正文

测试驱动开发

TDD 是 red -> green loop。这个 skill 是让该 loop 产出值得保留的 tests 的 reference:什么是好 test、tests 应该放在哪里、anti-patterns,以及 loop 的规则。每个 cycle 前和 cycle 中都要参考这些内容,而不是事后才看。

探索 codebase 时,读取 GLOSSARY.md(如果存在),让 test names 和 interface vocabulary 与项目 domain language 对齐,并尊重你触碰区域的 ADRs。

什么是好 test

Tests 应通过 public interfaces 验证 behavior,而不是 implementation details。代码可以完全改变;tests 不该随之改变。一个好 test 读起来像 specification:"user can checkout with valid cart" 能清楚说明存在什么能力;因为它不关心 internal structure,所以能承受 refactors。

示例见 tests.md,mocking 规则见 mocking.md。

Seams:tests 放在哪里

Seam 是你测试的 public boundary:可以观察 behavior、但不伸手进入内部的 interface。Tests 放在 seams 上,绝不针对 internals。

只测试预先认可的 seams。 写任何 test 前,先写下要测试的 seams 并与用户确认。未经确认的 seam 不写 test。你无法测试所有东西;提前认可 seams,才能把测试精力放在 critical paths 和复杂 logic 上,而不是每个 edge case。

询问:"What's the public interface, and which seams should we test?"

当 interface 的形状本身就是问题所在时(module 该多深、seam 该放在哪里、interface 应该暴露什么),调用 Skill 工具并指定 codebase-design 获取词汇。它是 module、interface、depth、seam、adapter、leverage 和 locality 这些术语的共享来源,是供查阅的 reference,而不是要运行的 session。

反模式

  • Implementation-coupled:mock internal collaborators、测试 private methods,或通过 side channel 验证(例如不用 interface 而直接查询 database)。特征是 refactor 时 test 失败,但 behavior 没变。
  • Tautological:assertion 以和代码相同的方式重新计算 expected value(expect(add(a, b)).toBe(a + b)、手工按同一逻辑生成 snapshot、把 constant 断言等于它自己),因此天然 pass,永远无法与代码 disagree。Expected values 必须来自独立 source of truth:known-good literal、worked example 或 spec。
  • Horizontal slicing:先写所有 tests,再写所有 implementation。批量 tests 验证的是 想象中的 behavior:你测试的是东西的 shape,不是 user-facing behavior;tests 会对真实变化迟钝,并在理解 implementation 前承诺 test structure。改用 vertical slices:一个 test -> 一个 implementation -> repeat,每个 test 都是回应上一轮学习的 tracer bullet。

Loop 的规则

  • Red before green. 先写 failing test,再只写足够让它通过的代码。不要预判未来 tests,也不要添加 speculative features。
  • One slice at a time. 每个 cycle 只处理一个 seam、一个 test、一个 minimal implementation。
  • Refactoring is not part of the loop. Refactoring 属于 review stage(见 code-review skill),不属于 red -> green implementation cycle。

04 同仓库更多 Skills

limbo947
limbo947/dsh-recall-plugin

trim-cot-leakage

审计或修复「读起来像泄漏推理转录」的散文时使用——死设计会话引用((decision 7)、审计项代码、未提交草稿的 §N)、变更叙述(「以前」「不再」「本版」)、栈/审阅视角(「本栈的后一个 PR」「评审中被拒」)、对审查者说理的辩护、控制流叙述与注释、JSDoc、文档、计划记录里的规划残留;用户说「清理 CoT 泄漏」「审计文档措辞」时适用。

★ 55
limbo947
limbo947/dsh-recall-plugin

speed-up-perf

调查或优化本插件性能时使用——每条用户消息的快照开销(win32 上 spawn pwsh/git 尤其贵)、串行队列吞吐、启动预热、gc 节拍、大工作区 diff/rollback、client 快照树渲染;用户说「让它更快」「这里好慢」时适用,把抱怨变成可复现的测量与小步、保行为的修复。

★ 55
limbo947
limbo947/dsh-recall-plugin

research

对照高可信一手来源调研问题,并把发现保存为仓库中的 Markdown 文件。适用于用户想调研主题、收集文档或 API 事实,或把阅读工作委托给后台代理时。

★ 55
limbo947
limbo947/dsh-recall-plugin

prose-standard

撰写、审查、精简或审计本仓库的文字时使用——Markdown 文档与 README、注释与 JSDoc、配置说明、诊断文案、client UI 字符串;用户说「润色文档」「审查 README」「这段文案行不行」时适用。拥有文档结构、行文规则与文档质量判据。

★ 55
limbo947
limbo947/dsh-recall-plugin

pre-push-checks

git push、打 tag、发 npm 包或声称「检查通过」之前使用——按外发 diff 的改动面选最小检查集而非条件反射跑全量;test:probe 与 verify:host 不进 CI,发布前必须在本地跑过。

★ 55
limbo947
limbo947/dsh-recall-plugin

grilling

围绕计划、decision 或 idea 持续追问用户。适用于用户想对自己的思路做压力测试,或使用任何 “grill” 触发措辞时。

★ 55