workspace-health-audit은(는) 무엇을 하나요?
증거 우선, 기본적으로 읽기 전용인 에이전트 스킬로, 작업 공간 상태를 감사하고 감사 부작용을 탐지합니다.
개요
이 스킬은 AI 에이전트가 작업 공간의 건강 상태를 점검할 때, 다음 원칙을 따르도록 설계되었습니다:
- 증거 우선(Evidence-first): 에이전트는 감사 결과를 내리기 전에 먼저 구체적인 증거를 수집하고 기록합니다.
- 기본적으로 읽기 전용(Read-only by default): 감사 중에는 작업 공간의 파일이나 설정을 변경하지 않습니다.
- 감사 부작용 탐지(Audit side effect detection): 감사 과정 자체가 작업 공간에 의도치 않은 변경을 가하는 것을 방지합니다.
사용 방법
에이전트에게 작업 공간 감사를 요청할 때, 다음과 같이 사용할 수 있습니다:
/workspace-health-audit
또는 특정 항목을 지정하여 감사를 수행할 수 있습니다:
/workspace-health-audit --check git-status
/workspace-health-audit --check file-permissions
주요 기능
- Git 상태 확인: 작업 공간의 Git 브랜치, 변경 사항, 충돌 여부 등을 확인합니다.
- 파일 시스템 검사: 중요 파일의 존재 여부, 권한, 크기 등을 점검합니다.
- 의존성 검사: 프로젝트의 종속성 파일(package.json, requirements.txt 등)의 무결성을 확인합니다.
- 설정 파일 검사: .env, .gitignore 등 설정 파일의 존재와 내용을 확인합니다.
- 부작용 탐지: 감사 과정에서 발생한 의도치 않은 변경 사항을 기록하고 보고합니다.
감사 결과 예시
감사가 완료되면 에이전트는 다음과 같은 형식으로 결과를 제공합니다:
## 작업 공간 감사 결과
### Git 상태
- 브랜치: main
- 변경 사항: 없음 (클린 상태)
- 충돌: 없음
### 파일 시스템
- `package.json`: 존재, 크기 1.2KB
- `README.md`: 존재, 크기 3.5KB
- `.env`: 누락 (권장: 생성 필요)
### 감사 부작용
- 없음 (모든 작업 읽기 전용으로 수행됨)
지원 플랫폼
- Claude Code
- Cursor
- Codex
- 기타 AI 에이전트 플랫폼
주의 사항
- 이 스킬은 기본적으로 읽기 전용 모드로 동작합니다. 쓰기 작업이 필요한 경우 명시적으로 요청해야 합니다.
- 감사 결과는 에이전트의 컨텍스트 내에서만 유지되며, 별도로 저장되지 않습니다.
- 대규모 작업 공간의 경우 감사에 시간이 소요될 수 있습니다.
라이선스
MIT