AgentSkillsCN

tdd-workflow

GMailArchiver 的测试驱动开发(TDD)红绿重构周期。在实现功能、修复错误或遵循 6 阶段工作流程时使用。触发条件:TDD、测试驱动、红绿、失败测试、先写测试、实现功能、修复错误、开发工作流程、阶段。

SKILL.md
--- frontmatter
name: tdd-workflow
description: >-
  Test-Driven Development (TDD) red-green-refactor cycle for GMailArchiver.
  Use when implementing features, fixing bugs, or following the 6-phase workflow.
  Triggers on: TDD, test-driven, red-green, failing test, write test first,
  implement feature, fix bug, development workflow, phase.

TDD Workflow for GMailArchiver

This skill provides guidance on the Test-Driven Development process.

Source Documentation

Always read the authoritative source:

docs/PROCESS.md - Development workflow containing:

  • Phase 3: Test (TDD Red) - Writing failing tests first
  • Phase 4: Code (TDD Green) - Making tests pass with minimal code
  • Red-green-refactor cycle explanation
  • Exit criteria for each phase
  • Definition of done

Red-Green-Refactor Cycle

  1. Red: Write a failing test

    • Test describes expected behavior
    • Verify test actually fails
  2. Green: Write minimal code to pass

    • Simplest solution that works
    • Don't over-engineer
  3. Refactor: Improve code quality

    • Remove duplication
    • Improve naming
    • Verify tests still pass

Related Skills

  • testing-guidelines - For test patterns and fixtures (docs/TESTING.md)
  • coding-standards - For code style (docs/CODING.md)

Usage

When following TDD:

  1. Read docs/PROCESS.md Phase 3 and 4 for the workflow
  2. Use /test command for Phase 3 guidance
  3. Use /code command for Phase 4 guidance
  4. If process changes, update docs/PROCESS.md (not this skill)

The source documentation is the single source of truth - this skill just points you there.