SuperAPI AI 工具集

tdd

编程与开发

查看项目

更新于 10-16 07:19

技能介绍

用途:用于行为变更的功能开发或缺陷修复,以及用户提到 TDD、测试先行、红-绿-重构、追踪弹等场景。核心规则是纵向的红-绿-重构切片:RED 阶段为单个可观察行为写一个测试;GREEN 阶段写最小生产代码使其通过;REFACTOR 阶段仅在测试通过时清理。不要在实现前批量编写臆想的测试,每个新测试应回应上一轮循环对真实行为与接口的认知。

主要能力与默认约定:用 bun test 运行针对性测试,用 bun run check:types 做类型门禁;使用 test 而非 it,并用 describe 组织;优先使用真实依赖与真实运行时边界而非 mock,仅对远程 API、时间、随机性或罕见文件系统情况等外部边界进行 mock;避免条件断言,先断言分支再断言分支特定值;对条件、回退和错误路径都要测试两个分支;每个行为优先一个稳定的公开或运行时接口,若操作者契约是 CLI,则测试 CLI 边界而非私有辅助函数或重复包装器;遵循所在仓库的技能与 AGENTS.md 规则。

使用方式:开始时先探索代码库,若公开接口、预期行为或风险边界可从代码、测试或文档中发现,则以此为依据而非询问用户;仅当决策无法发现且合理假设有风险时,才提一个简洁问题并附上推荐答案。编写生产代码前确定:被测的公开接口或运行时边界、第一个要证明的可观察行为、本轮循环的针对性测试命令、交接前所需的更广泛验证。对每个行为:新增或更新恰好一个聚焦测试;运行针对性测试并确认其因预期原因失败;只实现足够通过的最小代码;再次运行同一测试并确认通过;如有需要则重构,然后重跑受影响的测试。若测试在生产代码变更前就通过,则不是有效的 RED 信号,应收紧测试、更换行为,或说明现有覆盖已证明该行为。

限制:资料未提供具体安装步骤、支持语言或平台的完整列表、收费与价格信息,也未提供实际的测试代码示例;参考文件包括 references/tests.md、references/mocking.md、references/interface-design.md、references/deep-modules.md、references/refactoring.md。