Communitygithub.com

tangjuyo/reels-blocker

대화형 또는 제공된 원칙 입력을 기반으로 프로젝트 헌법을 생성하거나 업데이트합니다.

reels-blocker란 무엇인가요?

이 스킬은 사용자의 입력을 분석하여 `.specify/memory/constitution.md`에 있는 프로젝트 헌법을 생성하거나 업데이트합니다. 사용자가 제공한 원칙 입력 또는 대화형 상호작용을 통해 헌법을 관리하며, 기능 구현이나 코드 생성과 같은 비거버넌스 의도는 분리하여 지연 처리합니다. 헌법 업데이트 전후에 `.specify/extensions.yml` 파일을 확인하여 등록된 확장 훅을 선택적 또는 필수적으로 실행할 수 있습니다. 템플릿 해결, 버전 관리, 변경 영향 보고서 생성을 포함한 체계적인 워크플로우를 제공하므로, 개발자가 프로젝트의 거버넌스 문서를 명확하고 일관되게 유지하는 데 유용합니다.

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

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

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

문서

사용자 입력

$ARGUMENTS

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

범위 제한

이 명령의 작업은 프로젝트 헌법 자체를 업데이트하는 것으로 제한됩니다. 종속 템플릿 및 명령은 런타임 시 헌법을 읽으며 여기에서 수정되지 않습니다.

  • 사용자 입력의 모든 부분을 헌법 내용 또는 별도의 비거버넌스 의도로 분류하십시오.
  • 입력에 기능 구현, 코드 생성, 리팩토링, 빌드 또는 배포 요청이 포함된 경우 실행해서는 안 됩니다. 대신 이를 지연 의도로 추출하십시오.
  • 애플리케이션 소스 파일, 기능 경로, 구성 요소, 테스트, 배포 파일 또는 헌법 워크플로우와 관련 없는 기타 아티팩트를 생성, 수정 또는 삭제해서는 안 됩니다.
  • 명령이 헌법 내용인지 명확하지 않은 경우 변경하기 전에 설명을 요청하십시오.
  • 헌법 업데이트를 완료한 후 각 지연 의도에 대한 다음 작업 섹션을 포함하십시오. 원래 의도를 나열하고 적절한 후속 Spec Kit 명령(예: /speckit-specify)을 호출하지 않고 제안하십시오.
  • 비거버넌스 의도가 없으면 다음 작업 섹션을 생략하십시오.

실행 전 확인

확장 훅 확인 (헌법 업데이트 전):

  • 프로젝트 루트에 .specify/extensions.yml이 있는지 확인하십시오.
  • 파일이 존재하면 읽고 hooks.before_constitution 키 아래의 항목을 찾으십시오.
  • 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와 다를 수 있습니다. 예: 스킬 모드 에이전트는 /skill:speckit-... 또는 $speckit-...로 실행합니다). 블록만 출력하는 것으로는 훅이 실행되지 않습니다.
  • 등록된 훅이 없거나 .specify/extensions.yml이 존재하지 않으면 조용히 건너뛰십시오.

개요

.specify/memory/constitution.md에 있는 프로젝트 헌법을 업데이트하고 있습니다. 활성 헌법 스캐폴드는 Spec Kit 프리셋/템플릿 해결 스택을 통해 constitution-template에서 명령 시간에 해결됩니다.

다음 실행 흐름을 따르십시오:

  1. 저장소 루트에서 .specify/scripts/bash/resolve-template.sh constitution-template --json을 실행하고 TEMPLATE_CONTENT를 활성 템플릿으로 구문 분석하십시오.

    • 공유 해결사는 프로젝트 재정의를 적용하고, 프리셋 레이어와 확장 레이어를 코어 템플릿 폴백 전에 구성합니다. 계속하려면 반드시 성공해야 합니다.
    • 실패하면 중단하고 해결 오류를 보고하십시오. 하나의 기여 템플릿 레이어만으로 계속하지 마십시오.
    • .specify/memory/constitution.md가 존재하면 현재 프로젝트별 값과 수정 사항의 소스로 로드하십시오. 새로 해결된 스캐폴드를 적용할 때 여전히 적용 가능한 정보를 보존하십시오.
    • 존재하지 않으면 해결된 템플릿을 초기 문서로 사용하십시오.
    • 버전이 지정된 템플릿 레이어에 다시 쓰지 마십시오.
    • [ALL_CAPS_IDENTIFIER] 형식의 모든 플레이스홀더 토큰을 식별하십시오. 중요: 사용자는 템플릿에 사용된 원칙보다 더 적거나 더 많은 원칙을 필요로 할 수 있습니다. 숫자가 지정된 경우 이를 존중하고 일반 템플릿을 따르십시오. 그에 따라 문서를 업데이트합니다.
  2. 플레이스홀더에 대한 값을 수집/파생하십시오:

    • 사용자 입력(대화)이 값을 제공하면 사용하십시오.
    • 그렇지 않으면 기존 저장소 컨텍스트(README, 문서, 포함된 경우 이전 헌법 버전)에서 유추하십시오.
    • 거버넌스 날짜: RATIFICATION_DATE는 원래 채택 날짜입니다(알 수 없는 경우 묻거나 TODO로 표시). LAST_AMENDED_DATE는 변경 사항이 있으면 오늘, 그렇지 않으면 이전 날짜를 유지하십시오.
    • CONSTITUTION_VERSION은 의미 체계 버전 관리 규칙에 따라 증가해야 합니다:
      • MAJOR: 하위 호환되지 않는 거버넌스/원칙 제거 또는 재정의.
      • MINOR: 새 원칙/섹션 추가 또는 실질적으로 확장된 지침.
      • PATCH: 명확화, 표현, 오타 수정, 비의미론적 개선.
    • 버전 범프 유형이 모호한 경우 최종 확정하기 전에 추론을 제안하십시오.
  3. 해결된 템플릿을 필수 구조로 사용하여 업데이트된 헌법 내용을 초안 작성하십시오:

    • 모든 플레이스홀더를 구체적인 텍스트로 바꾸십시오 (프로젝트가 아직 정의하지 않기로 선택한 의도적으로 유지된 템플릿 슬롯을 제외하고는 대괄호 토큰이 남지 않아야 합니다. 남은 경우 명시적으로 정당화하십시오).
    • 제목 계층 구조를 유지하고 주석은 더 이상 명확한 지침을 추가하지 않는 경우 바꾼 후 제거할 수 있습니다.
    • 각 원칙 섹션이 간결한 이름 줄, 단락(또는 글머리 기호 목록)으로 반드시 지켜야 할 규칙을 포착하고, 명확하지 않은 경우 명시적인 근거를 포함하는지 확인하십시오.
    • 거버넌스 섹션에 개정 절차, 버전 관리 정책 및 규정 준수 검토 기대 사항이 나열되어 있는지 확인하십시오.
  4. 업데이트 후 헌법 파일 상단에 HTML 주석으로 동기화 영향 보고서를 생성하십시오. 이 보고서는 개정 검토를 위한 임시 초안 자료이며 거버넌스 내용이 아닙니다. 헌법 파일이 커밋되기 전에 제거될 것으로 예상됩니다.

    • 버전 변경: 이전 → 새
    • 수정된 원칙 목록 (이름이 변경된 경우 이전 제목 → 새 제목)
    • 추가된 섹션
    • 제거된 섹션
    • 의도적으로 연기된 플레이스홀더가 있는 경우 후속 TODO
  5. 최종 출력 전 검증:

    • 설명되지 않은 대괄호 토큰이 남아 있지 않아야 합니다.
    • 버전 라인이 보고서와 일치해야 합니다.
    • 날짜는 ISO 형식 YYYY-MM-DD여야 합니다.
    • 원칙은 선언적이고 테스트 가능하며 모호한 언어가 없어야 합니다 ("should"는 적절한 경우 MUST/SHOULD 근거로 대체).
  6. 완료된 헌법을 .specify/memory/constitution.md에 다시 쓰십시오 (덮어쓰기).

  7. 사용자에게 다음을 포함한 최종 요약을 출력하십시오:

    • 새 버전 및 범프 근거.
    • 수동 후속 조치가 필요한 TODO 플레이스홀더 또는 연기된 항목.
    • 제안된 커밋 메시지 (예: docs: vX.Y.Z로 헌법 개정 (원칙 추가 + 거버넌스 업데이트)).
    • 연기된 비거버넌스 의도에 대한 다음 작업 섹션.

형식 및 스타일 요구 사항:

  • 템플릿과 정확히 일치하는 Markdown 제목을 사용하십시오 (수준을 낮추거나 높이지 마십시오).
  • 긴 근거 줄을 가독성을 유지하기 위해 감싸되 (<100자 이상적으로) 어색한 줄바꿈으로 강제하지 마십시오.
  • 섹션 사이에 빈 줄 하나를 유지하십시오.
  • 후행 공백을 피하십시오.

사용자가 부분 업데이트(예: 하나의 원칙 개정만)를 제공하더라도 여전히 검증 및 버전 결정 단계를 수행하십시오.

중요 정보가 누락된 경우(예: 비준 날짜를 실제로 알 수 없음), TODO(<FIELD_NAME>): 설명을 삽입하고 지연된 항목 아래의 동기화 영향 보고서에 포함하십시오.

.specify/memory/constitution.md만 쓰십시오. 템플릿 소스 파일을 생성하거나 수정하지 마십시오.

실행 후 확인

확장 훅 확인 (헌법 업데이트 후): 프로젝트 루트에 .specify/extensions.yml이 있는지 확인하십시오.

  • 파일이 존재하면 읽고 hooks.after_constitution 키 아래의 항목을 찾으십시오.
  • 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와 다를 수 있습니다. 예: 스킬 모드 에이전트는 /skill:speckit-... 또는 $speckit-...로 실행합니다). 블록만 출력하는 것으로는 훅이 실행되지 않습니다.
  • 등록된 훅이 없거나 .specify/extensions.yml이 존재하지 않으면 조용히 건너뛰십시오.

Individual skills in this repo

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

관련 스킬