Communitygithub.com

tangjuyo/reels-blocker

설계 템플릿을 사용하여 구현 계획 워크플로우를 실행하고 설계 산출물을 생성합니다.

reels-blocker란 무엇인가요?

이 스킬은 AI 에이전트가 계획 템플릿을 기반으로 구조화된 구현 계획 워크플로우를 실행할 수 있도록 안내합니다. 사용자 입력을 받아 확장 훅(Hook)을 사전에 확인하고, 환경 설정, 컨텍스트 로드, 리서치, 데이터 모델 및 계약 정의, 퀵스타트 가이드 생성을 순차적으로 수행합니다. 주로 Claude Code, Cursor, Codex와 같은 AI 코딩 에이전트 환경에서 사용되며, .specify/extensions.yml 파일을 통해 플러그인 형태의 확장을 지원합니다. 선택적 또는 필수 훅을 실행하고, 설계 완료 후 산출물과 브랜치 정보를 사용자에게 보고합니다.

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

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

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

문서

사용자 입력

$ARGUMENTS

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

사전 실행 검사

확장 훅 확인 (계획 수립 전):

  • 프로젝트 루트에 .specify/extensions.yml 파일이 있는지 확인합니다.
  • 파일이 존재하면 읽고 hooks.before_plan 키 아래의 항목을 찾습니다.
  • 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}
      
      훅 명령의 결과를 기다린 후 개요(Outline)로 진행합니다.
      
      위 블록을 출력한 후 실제로 훅을 호출하고 완료될 때까지 기다려야 합니다. 이 에이전트/세션에서 직접 명령을 실행하는 것과 동일한 방식으로 실행합니다(호출 방식은 위에 표시된 리터럴 {command} ID와 다를 수 있습니다. 예를 들어, 스킬 모드 에이전트는 /skill:speckit-... 또는 $speckit-...로 실행합니다). 블록만 출력한다고 해서 훅이 실행되는 것은 아닙니다.
  • 등록된 훅이 없거나 .specify/extensions.yml 파일이 없으면 조용히 건너뜁니다.

개요

  1. 설정: 저장소 루트에서 .specify/scripts/bash/setup-plan.sh --json을 실행하고 JSON을 구문 분석하여 FEATURE_SPEC, IMPL_PLAN, FEATURE_DIR, BRANCH를 가져옵니다. "I'm Groot"와 같은 인수에 작은따옴표가 있는 경우 이스케이프 구문을 사용하세요: 예: 'I'''m Groot'(또는 가능하면 큰따옴표 사용: "I'm Groot").

  2. 컨텍스트 로드: FEATURE_SPEC과 .specify/memory/constitution.md를 읽습니다. IMPL_PLAN 템플릿을 로드합니다(이미 복사됨).

  3. 계획 워크플로우 실행: IMPL_PLAN 템플릿의 구조를 따라 다음을 수행합니다:

    • 기술 컨텍스트 채우기 (알 수 없는 항목은 "NEEDS CLARIFICATION"으로 표시)
    • constitution에서 헌법 확인(Constitution Check) 섹션 채우기
    • 게이트 평가 (부당한 위반 사항이 있으면 ERROR)
    • 0단계: research.md 생성 (모든 NEEDS CLARIFICATION 해결)
    • 1단계: data-model.md, contracts/, quickstart.md 생성
    • 설계 후 헌법 확인 재평가

필수 사후 실행 훅

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

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

  • 파일이 없거나 hooks.after_plan 아래에 등록된 훅이 없으면 완료 보고서(Completion Report)로 건너뜁니다.
  • 파일이 존재하면 읽고 hooks.after_plan 키 아래의 항목을 찾습니다.
  • 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와 다를 수 있습니다. 예를 들어, 스킬 모드 에이전트는 /skill:speckit-... 또는 $speckit-...로 실행합니다). 블록만 출력한다고 해서 훅이 실행되는 것은 아닙니다.
    • 선택적 훅 (optional: true):
      ## 확장 훅
      
      **선택적 훅**: {extension}
      명령: `/{command}`
      설명: {description}
      
      프롬프트: {prompt}
      실행하려면: `/{command}`
      

완료 보고서

명령은 1단계 설계 후 종료됩니다. 브랜치, IMPL_PLAN 경로 및 생성된 산출물을 보고합니다.

단계

0단계: 개요 및 리서치

  1. 위 기술 컨텍스트에서 알 수 없는 항목 추출:

    • 각 NEEDS CLARIFICATION → 리서치 작업
    • 각 종속성 → 모범 사례 작업
    • 각 통합 → 패턴 작업
  2. 리서치 에이전트 생성 및 전달:

    기술 컨텍스트의 각 알 수 없는 항목에 대해:
      작업: "{feature context}에서 {unknown} 리서치"
    각 기술 선택에 대해:
      작업: "{domain}에서 {tech}에 대한 모범 사례 찾기"
    
  3. 결과 취합 후 research.md에 다음 형식으로 저장:

    • 결정: [선택된 사항]
    • 근거: [선택 이유]
    • 고려된 대안: [평가된 다른 옵션]

출력: 모든 NEEDS CLARIFICATION이 해결된 research.md

1단계: 설계 및 계약

전제 조건: research.md 완료

  1. 기능 명세에서 엔터티 추출 → data-model.md:

    • 엔터티 이름, 필드, 관계
    • 요구사항의 유효성 검사 규칙
    • 해당하는 경우 상태 전이
  2. 인터페이스 계약 정의 (프로젝트에 외부 인터페이스가 있는 경우) → /contracts/:

    • 프로젝트가 사용자나 다른 시스템에 노출하는 인터페이스를 식별합니다.
    • 프로젝트 유형에 적합한 계약 형식을 문서화합니다.
    • 예: 라이브러리의 공개 API, CLI 도구의 명령 스키마, 웹 서비스의 엔드포인트, 파서의 문법, 애플리케이션의 UI 계약
    • 프로젝트가 순수 내부용(빌드 스크립트, 일회성 도구 등)인 경우 건너뜁니다.
  3. 퀵스타트 검증 가이드 생성 → quickstart.md:

    • 기능이 종단 간 작동함을 증명하는 실행 가능한 검증 시나리오를 문서화합니다.
    • 전제 조건, 설정 명령, 테스트/실행 명령 및 예상 결과를 포함합니다.
    • 콘텐츠를 중복하지 않도록 계약 및 데이터 모델 세부 정보에 대한 링크나 참조를 사용합니다.
    • 전체 구현 코드, 모델/서비스/컨트롤러 본문, 마이그레이션 또는 완전한 테스트 스위트는 포함하지 마십시오.
    • 이 산출물을 검증/실행 가이드로 유지하십시오. 구현 세부 정보는 tasks.md 및 구현 단계에 속합니다.

출력: data-model.md, /contracts/*, quickstart.md

주요 규칙

  • 파일 시스템 작업에는 절대 경로를 사용하고, 문서의 참조에는 프로젝트 상대 경로를 사용합니다.
  • 게이트 실패 또는 해결되지 않은 명확화 요청 시 ERROR를 발생시킵니다.

완료 조건

  • 계획 워크플로우 실행 및 설계 산출물 생성됨
  • 확장 훅이 위 '필수 사후 실행 훅'의 규칙에 따라 전달되거나 건너뛰어짐
  • 브랜치, 계획 경로 및 생성된 산출물과 함께 완료가 사용자에게 보고됨

Individual skills in this repo

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

관련 스킬