tdd

/tdd - Test-Driven Development Workflow

Guide the complete TDD cycle: write tests first, then implement.

Usage

/tdd                    # Start TDD workflow for new feature
/tdd <feature-name>     # Start TDD for specific feature
/tdd --from-todo        # Start TDD from active todo task
/tdd --continue         # Continue from current step

---

Integration with /todos

/tdd 与任务系统 /todos 无缝集成：

/todos: 创建任务 "实现用户认证"
    ↓
/tdd --from-todo: 从任务开始 TDD 流程
    ├── Step 1: 读取任务描述作为 User Story
    ├── Step 2-6: TDD 循环（自动更新任务进度）
    └── Step 7: 完成后标记任务状态
    ↓
/todos: 任务自动标记为完成

进度映射

TDD Step	Todo 进度
Step 1: User Story	[x] Planning
Step 2-5: RED → GREEN	[x] In progress
Step 6: Refactor	[x] Testing
Step 7: Coverage OK	[x] Review → Complete

从 Todo 开始 TDD

/tdd --from-todo

1. 读取 development/todos/active/ 中的任务
2. 用户选择要开发的任务
3. 提取任务描述作为 User Story
4. 开始 TDD 循环
5. 完成后自动更新任务状态

---

The 7-Step TDD Cycle

Step 1: Define Requirements (User Story)

Before writing any code, define what you're building.

If using --from-todo:

1. 读取任务文件中的描述和子任务
2. 将子任务转换为验收标准
3. 确认或补充需求

Otherwise:

## User Story

As a [user type],
I want to [action],
So that [benefit].

## Acceptance Criteria

- [ ] Criterion 1
- [ ] Criterion 2
- [ ] Criterion 3

Ask the user: What feature are we building? What are the acceptance criteria?

Todo 进度更新: [x] Planning

---

Step 2: Write Tests First (RED)

Create test file BEFORE implementation:

// Example: tests/feature.test.js
describe('Feature Name', () => {
  // Happy path
  test('should do X when Y', () => {
    // Arrange
    const input = ...;

    // Act
    const result = feature(input);

    // Assert
    expect(result).toBe(expected);
  });

  // Edge cases
  test('should handle empty input', () => { ... });
  test('should handle null input', () => { ... });

  // Error cases
  test('should throw error when invalid', () => { ... });
});