Community생산성 & 협업github.com

am-will/tdd-test-writer

테스트 주도 개발을 위해 먼저 실패하는 테스트를 작성하고, 에이전트가 해당 테스트를 약화시키지 않고 통과하도록 요구하는 엄격한 구현 계약을 전달합니다. 사용자가 테스트 우선 워크플로, RED/GREEN 주기, 또는 자동화된 테스트를 통한 동작 게이팅 태스크를 요청할 때 사용하세요.

tdd-test-writer란 무엇인가요?

이 기술은 테스트 주도 개발(TDD) 워크플로를 지원하기 위해 설계된 AI 에이전트 기술입니다. 주요 기능은 사용자가 요청한 기능에 대해 먼저 실패하는 테스트(Red 단계)를 작성하고, 이 테스트를 통과시키기 위한 엄격한 구현 계약을 후속 에이전트에 전달하는 것입니다. 이는 에이전트가 기존 테스트를 약화시키거나 우회하지 않고 실제로 통과하는 코드를 작성하도록 강제하여, 행동 기반 게이팅(behavior-gating)과 코드 품질을 보장합니다. Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 사용 가능하며, 사용자가 'test-first', 'RED/GREEN', 'TDD', 'automated tests' 등의 키워드를 언급할 때 자동으로 활성화됩니다. SKILL.md 문서에는 Red 단계에서 실패하는 테스트를 작성하는 방법, Green 단계에서 테스트를 통과하는 최소한의 코드 작성 방법, Blue 단계(리팩토링)에 대한 지침이 포함되어 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/am-will/codex-skills/tree/main/skills/tdd-test-writer

Installed? Explore more 생산성 & 협업 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

tdd-test-writer은(는) 무엇을 하나요?

테스트 주도 개발을 위해 먼저 실패하는 테스트를 작성하고, 에이전트가 해당 테스트를 약화시키지 않고 통과하도록 요구하는 엄격한 구현 계약을 전달합니다. 사용자가 테스트 우선 워크플로, RED/GREEN 주기, 또는 자동화된 테스트를 통한 동작 게이팅 태스크를 요청할 때 사용하세요.

작동 방식

이 스킬은 TDD의 RED/GREEN/Blue 주기를 따릅니다:

RED 단계

  • 사용자 요청을 분석하여 예상 동작을 정의합니다.
  • 해당 동작을 검증하는 실패하는 테스트를 작성합니다.
  • 테스트는 명확하고 구체적이며, 구현 세부 사항보다는 동작에 초점을 맞춥니다.

GREEN 단계

  • 후속 에이전트(또는 동일 에이전트)는 작성된 테스트를 통과하는 최소한의 코드를 구현해야 합니다.
  • 테스트를 통과하기 위해 테스트 자체를 수정하거나 약화시키는 것은 금지됩니다.
  • 구현 계약은 "기존 테스트를 변경하지 않고 통과시킬 것"을 요구합니다.

BLUE 단계 (선택 사항)

  • 테스트 통과 후, 코드 리팩토링이 필요한 경우 제안합니다.
  • 리팩토링 중에도 모든 테스트는 계속 통과해야 합니다.

사용 예시

사용자: "사용자 로그인 기능을 TDD로 구현해줘"
에이전트: 
  1. 로그인 성공/실패 케이스에 대한 단위 테스트 작성
  2. 테스트가 실패하는지 확인 (RED)
  3. "이제 위 테스트를 통과하는 구현을 작성하세요. 테스트를 수정하지 마세요." 라는 계약 전달

지원 플랫폼

  • Claude Code
  • Cursor
  • Codex
  • 기타 AI 에이전트

환경 변수

  • TDD_STRICT_MODE: true로 설정 시, 테스트 수정을 완전히 금지합니다.

참고 사항

  • 이 기술은 test-first, RED/GREEN, TDD, automated tests 등의 키워드에 반응합니다.
  • 테스트는 가능한 한 격리되고 빠르게 실행되어야 합니다.
  • 모의 객체(mock)와 스텁(stub)은 필요한 경우에만 사용합니다.

Individual skills in this repo

This repo contains 17 individual skills — each has its own dedicated page.

am-will/agent-browser

A fast Rust-based headless browser automation CLI with Node.js fallback that enables AI agents to navigate, click, type, and snapshot pages via structured commands.

am-will/context7

Fetch up-to-date library documentation via Context7 CLI. Use PROACTIVELY when: (1) Working with ANY external library (React, Next.js, Supabase, etc.) (2) User asks about library APIs, patterns, or best practices (3) Implementing features that rely on third-party packages (4) Debugging library-specific issues (5) Need current documentation beyond training data cutoff (6) AND MOST IMPORTANTLY, when you are installing dependencies, libraries, or frameworks you should ALWAYS check the docs to see what the latest versions are. Do not rely on outdated knowledge. Always prefer this over guessing library APIs or using outdated knowledge.

am-will/frontend-design

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

am-will/frontend-responsive-design-standards

Build responsive, mobile-first layouts using fluid containers, flexible units, media queries, and touch-friendly design that works across all screen sizes. Use this skill when creating or modifying UI layouts, responsive grids, breakpoint styles, mobile navigation, or any interface that needs to adapt to different screen sizes. Apply when working with responsive CSS, media queries, viewport settings, flexbox/grid layouts, mobile-first styling, breakpoint definitions (mobile, tablet, desktop), touch target sizing, relative units (rem, em, %), image optimization for different screens, or testing layouts across multiple devices. Use for any task involving multi-device support, responsive design patterns, or adaptive layouts.

am-will/gemini-computer-use

Build and run Gemini 2.5 Computer Use browser-control agents with Playwright. Use when a user wants to automate web browser tasks via the Gemini Computer Use model, needs an agent loop (screenshot → function_call → action → function_response), or asks to integrate safety confirmation for risky UI actions.

am-will/llm-council

Orchestrate a configurable, multi-member CLI planning council (Codex, Claude Code, Gemini, OpenCode, or custom) to produce independent implementation plans, anonymize and randomize them, then judge and merge into one final plan. Use when you need a robust, bias-resistant planning workflow, structured JSON outputs, retries, and failure handling across multiple CLI agents.

am-will/markdown-url

Route any website you need to visit through markdown.new by prefixing the URL. **WHEN TO USE:** - You would normally open a website link to read content (docs, blog posts, changelogs, GitHub issues, etc.) - You need a cleaner, Markdown-friendly view for copying notes or summarizing

am-will/openai-docs-skill

Query the OpenAI developer documentation via the OpenAI Docs MCP server using CLI (curl/jq). Use whenever a task involves the OpenAI API (Responses, Chat Completions, Realtime, etc.), OpenAI SDKs, ChatGPT Apps SDK, Codex, MCP integrations, endpoint schemas, parameters, limits, or migrations and you need up-to-date official guidance.

am-will/parallel-task

Only to be triggered by explicit /parallel-task commands.

am-will/parallel-task-spark

Only to be triggered by explicit /parallel-task-spark commands.

am-will/plan-harder

Use when user specfically says 'plan harder'.

am-will/planner

Create comprehensive, phased implementation plans with sprints and atomic tasks. Use when user says: "make a plan", "create a plan", "plan this out", "plan the implementation", "help me plan", "design a plan", "draft a plan", "write a plan", "outline the steps", "break this down into tasks", "what's the plan for", or any similar planning request. Also triggers on explicit "/planner" or "/plan" commands.

am-will/read-github

Read and search GitHub repository documentation via gitmcp.io MCP service. **WHEN TO USE:** - User provides a GitHub URL - User mentions a specific repo in owner/repo format - User asks "what does this repo do?", "read the docs for X repo", or similar - User wants to search code or docs within a repo

am-will/role-creator

Create and update Codex custom agents using standalone custom-agent TOML files.

am-will/super-swarm-spark

Only to be triggered by explicit super-swarm-spark commands.

am-will/swarm-planner

[EXPLICIT INVOCATION ONLY] Creates dependency-aware implementation plans optimized for parallel multi-agent execution.

am-will/vercel-react-best-practices

React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.

관련 스킬