agnix은(는) 무엇을 하나요?
워크플로우가 중단되기 전에 에이전트 설정을 린트하세요. Claude Code, Cursor, GitHub Copilot, Codex CLI의 Skills, Hooks, MCP, Memory, Plugins를 검증합니다.
사용 시기
사용자가 다음과 같이 요청할 때 호출하세요:
- "내 에이전트 설정을 린트해줘"
- "내 스킬을 검증해줘"
- "내 CLAUDE.md를 확인해줘"
- "훅을 검증해줘"
- "MCP 설정을 린트해줘"
- "에이전트 설정 문제를 수정해줘"
지원 파일
| 파일 유형 | 예시 |
|---|---|
| Skills | SKILL.md |
| Memory | CLAUDE.md, AGENTS.md |
| Hooks | .claude/settings.json |
| MCP | *.mcp.json |
| Cursor | .cursor/rules/*.mdc |
| Copilot | .github/copilot-instructions.md |
실행
1. agnix 설치 확인
agnix --version
설치되지 않은 경우:
cargo install agnix-cli
2. 검증
agnix .
3. 문제가 발견되고 --fix가 요청된 경우
agnix --fix .
4. 재검증하여 확인
agnix .
CLI 참조
| 명령어 | 설명 |
|---|---|
agnix . | 현재 프로젝트 검증 |
agnix --fix . | 문제 자동 수정 |
agnix --strict . | 경고를 오류로 처리 |
agnix --target claude-code . | Claude Code 규칙만 적용 |
agnix --target cursor . | Cursor 규칙만 적용 |
agnix --watch . | 감시 모드 |
agnix --format json . | JSON 출력 |
출력 형식
CLAUDE.md:15:1 warning: 일반 지침 '도움이 되세요' [수정 가능]
help: 일반 지침을 제거하세요. Claude는 이미 이를 알고 있습니다.
skills/review/SKILL.md:3:1 error: 잘못된 이름 [수정 가능]
help: 소문자와 하이픈만 사용하세요.
오류 1개, 경고 1개 발견 (2개 수정 가능)
일반적인 문제 및 해결 방법
| 문제 | 해결 방법 |
|---|---|
| 잘못된 스킬 이름 | 소문자와 하이픈 사용: my-skill |
| 일반 지침 | "도움이 되세요", "정확하세요" 제거 |
| 트리거 문구 누락 | 설명에 "사용 시기..." 추가 |
| 디렉토리/이름 불일치 | 디렉토리 이름을 name: 필드와 일치하도록 변경 |