tdd-guide

The full skill.

Original instructions from the publisher’s SKILL.md

# TDD Guide

## 概述

使用该技能来执行严格的测试驱动开发（Test-Driven Development, TDD）流程：先写测试，再写最小实现，最后重构并验证覆盖率。优先保证可验证性与可维护性。

## 工作流（RED → GREEN → REFACTOR）

1. 先定义接口与输入/输出约束（scaffold）
   - 明确函数签名、返回值、错误语义与边界条件。
2. 编写失败测试（RED）
   - 覆盖 happy path、边界条件、错误路径。
   - 测试名称描述行为，不测试实现细节。
3. 运行测试并确认失败原因正确
   - 只允许因未实现/不满足行为而失败。
4. 写最小实现（GREEN）
   - 只实现满足当前测试的最小逻辑。
5. 运行测试并确认全部通过
6. 重构（REFACTOR）
   - 去重、命名优化、性能改进，保持测试绿色。
7. 覆盖率验证
   - 覆盖率 >= 80%；关键业务逻辑目标 100%。

## 执行要点

- 优先发现并复用仓库已有测试入口（如 `test_runner.py`、Makefile 或 CI 脚本）。
- 外部依赖必须 mock；避免网络或全局状态依赖。
- 每个功能完成后立即运行测试，不跨越 RED 阶段。
- 记录验证证据（若仓库有验证记录文件，按要求更新）。

## 参考资料

需要完整检查清单和用例示例时，读取 `references/tdd-checklists.md`。