640-skills – AI 코딩 에이전트용 SBTD 워크플로우

이것이 무엇인가

SBTD(Specification-Behavior-Test-Domain) 워크플로우를 구현하는 Skills(구성 모듈) 모음으로, Codex, Oh My Pi (OMP), Claude Code, Kimi 같은 AI 기반 코드 생성 에이전트를 위한 것입니다.
이 저장소는 실행 가능한 애플리케이션을 포함하지 않으며, Onboard 스킬과 14개의 번들 스킬 카탈로그, 그리고 19개의 외부 스킬 참조를 제공하여 워크플로우를 재현 가능하게 만듭니다.

핵심 아이디어

프로젝트의 사양, 동작 규칙, 테스트, 도메인 언어를 연결하여 AI 코딩 에이전트가 자율적으로 작동하는 동시에 인간이 범위, 권한, 검증에 대한 명시적 통제권을 유지하도록 합니다.
모든 작업은 에이전트가 해석하는 자연어 프롬프트로 표현되며, 저장소는 프롬프트 템플릿과 기본 스킬 정의를 제공합니다.

주요 구성 요소

구성 요소	역할
`sbtd-workflow-onboard`	카탈로그의 나머지를 설치하고, 환경을 검증하며, 프로젝트별 `AGENTS.md` 파일을 생성하는 부트스트랩 스킬입니다.
번들 스킬(14개)	핵심 SBTD 단계(예: 사양 수집, 테스트 생성, 규칙 적용, 증거 수집)입니다.
외부 스킬(19개)	워크플로우가 의존하는 필수 타사 스킬이며, 저장소는 해당 식별자와 버전 고정을 나열합니다.
`skills` CLI 통합	Vercel-labs Skills 명령줄 도구를 사용하여 특정 에이전트(예: `codex`, `omp`)에 대한 스킬을 추가, 나열, 관리합니다.
참조 문서(`REFERENCE.md`)	상세한 명령줄 구문, 두 가지 실행 모드(전역 vs. 프로젝트 전용), 각 워크플로우 작업(초기화, 업그레이드, 리셋, 마이그레이션, 정리, 복구)에 대한 정확한 프롬프트를 제공합니다.

설치 흐름

Onboard 스킬 부트스트랩 – 제공된 자연어 지침을 코딩 에이전트에 붙여넣거나 공식 Skills CLI를 실행합니다:
```
npx --yes skills@latest add https://github.com/KunoLu/640-skills \
  --skill sbtd-workflow-onboard --global --agent codex --yes --copy
```
설치된 디렉터리 검토 – Python 버전(≥3.10)을 확인하고 pip install -r <path>/requirements.txt를 실행하여 스킬의 Python 종속성을 충족합니다.
프로젝트 초기화 – init 또는 init-projects 프롬프트(README 참조)를 사용하여 하나 이상의 절대 프로젝트 경로에 AGENTS.md 및 필요한 전역 스킬을 설치합니다.
후속 작업(업그레이드, 리셋, 마이그레이션, 정리, 복구)은 모두 에이전트가 실행하는 프롬프트 템플릿으로 구동되며, README는 각 시나리오에 대해 복사하여 사용할 수 있는 텍스트를 제공합니다.

일반적인 사용법

최초 설정 – 부트스트랩 프롬프트를 복사하고, 에이전트가 태그(v2.0.1)를 검증한 다음, init 프롬프트를 실행하여 모든 스킬을 전역으로 설치하고 프로젝트별 구성을 생성합니다.
새 프로젝트 추가 – 대상 플랫폼(codex 또는 omp)으로 init-projects 프롬프트를 실행하여 지정된 프로젝트에만 영향을 주고 전역 스킬 설치는 그대로 둡니다.
업그레이드 – upgrade 프롬프트를 호출하여 계획을 생성하고, JSON 계획을 검토하고, 승인한 다음 적용합니다. 워크플로우는 계획, 적용, 검증 단계를 분리합니다.
SBTD v1에서 마이그레이션 – 전용 프롬프트 세트가 안전한 마이그레이션을 안내하며, 명시적 승인 전까지 레거시 데이터를 분리합니다.
정리 및 복구 – 레거시 자산 정리를 계획하거나 이전에 승인된 변경 배치를 복원하는 프롬프트가 있습니다.

중요한 이유

LLM 기반 코딩 에이전트가 코드베이스를 수정할 때 형식적이고 증거 기반의 프로세스를 제공하여 우발적 덮어쓰기를 줄입니다.
각 작업의 범위를 명시적으로 만듭니다(전역 vs. 프로젝트 전용, 백업 정책, 권한 확인). 이는 감사 가능성이 필요한 팀에게 중요합니다.
Skills 프레임워크를 통해 기본 CLI를 추상화하여 여러 호스트 에이전트(Codex, OMP, Claude Code, Kimi)에서 작동합니다.

추가 정보를 찾을 수 있는 곳

위의 모든 정보는 저장소의 README에서 직접 가져온 것이며, 추가 기능은 추론되지 않았습니다.

KunoLu/640-skills