Communitygithub.com

tangjuyo/reels-blocker

tasks.md에 정의된 모든 작업을 처리하고 실행하여 구현 계획을 수행합니다.

reels-blocker란 무엇인가요?

이 스킬은 프로젝트 내 `tasks.md` 파일에 정의된 구현 작업을 체계적으로 실행합니다. 개발자는 이 스킬을 통해 사전 정의된 작업 계획을 단계별로 수행할 수 있습니다. 실행 전에 `.specify/extensions.yml` 파일의 확장 훅(hook)을 확인하고, 체크리스트 상태를 검증하며, 프로젝트 설정 파일을 자동으로 생성하거나 검증합니다. 그런 다음 tasks.md를 파싱하여 단계(Setup, Tests, Core, Integration, Polish)와 의존성에 따라 작업을 순차 또는 병렬로 실행합니다. 작업 완료 후에는 상태를 보고하고, 선택적으로 사후 실행 훅을 실행합니다. 이 스킬은 Claude Code 및 기타 AI 에이전트 환경에서 사용할 수 있으며, tasks.md가 완전한 작업 목록을 포함하고 있다고 가정합니다. 작업이 누락된 경우 `/speckit-tasks` 명령을 먼저 실행할 것을 권장합니다.

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

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

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

문서

사용자 입력

$ARGUMENTS

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

사전 실행 검사

확장 훅 확인 (구현 전):

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

개요

  1. 리포지토리 루트에서 .specify/scripts/bash/check-prerequisites.sh --json --require-tasks --include-tasks를 실행하고 FEATURE_DIR 및 AVAILABLE_DOCS 목록을 파싱합니다. 모든 경로는 절대 경로여야 합니다. "I'm Groot"와 같은 인수에 작은따옴표가 있는 경우 이스케이프 구문(예: 'I'''m Groot')을 사용하거나 가능하면 큰따옴표("I'm Groot")를 사용합니다.

  2. 체크리스트 상태 확인 (FEATURE_DIR/checklists/ 디렉토리가 있는 경우):

    • 체크리스트 마커를 읽기 전용 게이트로 취급합니다. 체크박스 상태를 스캔하고 상태를 보고하며 필요한 경우 진행하기 전에 질문합니다. 체크리스트 파일이나 마커를 수정하지 마십시오.

    • checklists/requirements.md는 /speckit-specify 및 /speckit-clarify가 유지 관리하는 기본 제공 사양 품질 체크리스트입니다. /speckit-checklist가 생성한 사용자 정의 체크리스트는 검토자가 소유한 요구사항-품질 검토 산출물입니다.

    • 사용자 정의 체크리스트의 경우 [x]는 검토자가 요구사항-품질 기준이 충족되었다고 판단했음을 의미합니다. 구현 작업이 완료되었음을 의미하지는 않습니다.

    • checklists/ 디렉토리의 모든 체크리스트 파일을 스캔합니다.

    • 각 체크리스트에 대해 다음을 계산합니다:

      • 총 항목: - [ ] 또는 - [X] 또는 - [x]와 일치하는 모든 줄
      • 선택된 항목: - [X] 또는 - [x]와 일치하는 줄
      • 선택되지 않은 항목: - [ ]와 일치하는 줄
    • 상태 표를 생성합니다:

      | 체크리스트 | 총계 | 선택됨 | 선택 안됨 | 상태 |
      |-----------|-------|---------|-----------|--------|
      | ux.md     | 12    | 12      | 0         | ✓ 통과 |
      | test.md   | 8     | 5       | 3         | ✗ 실패 |
      | security.md | 6   | 6       | 0         | ✓ 통과 |
      
    • 전체 상태를 계산합니다:

      • 통과: 모든 체크리스트에 선택되지 않은 항목이 0개입니다.
      • 실패: 하나 이상의 체크리스트에 선택되지 않은 항목이 있습니다.
    • 선택되지 않은 항목이 있는 체크리스트가 있는 경우:

      • 선택되지 않은 항목 수와 함께 표를 표시합니다.
      • 중단하고 질문합니다: "일부 체크리스트에 선택되지 않은 항목이 있습니다. 그래도 구현을 진행하시겠습니까? (예/아니오)"
      • 계속하기 전에 사용자 응답을 기다립니다.
      • 사용자가 "아니오" 또는 "잠시만요" 또는 "중지"라고 말하면 실행을 중단합니다.
      • 사용자가 "예" 또는 "진행" 또는 "계속"이라고 말하면 3단계로 진행합니다.
    • 모든 체크리스트가 선택된 경우:

      • 모든 체크리스트가 통과되었음을 보여주는 표를 표시합니다.
      • 자동으로 3단계로 진행합니다.
  3. 구현 컨텍스트 로드 및 분석:

    • 필수: 전체 작업 목록 및 실행 계획을 위해 tasks.md를 읽습니다.
    • 필수: 기술 스택, 아키텍처 및 파일 구조를 위해 plan.md를 읽습니다.
    • 존재하는 경우: 엔터티와 관계를 위해 data-model.md를 읽습니다.
    • 존재하는 경우: API 사양 및 테스트 요구사항을 위해 contracts/를 읽습니다.
    • 존재하는 경우: 기술 결정 및 제약 조건을 위해 research.md를 읽습니다.
    • 존재하는 경우: 거버넌스 제약 조건을 위해 .specify/memory/constitution.md를 읽습니다.
    • 존재하는 경우: 통합 시나리오를 위해 quickstart.md를 읽습니다.
  4. 프로젝트 설정 확인:

    • 필수: 실제 프로젝트 설정을 기반으로 무시 파일을 생성/확인합니다.

    감지 및 생성 로직:

    • 다음 명령이 성공하는지 확인하여 리포지토리가 git 리포지토리인지 확인합니다(그렇다면 .gitignore 생성/확인):

      git rev-parse --git-dir 2>/dev/null
      
    • Dockerfile*이 존재하거나 plan.md에 Docker가 있는지 확인 → .dockerignore 생성/확인

    • .eslintrc*가 존재하는지 확인 → .eslintignore 생성/확인

    • eslint.config.*가 존재하는지 확인 → 설정의 ignores 항목이 필수 패턴을 포함하는지 확인

    • .prettierrc*가 존재하는지 확인 → .prettierignore 생성/확인

    • .npmrc 또는 package.json이 존재하는지 확인 → .npmignore 생성/확인(게시하는 경우)

    • terraform 파일(*.tf)이 존재하는지 확인 → .terraformignore 생성/확인

    • .helmignore가 필요한지 확인(helm 차트가 있는 경우) → .helmignore 생성/확인

    무시 파일이 이미 존재하는 경우: 필수 패턴이 포함되어 있는지 확인하고 누락된 중요 패턴만 추가합니다. 무시 파일이 없는 경우: 감지된 기술에 대한 전체 패턴 세트로 생성합니다.

    기술별 공통 패턴 (plan.md 기술 스택 기반):

    • Node.js/JavaScript/TypeScript: node_modules/, dist/, build/, *.log, .env*
    • Python: __pycache__/, *.pyc, .venv/, venv/, dist/, *.egg-info/
    • Java: target/, *.class, *.jar, .gradle/, build/
    • C#/.NET: bin/, obj/, *.user, *.suo, packages/
    • Go: *.exe, *.test, vendor/, *.out
    • Ruby: .bundle/, log/, tmp/, *.gem, vendor/bundle/
    • PHP: vendor/, *.log, *.cache, *.env
    • Rust: target/, debug/, release/, *.rs.bk, *.rlib, *.prof*, .idea/, *.log, .env*
    • Kotlin: build/, out/, .gradle/, .idea/, *.class, *.jar, *.iml, *.log, .env*
    • C++: build/, bin/, obj/, out/, *.o, *.so, *.a, *.exe, *.dll, .idea/, *.log, .env*
    • C: build/, bin/, obj/, out/, *.o, *.a, *.so, *.exe, *.dll, autom4te.cache/, config.status, config.log, .idea/, *.log, .env*
    • Swift: .build/, DerivedData/, *.swiftpm/, Packages/
    • R: .Rproj.user/, .Rhistory, .RData, .Ruserdata, *.Rproj, packrat/, renv/
    • 범용: .DS_Store, Thumbs.db, *.tmp, *.swp, .vscode/, .idea/

    도구별 패턴:

    • Docker: node_modules/, .git/, Dockerfile*, .dockerignore, *.log*, .env*, coverage/
    • ESLint: node_modules/, dist/, build/, coverage/, *.min.js
    • Prettier: node_modules/, dist/, build/, coverage/, package-lock.json, yarn.lock, pnpm-lock.yaml
    • Terraform: .terraform/, *.tfstate*, *.tfvars, .terraform.lock.hcl
    • Kubernetes/k8s: *.secret.yaml, secrets/, .kube/, kubeconfig*, *.key, *.crt
  5. tasks.md 구조를 파싱하고 다음을 추출합니다:

    • 작업 단계: Setup, Tests, Core, Integration, Polish
    • 작업 의존성: 순차 대 병렬 실행 규칙
    • 작업 세부 정보: ID, 설명, 파일 경로, 병렬 마커 [P]
    • 실행 흐름: 순서 및 의존성 요구사항
  6. 작업 계획에 따라 구현 실행:

    • 단계별 실행: 다음 단계로 이동하기 전에 각 단계를 완료합니다.
    • 의존성 준수: 순차 작업은 순서대로 실행하고, 병렬 작업 [P]은 함께 실행할 수 있습니다.
    • TDD 접근 방식 따르기: 해당 구현 작업보다 먼저 테스트 작업을 실행합니다.
    • 파일 기반 조정: 동일한 파일에 영향을 미치는 작업은 순차적으로 실행해야 합니다.
    • 유효성 검사 체크포인트: 진행하기 전에 각 단계 완료를 확인합니다.
  7. 구현 실행 규칙:

    • 설정 먼저: 프로젝트 구조, 의존성, 구성을 초기화합니다.
    • 코드보다 테스트 먼저: 계약, 엔터티 및 통합 시나리오에 대한 테스트를 작성해야 하는 경우.
    • 핵심 개발: 모델, 서비스, CLI 명령, 엔드포인트를 구현합니다.
    • 통합 작업: 데이터베이스 연결, 미들웨어, 로깅, 외부 서비스.
    • 마무리 및 검증: 단위 테스트, 성능 최적화, 문서화.
  8. 진행 상황 추적 및 오류 처리:

    • 각 작업 완료 후 진행 상황을 보고합니다.
    • 병렬 작업이 아닌 작업이 실패하면 실행을 중단합니다.
    • 병렬 작업 [P]의 경우 성공한 작업은 계속 진행하고 실패한 작업은 보고합니다.
    • 디버깅을 위해 컨텍스트와 함께 명확한 오류 메시지를 제공합니다.
    • 구현을 진행할 수 없는 경우 다음 단계를 제안합니다.
    • 중요: 완료된 작업의 경우 작업 파일에서 해당 작업을 [X]로 표시해야 합니다.
  9. 완료 검증:

    • 필수 작업이 모두 완료되었는지 확인합니다.
    • 구현된 기능이 원래 사양과 일치하는지 확인합니다.
    • 테스트가 통과되고 적용 범위가 요구사항을 충족하는지 확인합니다.
    • 구현이 기술 계획을 따르는지 확인합니다.

참고: 이 명령은 tasks.md에 완전한 작업 분류가 존재한다고 가정합니다. 작업이 불완전하거나 누락된 경우 /speckit-tasks를 실행하여 작업 목록을 다시 생성할 것을 제안합니다.

필수 사후 실행 훅

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

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

  • 파일이 없거나 hooks.after_implement 키 아래에 등록된 훅이 없으면 완료 보고서로 건너뜁니다.
  • 파일이 있으면 읽고 hooks.after_implement 키 아래의 항목을 확인합니다.
  • 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:를 반드시 출력해야 합니다:
      ## 확장 훅
      
      **자동 훅**: {extension}
      실행 중: `/{command}`
      EXECUTE_COMMAND: {command}
      
      위 블록을 출력한 후 반드시 훅을 실제로 호출하고 완료될 때까지 기다려야 합니다. 이 에이전트/세션에서 직접 명령을 실행하는 것과 동일한 방식으로 실행합니다(호출은 위에 표시된 리터럴 {command} ID와 다를 수 있습니다. 예: skills-mode 에이전트는 /skill:speckit-... 또는 $speckit-...로 실행). 블록을 출력하는 것만으로는 훅이 실행되지 않습니다.
    • 선택적 훅 (optional: true):
      ## 확장 훅
      
      **선택적 훅**: {extension}
      명령: `/{command}`
      설명: {description}
      
      프롬프트: {prompt}
      실행하려면: `/{command}`
      

완료 보고서

완료된 작업 요약과 함께 최종 상태를 보고합니다.

완료 조건

  • tasks.md의 모든 작업이 완료되고 [X]로 표시됨
  • 사양, 계획 및 테스트 적용 범위에 대해 구현이 검증됨
  • 위의 필수 사후 실행 훅 규칙에 따라 확장 훅이 디스패치되거나 건너뛰어짐
  • 완료된 작업 요약과 함께 사용자에게 완료가 보고됨

Individual skills in this repo

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

관련 스킬