uv-tdd

uv-tdd 技能为构建稳健的 Python 应用程序提供了一套规范化的开发方法。该技能专为重视代码质量与可维护性的开发者设计，将现代 Python 工具（特别是 uv 包管理器）与成熟的测试驱动开发 (TDD) 实践相结合。通过标准化项目初始化、依赖管理以及“红-绿-重构”开发循环，此技能可协助代理程序始终产出可靠且符合生产需求的代码，并减少环境配置错误。

• 使用 uv init 简化项目架构设置，包含自动 Git 仓库初始化与 pyproject.toml 配置。

• 强制执行严格的 TDD 工作流程：先编写失败的测试，实现解决方案，确认测试通过，最后以逻辑且原子化的单位进行提交。

• 通过标准 uv 指令管理依赖包与开发工具（如 pytest），确保环境状态的一致性。

• 提倡使用 pytest fixture 与参数化测试，以减少重复代码并提升测试覆盖率。

• 强制要求建立 spec.md 并维护其中的 Markdown 待办事项列表，以便在开发复杂功能时保持清晰的进度追踪。

• 在实现核心逻辑前，请确保 pytest 已被加入为开发依赖项。

• 所有 Python 代码执行皆须使用“uv run”前缀，确保在隔离的项目环境中执行。

• 项目开始时务必建立 README.md，包含项目名称与简短描述。

• 开发过程中可利用“uv run pytest -k [test_name]”进行针对性的测试执行。

• 实现第一个功能测试后，请立即删除如 test_add.py 等临时文件。

• 将文档说明、规格更新与代码实现合并为单一且连贯的 git commit，以提升历史记录的易读性。