ai-agents-skills-toolkit은(는) 무엇을 하나요?
AI 코딩 에이전트를 위한 바이브 코딩 거버넌스 툴킷으로, Codex, Claude Code, 프로젝트 소유 워크플로우에서 소스 출처, 활성화 경계, 검증 정직성, 릴리스 증거를 관리합니다.
개요
이 툴킷은 AI 코딩 에이전트가 생성하는 코드의 품질과 신뢰성을 보장하기 위한 규칙과 도구 모음입니다. 주요 기능은 다음과 같습니다:
- 소스 출처(Provenance): 모든 AI 생성 코드에 출처 정보를 자동으로 주석 처리합니다.
- 활성화 경계(Activation Boundaries): 에이전트가 수정할 수 있는 파일과 디렉토리를 명시적으로 제한합니다.
- 검증 정직성(Validation Honesty): 자동화된 테스트 및 정적 분석 결과를 투명하게 기록하고, 실패를 숨기지 않습니다.
- 릴리스 증거(Release Evidence): 릴리스 전에 모든 검증 및 승인 과정의 증거를 수집합니다.
지원 플랫폼
- Codex:
codex.md설정 파일을 통해 활성화. - Claude Code:
CLAUDE.md또는.claude/settings.json을 통해 구성. - GitHub Actions:
.github/workflows/워크플로우 파일을 통한 CI/CD 통합. - 일반 프로젝트:
SKILL.md파일을 사용하는 모든 환경.
사용 방법
- 저장소 루트에
SKILL.md를 배치합니다. - 필요에 따라 활성화 경계를 설정합니다 (예:
activation-boundaries.yaml). - AI 에이전트가 작업을 수행하면 자동으로 출처 정보가 추가됩니다.
- 검증 단계에서
validation-honesty리포트가 생성됩니다. - 릴리스 단계에서
release-evidence디렉토리에 증거가 수집됩니다.
구성 예시
# activation-boundaries.yaml
always_allowed:
- src/*
- tests/*
- docs/*
forbidden:
- node_modules/*
- .env*
- secrets/*
라이선스
MIT