thanhtung2693/specgate

SpecGate 사용하기

부트스트랩 전용 설치

루트 전용 skills.sh 설치 후 specgate-project-setup을 사용할 수 없을 때 사용합니다. command -v specgate(PowerShell: Get-Command specgate)로 확인합니다. 명령어가 없으면 skills.sh가 설치 지침만 제공한다고 설명합니다. macOS, Linux 또는 WSL2에서는 다음을 표시하고 명시적 승인을 기다립니다:

curl -fsSL https://raw.githubusercontent.com/thanhtung2693/specgate/main/scripts/install-cli.sh | sh

네이티브 Windows: https://github.com/thanhtung2693/specgate/releases/latest를 사용하며, PowerShell을 임의로 만들어내지 않습니다. 이후 specgate --version을 기록합니다.

소스가 thanhtung2693/specgate이고 경로가 plugins/skills/specgate/SKILL.md인 잠금만 신뢰하며, 프로젝트 skills-lock.json 또는 전역 ~/.agents/.skill-lock.json에 있습니다. 일치하는 명령을 표시하고 승인을 기다립니다:

npx skills remove specgate -y
npx skills remove specgate -g -y

skills.sh 파일이나 잠금을 직접 편집하거나 삭제하지 마십시오. IDE와 범위를 요청한 후 미리보기, 설치 및 확인합니다:

specgate plugins install --agent <codex|claude|cursor> [--project-local] --dry-run --no-input
specgate plugins install --agent <codex|claude|cursor> [--project-local] --no-input
specgate plugins doctor --agent <codex|claude|cursor> [--project-local] --json

네이티브 플러그인 소유권의 경우 중단합니다. 별도의 명시적 승인 없이 제거하거나 비활성화하지 마십시오.

초기화 전에 IDE 재시작을 요구하고 중단합니다. 이후 specgate-project-setup을 통해 계속 진행합니다.

완료 조건: CLI로 관리되는 플러그인 1개, 정상적인 doctor, 명시적 재시작.

경로 단일 선택

생애주기 작업의 경우 작업을 수행하기 전에 정확히 하나의 경로를 선택합니다:

• specgate-project-setup — 리포지토리에 대한 SpecGate 초기화, 바인딩, 설치, 갱신 또는 진단.
• specgate-work-preparation — 요청 또는 소스 명세를 승인된 SpecGate 작업으로 전환.
• specgate-work-delivery — 승인된 SpecGate 작업 구현, 재개, 검토 또는 재작업.

작업 참조가 있는 읽기 전용 작업 또는 생애주기 상태 질문의 경우 권위 있는 읽기부터 시작합니다:

specgate change status "$WORK_REF" --json

기타 개념 또는 문제 해결 질문의 경우 가장 작은 관련 CLI 읽기를 사용합니다. 경로를 강제로 지정하거나 레코드를 변경하지 마십시오.

모드 종속 쓰기 또는 핸드오프 전에 specgate doctor --json을 실행합니다. data.mode를 읽습니다. Docker, URL 또는 브라우저 사용 가능 여부에서 모드를 추론하지 마십시오. 성공하지 못한 doctor 결과를 추측 대신 보고합니다.

운영 계약

• specgate CLI는 유일한 제품 상태 읽기 및 쓰기 표면입니다. SpecGate SQLite, Postgres, 객체 스토리지, 배포 볼륨 또는 .specgate/local을 직접 검사하거나 편집하지 마십시오. 리포지토리 소스 읽기는 계속 허용됩니다.
• 초안, 설명, 요약 및 리포지토리 읽기는 명시적 CLI 명령이 지속시키기 전까지 일시적으로 유지됩니다.
• 원본 작성 프레임워크가 내구성 있는 소스 문서(경로, 이름, 생애주기 및 Git 정책)를 소유합니다. SpecGate는 해당 문서를 제자리에 스냅샷합니다. 이동, 복사, 이름 변경, 삭제, 커밋 또는 무시 규칙을 변경하지 않습니다.
• 준비 통과는 사람의 승인이 아닙니다. 승인, 수락 및 변경 요청은 사람의 결정 사항입니다. 사람이 명시적으로 선택하고 승인한 경우에만 결정 명령을 실행하며, 추론하지 마십시오.
• 승인된 컨텍스트 팩은 채팅 기록, 트래커 설명 및 오래된 리포지토리 문서보다 우선합니다. 해당 범위를 묵시적으로 확장하지 마십시오.
• 정확한 식별자와 버전을 따릅니다. artifact coverage <artifact-id>는 정확한 버전의 증거입니다. 기능 이름으로 버전을 통합하지 마십시오.
• change status.data.next_actor와 next_command를 따릅니다. 다음 행위자가 사람이면 중단하고 해당 명령을 그대로 전달합니다.
• 로컬 모드에는 UI URL이 없으며 specgate open을 호출하지 않습니다. 전체 모드에서는 specgate open ... --print --json이 반환한 URL만 사용하며, URL을 직접 구성하지 마십시오.

명령 구문은 메모리에서 플래그를 재구성하지 말고 specgate <command> --help를 실행합니다.