Community생산성 & 협업github.com

berkekcay/link-shortener-agent-ready

docs/TASKS.md에 정의된 기능(커스텀 별칭, 클릭 카운터, 만료 등)이나 링크 단축기의 동작을 변경할 때 사용합니다. 테스트 우선, 최소 변경, pytest, 요약 순서로 진행합니다.

link-shortener-agent-ready란 무엇인가요?

이 스킬은 개발자나 AI 에이전트가 링크 단축기(Link Shortener) 애플리케이션의 기능을 구현하거나 수정할 때 체계적으로 작업할 수 있도록 안내합니다. `docs/TASKS.md`에서 선택한 단일 작업에 집중하며, `AGENTS.md`와 `tests/AGENTS.md`를 먼저 읽고 기존 코드(`main.py`, `tests/test_main.py`)를 검토한 후 계획을 세웁니다. 이후 실패하는 테스트를 먼저 작성하고(`pytest` 실행), 최소한의 코드 변경으로 테스트를 통과시키는 TDD(Test-Driven Development) 방식을 따릅니다. 모든 기존 테스트와 새 테스트가 통과하는지 확인한 후, 수행한 작업과 결과를 정해진 형식으로 요약합니다. 이 스킬은 Claude Code, Cursor, Codex 등 다양한 AI 코딩 에이전트 플랫폼에서 사용할 수 있으며, 일관된 품질과 유지보수성을 보장합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/berkekcay/link-shortener-agent-ready/tree/HEAD/.claude/skills/implement-task

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

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

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

문서

링크 단축기 작업 구현하기

다음 단계를 순서대로 따르세요. 작업이 불명확하거나 AGENTS.md의 "사람에게 먼저 물어볼 사항"에 나열된 내용이 필요하면 멈추고 질문하세요.

  1. 읽기. AGENTS.md, docs/TASKS.md에서 선택한 작업, tests/AGENTS.md를 엽니다. 오직 그 하나의 작업만 진행하세요.

  2. 검사. main.py(테이블, encode(), 요청 모델 및 두 라우트)와 tests/test_main.py를 읽습니다. 작업이 상호작용하는 부분(예: 코드 생성 방식, 실행 간 데이터베이스 공유 방식)을 기록하세요.

  3. 계획 수립. 편집을 시작하기 전에 다음을 작성하세요:

    • 예상 동작 (성공 및 각 실패에 대한 상태 코드와 응답 본문 포함)
    • 변경할 파일
    • 예외 사례 (빈 입력이나 이상한 입력, 기존 코드와의 충돌, 반복되는 값)
  4. 실패하는 테스트 작성. tests/AGENTS.md에 따라 tests/test_main.py에 동작 테스트를 추가합니다: 최소한 성공 케이스 하나와 실패 케이스 하나를 포함합니다. 테스트를 실행하고 올바른 이유로 실패하는지 확인하세요(기능이 없어서 실패해야 하며, 오타로 인한 실패가 아니어야 함):

    pytest tests/test_main.py -k <새_테스트_이름>
    
  5. 최소 변경 구현. main.py에서 테스트를 통과시키는 가장 작은 변경을 적용합니다. 기존 동작과 응답 형태를 유지하세요. 테이블에 새 열이 필요하면, 기존 links.db가 계속 작동하도록 추가하거나(또는 데이터베이스를 다시 생성해야 하는 이유를 설명하세요).

  6. 전체 실행.

    pytest
    

    모든 기존 테스트와 새 테스트가 통과해야 합니다. 실패하면 수정하고 다시 실행하세요.

  7. 요약을 다음 형식으로 작성하세요:

    Task:
    Behavior:
    Files changed:
    Tests added:
    pytest result:
    Remaining risks:
    

관련 스킬