Communitygithub.com

tangjuyo/reels-blocker

디자인 아티팩트를 기반으로 기능을 위한 의존성 순서가 정리된 실행 가능한 tasks.md 파일을 생성합니다.

reels-blocker란 무엇인가요?

이 스킬은 주어진 디자인 문서(plan.md, spec.md, data-model.md, contracts/, research.md 등)를 분석하여 프로젝트의 기능 구현을 위한 단계별 작업 목록(tasks.md)을 자동 생성합니다. 각 작업은 사용자 스토리 단위로 구성되며, 엄격한 체크리스트 형식(체크박스, 작업 ID, 병렬 실행 가능 표시, 스토리 레이블, 파일 경로)을 따르므로 LLM이 추가 컨텍스트 없이 바로 실행할 수 있습니다. 또한 `.specify/extensions.yml` 파일을 통해 작업 생성 전후에 확장 후크를 실행하거나 건너뛰는 기능을 지원하여 유연한 워크플로우 통합이 가능합니다. 생성된 tasks.md는 MVP 우선 순위에 따라 단계별(설정, 기반, 사용자 스토리별, 마무리)로 구성되며, 각 스토리의 독립적인 테스트 가능성과 병렬 실행 기회를 식별합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tangjuyo/reels-blocker/tree/HEAD/.claude/skills/speckit-tasks

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

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

문서

사용자 입력

$ARGUMENTS

진행하기 전에 사용자 입력을 반드시 고려해야 합니다 (비어 있지 않은 경우).

실행 전 검사

작업 생성 전 확장 후크 확인:

  • 프로젝트 루트에 .specify/extensions.yml 파일이 있는지 확인합니다.
  • 파일이 있으면 읽고 hooks.before_tasks 키 아래의 항목을 찾습니다.
  • YAML을 구문 분석할 수 없거나 유효하지 않은 경우, 조용히 넘어가지 말고 사용자에게 .specify/extensions.yml 파일을 읽을 수 없다고 알리고(파서 오류 포함) 해당 파일에 등록된 필수(optional: false) 후크를 포함한 모든 후크가 확인되지 않았음을 알린 후 정상적으로 계속 진행합니다.
  • enabled가 명시적으로 false인 후크는 필터링합니다. enabled 필드가 없는 후크는 기본적으로 활성화된 것으로 간주합니다.
  • 나머지 각 후크에 대해 후크 condition 표현식을 해석하거나 평가하려고 시도하지 마십시오:
    • 후크에 condition 필드가 없거나 null/비어 있으면 후크를 실행 가능한 것으로 간주합니다.
    • 후크에 비어 있지 않은 condition이 정의되어 있으면 후크를 건너뛰고 조건 평가를 HookExecutor 구현에 맡깁니다.
  • 후크 명령 이름으로 명령 호출을 구성할 때는 점(.)을 하이픈(-)으로 바꿉니다. 예: speckit.git.commit → /speckit-git-commit.
  • 실행 가능한 각 후크에 대해 optional 플래그에 따라 다음을 출력합니다:
    • 선택적 후크(optional: true):
      ## 확장 후크
      
      **선택적 사전 후크**: {ext}
      명령: `/{command}`
      설명: {description}
      
      프롬프트: {prompt}
      실행하려면: `/{command}`
      
    • 필수 후크(optional: false):
      ## 확장 후크
      
      **자동 사전 후크**: {ext}
      실행 중: `/{command}`
      EXECUTE_COMMAND: {command}
      
      개요로 진행하기 전에 후크 명령의 결과를 기다리십시오.
      
      위 블록을 출력한 후에는 반드시 실제로 후크를 호출하고 완료될 때까지 기다려야 합니다. 이 세션/에이전트에서 직접 명령을 실행하는 것과 동일한 방식으로 실행하십시오(호출 방식은 위에 표시된 리터럴 {command} ID와 다를 수 있습니다. 예를 들어 스킬 모드 에이전트는 /skill:speckit-... 또는 $speckit-...로 실행합니다). 블록만 출력하는 것으로는 후크가 실행되지 않습니다.
  • 등록된 후크가 없거나 .specify/extensions.yml이 존재하지 않으면 조용히 건너뜁니다.

개요

  1. 설정: 리포지토리 루트에서 .specify/scripts/bash/setup-tasks.sh --json을 실행하고 FEATURE_DIR, TASKS_TEMPLATE_CONTENT, TASKS_TEMPLATE 및 AVAILABLE_DOCS 목록을 구문 분석합니다. FEATURE_DIR과 TASKS_TEMPLATE는 제공될 때 절대 경로여야 합니다. AVAILABLE_DOCS는 FEATURE_DIR 아래에 있는 문서 이름/상대 경로 목록입니다(예: research.md 또는 contracts/). "I'm Groot"와 같은 인수에 작은따옴표가 있는 경우 이스케이프 구문을 사용하십시오. 예: 'I'''m Groot' (또는 가능하면 큰따옴표 사용: "I'm Groot").

  2. 디자인 문서 로드: FEATURE_DIR에서 읽기:

    • 필수: plan.md(기술 스택, 라이브러리, 구조), spec.md(우선순위가 있는 사용자 스토리)
    • 선택 사항: data-model.md(엔티티), contracts/(인터페이스 계약), research.md(결정 사항), quickstart.md(테스트 시나리오)
    • 존재하는 경우: .specify/memory/constitution.md를 로드하여 프로젝트 원칙 및 거버넌스 제약 조건 확인
    • 참고: 모든 프로젝트에 모든 문서가 있는 것은 아닙니다. 사용 가능한 것을 기반으로 작업을 생성하십시오.
  3. 작업 생성 워크플로우 실행:

    • plan.md를 로드하고 기술 스택, 라이브러리, 프로젝트 구조 추출
    • spec.md를 로드하고 우선순위(P1, P2, P3 등)와 함께 사용자 스토리 추출
    • data-model.md가 있으면: 엔티티를 추출하고 사용자 스토리에 매핑
    • contracts/가 있으면: 인터페이스 계약을 사용자 스토리에 매핑
    • research.md가 있으면: 설정 작업에 대한 결정 사항 추출
    • 사용자 스토리별로 구성된 작업 생성(아래 작업 생성 규칙 참조)
    • 사용자 스토리 완료 순서를 보여주는 종속성 그래프 생성
    • 사용자 스토리별 병렬 실행 예제 생성
    • 작업 완전성 검증(각 사용자 스토리에 필요한 모든 작업이 있고 독립적으로 테스트 가능한지 확인)
  4. tasks.md 생성: 위 JSON 출력의 TASKS_TEMPLATE_CONTENT를 구조로 사용합니다. TASKS_TEMPLATE_CONTENT를 생략하는 이전 버전의 설정 스크립트와의 호환성을 위해 대신 TASKS_TEMPLATE를 읽습니다. 다음으로 채웁니다:

    • plan.md의 올바른 기능 이름
    • 1단계: 설정 작업(프로젝트 초기화)
    • 2단계: 기본 작업(모든 사용자 스토리의 차단 전제 조건)
    • 3단계+: 사용자 스토리당 하나의 단계(spec.md의 우선순위 순서)
    • 각 단계에는 다음이 포함됩니다: 스토리 목표, 독립적 테스트 기준, 테스트(요청된 경우), 구현 작업
    • 최종 단계: 마무리 및 교차 관심사
    • 모든 작업은 엄격한 체크리스트 형식을 따라야 합니다(아래 작업 생성 규칙 참조)
    • 각 작업에 대한 명확한 파일 경로
    • 스토리 완료 순서를 보여주는 종속성 섹션
    • 스토리별 병렬 실행 예제
    • 구현 전략 섹션(MVP 우선, 점진적 전달)

필수 사후 실행 후크

완료를 사용자에게 보고하기 전에 이 섹션을 반드시 완료해야 합니다.

프로젝트 루트에 .specify/extensions.yml 파일이 있는지 확인합니다.

  • 파일이 없거나 hooks.after_tasks 키 아래에 등록된 후크가 없으면 완료 보고서로 건너뜁니다.
  • 파일이 있으면 읽고 hooks.after_tasks 키 아래의 항목을 찾습니다.
  • YAML을 구문 분석할 수 없거나 유효하지 않은 경우, 조용히 넘어가지 말고 사용자에게 .specify/extensions.yml 파일을 읽을 수 없다고 알리고(파서 오류 포함) 해당 파일에 등록된 필수(optional: false) 후크를 포함한 모든 후크가 확인되지 않았음을 알린 후 완료 보고서로 계속 진행합니다.
  • enabled가 명시적으로 false인 후크는 필터링합니다. enabled 필드가 없는 후크는 기본적으로 활성화된 것으로 간주합니다.
  • 나머지 각 후크에 대해 후크 condition 표현식을 해석하거나 평가하려고 시도하지 마십시오:
    • 후크에 condition 필드가 없거나 null/비어 있으면 후크를 실행 가능한 것으로 간주합니다.
    • 후크에 비어 있지 않은 condition이 정의되어 있으면 후크를 건너뛰고 조건 평가를 HookExecutor 구현에 맡깁니다.
  • 후크 명령 이름으로 명령 호출을 구성할 때는 점(.)을 하이픈(-)으로 바꿉니다. 예: speckit.git.commit → /speckit-git-commit.
  • 실행 가능한 각 후크에 대해 optional 플래그에 따라 다음을 출력합니다:
    • 필수 후크(optional: false) — 각 필수 후크에 대해 EXECUTE_COMMAND:를 반드시 출력해야 합니다:
      ## 확장 후크
      
      **자동 후크**: {ext}
      실행 중: `/{command}`
      EXECUTE_COMMAND: {command}
      
      위 블록을 출력한 후에는 반드시 실제로 후크를 호출하고 완료될 때까지 기다려야 합니다. 이 세션/에이전트에서 직접 명령을 실행하는 것과 동일한 방식으로 실행하십시오(호출 방식은 위에 표시된 리터럴 {command} ID와 다를 수 있습니다. 예를 들어 스킬 모드 에이전트는 /skill:speckit-... 또는 $speckit-...로 실행합니다). 블록만 출력하는 것으로는 후크가 실행되지 않습니다.
    • 선택적 후크(optional: true):
      ## 확장 후크
      
      **선택적 후크**: {ext}
      명령: `/{command}`
      설명: {description}
      
      프롬프트: {prompt}
      실행하려면: `/{command}`
      

완료 보고서

생성된 tasks.md의 경로와 요약을 출력합니다:

  • 총 작업 수
  • 사용자 스토리별 작업 수
  • 식별된 병렬 실행 기회
  • 각 스토리에 대한 독립적 테스트 기준
  • 제안된 MVP 범위(일반적으로 사용자 스토리 1만)
  • 형식 검증: 모든 작업이 체크리스트 형식(체크박스, ID, 레이블, 파일 경로)을 따르는지 확인

작업 생성 컨텍스트: $ARGUMENTS

tasks.md는 즉시 실행 가능해야 합니다. 각 작업은 LLM이 추가 컨텍스트 없이 완료할 수 있을 만큼 구체적이어야 합니다.

작업 생성 규칙

중요: 작업은 독립적인 구현 및 테스트를 가능하게 하기 위해 반드시 사용자 스토리별로 구성되어야 합니다.

테스트는 선택 사항입니다: 기능 사양에서 명시적으로 요청하거나 사용자가 TDD 접근 방식을 요청하는 경우에만 테스트 작업을 생성하십시오.

체크리스트 형식 (필수)

모든 작업은 반드시 다음 형식을 엄격히 따라야 합니다:

- [ ] [TaskID] [P?] [Story?] 설명 및 파일 경로

형식 구성 요소:

  1. 체크박스: 항상 - [ ](마크다운 체크박스)로 시작
  2. 작업 ID: 실행 순서에 따른 일련 번호(T001, T002, T003...)
  3. [P] 표시: 작업이 병렬화 가능한 경우에만 포함(다른 파일, 완료되지 않은 작업에 대한 종속성 없음)
  4. [Story] 레이블: 사용자 스토리 단계 작업에만 필수
    • 형식: [US1], [US2], [US3] 등 (spec.md의 사용자 스토리 매핑)
    • 설정 단계: 스토리 레이블 없음
    • 기본 단계: 스토리 레이블 없음
    • 사용자 스토리 단계: 스토리 레이블 필수
    • 마무리 단계: 스토리 레이블 없음
  5. 설명: 정확한 파일 경로가 포함된 명확한 작업

예시:

  • ✅ 올바름: - [ ] T001 구현 계획에 따라 프로젝트 구조 생성
  • ✅ 올바름: - [ ] T005 [P] src/middleware/auth.py에 인증 미들웨어 구현
  • ✅ 올바름: - [ ] T012 [P] [US1] src/models/user.py에 User 모델 생성
  • ✅ 올바름: - [ ] T014 [US1] src/services/user_service.py에 UserService 구현
  • ❌ 틀림: - [ ] User 모델 생성 (ID 및 스토리 레이블 누락)
  • ❌ 틀림: T001 [US1] 모델 생성 (체크박스 누락)
  • ❌ 틀림: - [ ] [US1] User 모델 생성 (작업 ID 누락)
  • ❌ 틀림: - [ ] T001 [US1] 모델 생성 (파일 경로 누락)

작업 구성

  1. 사용자 스토리(spec.md) 기준 - 기본 구성:

    • 각 사용자 스토리(P1, P2, P3...)는 고유한 단계를 가짐
    • 관련된 모든 구성 요소를 해당 스토리에 매핑:
      • 해당 스토리에 필요한 모델
      • 해당 스토리에 필요한 서비스
      • 해당 스토리에 필요한 인터페이스/UI
      • 테스트가 요청된 경우: 해당 스토리별 테스트
    • 스토리 종속성 표시(대부분의 스토리는 독립적이어야 함)
  2. 계약(Contracts) 기준:

    • 각 인터페이스 계약을 해당하는 사용자 스토리에 매핑
    • 테스트가 요청된 경우: 각 인터페이스 계약 → 해당 스토리 단계에서 구현 전 계약 테스트 작업 [P]
  3. 데이터 모델(Data Model) 기준:

    • 각 엔티티를 이를 필요로 하는 사용자 스토리에 매핑
    • 엔티티가 여러 스토리에 사용되는 경우: 가장 이른 스토리 또는 설정 단계에 배치
    • 관계 → 적절한 스토리 단계의 서비스 계층 작업
    • data-model.md에 필드 제약 조건(최대 길이, nullable/필수, 열거형 값, 유효성 검사 규칙)이 있는 경우, 작업 설명에 제약 조건을 그대로 인용하여 구현 시 재량에 맡기지 않도록 합니다.
  4. 설정/인프라 기준:

    • 공유 인프라 → 설정 단계(1단계)
    • 기본/차단 작업 → 기본 단계(2단계)
    • 스토리별 설정 → 해당 스토리 단계 내

단계 구조

  • 1단계: 설정(프로젝트 초기화)
  • 2단계: 기본(차단 전제 조건 - 사용자 스토리 전에 반드시 완료)
  • 3단계+: 사용자 스토리 우선순위 순서(P1, P2, P3...)
    • 각 스토리 내: 테스트(요청된 경우) → 모델 → 서비스 → 엔드포인트 → 통합
    • 각 단계는 완전하고 독립적으로 테스트 가능한 증분이어야 함
  • 최종 단계: 마무리 및 교차 관심사

완료 조건

  • 모든 단계, 작업 ID 및 파일 경로가 포함된 tasks.md 생성됨
  • 위의 필수 사후 실행 후크 규칙에 따라 확장 후크가 실행되거나 건너뛰어짐
  • 작업 수, 스토리 분석 및 MVP 범위와 함께 완료가 사용자에게 보고됨

Individual skills in this repo

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

관련 스킬