skill-doctor은(는) 무엇을 하나요?
에이전트 스킬을 관찰 가능하고, 귀속 가능하며, 수리 가능하고, 검증 가능하게 진화시키는 플랫폼입니다. Codex 벤치마크가 함께 제공됩니다.
개요
s/doctor는 AI 에이전트(예: Claude Code, Cursor, Codex)의 스킬을 진화시키기 위한 도구입니다. 주요 기능은 다음과 같습니다:
- Observable (관찰 가능성): 에이전트의 동작과 결과를 기록하고 분석합니다.
- Attributable (귀속 가능성): 특정 스킬이 어떤 작업 결과에 영향을 미쳤는지 추적합니다.
- Repairable (수리 가능성): 발견된 문제를 대상으로 스킬을 수정하고 개선합니다.
- Verifiable (검증 가능성): Codex 벤치마크를 통해 개선된 스킬의 성능을 객관적으로 검증합니다.
시작하기
전제 조건
- Node.js 18 이상
- Git
- Codex CLI (또는 호환 AI 에이전트)
설치
git clone https://github.com/IsolatedStar0/skill-doctor.git
cd skill-doctor
npm install
사용법
1. 스킬 등록
npx s/doctor register --skill <skill-name> --description "스킬 설명"
2. 작업 실행 및 관찰
npx s/doctor run --task "수행할 작업 설명" --skill <skill-name>
3. 벤치마크 실행
npx s/doctor benchmark --skill <skill-name>
4. 스킬 수리
npx s/doctor repair --skill <skill-name> --issue "발견된 문제 설명"
워크플로우 예시
- 새 스킬을 등록합니다.
- 관련 작업을 실행하여 관찰 데이터를 수집합니다.
- Codex 벤치마크를 실행하여 초기 성능을 측정합니다.
- 문제가 발견되면 스킬을 수리합니다.
- 수정된 스킬로 다시 벤치마크를 실행하여 개선을 검증합니다.
- 스킬을 저장소에 커밋합니다.
설정
설정 파일 .skill-doctor.json을 프로젝트 루트에 생성할 수 있습니다:
{
"benchmarkDir": "./benchmarks",
"skillsDir": "./skills",
"observationsDir": "./observations",
"codexPath": "/usr/local/bin/codex"
}
API
CLI 명령어
| 명령어 | 설명 |
|---|---|
register | 새 스킬을 등록합니다 |
run | 작업을 실행하고 관찰합니다 |
benchmark | Codex 벤치마크를 실행합니다 |
repair | 스킬을 수리합니다 |
log | 관찰 로그를 확인합니다 |
라이선스
MIT