에이전트 지시 파일 감사
목표: 지시 파일에서 잘못되었거나, 오래되었거나, 모호하거나, 위험한 줄을 찾고, 더 짧고 정확한 버전을 제안합니다. 직접 실행해보지 않은 명령어나 확인하지 않은 경로를 절대 '수정'하지 마세요.
단계
- 파일을 찾습니다.
AGENTS.md,CLAUDE.md,CLAUDE.local.md,.claude/rules/*.md,.cursor/rules/*.mdc,.cursorrules,.github/copilot-instructions.md,.github/instructions/*.md파일을 찾으세요. 찾은 파일과 각 파일을 읽는 주체를 나열하세요. - 검사기를 실행하여 기계적 결함을 먼저 찾으세요.
python3 scripts/audit_instructions.py <파일> [<파일> ...](경로는 이 스킬 폴더 기준 상대 경로이며, 설치된 스킬의 전체 경로를 사용하세요.) 이 도구는 길이, 깨진 파일 경로, 존재하지 않는 스크립트나 Make 타겟을 명명하는 명령어, 모호한 구문, 남아있는[BRACKET]플레이스홀더, 중복 줄, 비밀번호 같은 문자열을 보고합니다. Python을 사용할 수 없는 경우 동일한 검사를 수동으로 수행하세요. - 각 명령어를 직접 확인합니다. 파일에 있는 모든 명령어가 존재하는지 확인하세요 (
package.json의 스크립트,Makefile의 타겟,pyproject.toml의 항목). 저렴하고 안전한 명령어(린트, 단위 테스트, 타입 검사)는 실행하세요. 배포, 마이그레이션 또는 삭제 명령어는 실행하지 말고 '검증되지 않음'으로 나열하세요. - 판단이 필요한 사항 (스크립트가 할 수 없는 것)을 확인합니다.
- 린터나 포맷터가 이미 강제하는 규칙(삭제 후보).
- 서로 모순되거나 다른 지시 파일과 모순되는 규칙.
- 에이전트가 저장소에서 몇 초 안에 읽을 수 있는 사실(프레임워크 이름, 폴더 목록).
- 테스트 가능한 의미가 없는 규칙('깨끗한 코드 작성').
- 루트 파일이 아닌 경로 범위 규칙에 속해야 하는 내용.
- 보고서를 작성하고, 승인을 기다린 후 편집하세요.
보고서 형식
## 지시 파일 감사: <파일>
길이: <n> 줄 (<판단>)
### 반드시 수정 (잘못되었거나 안전하지 않음)
- 줄 <n>: <잘못된 점>, <증거: 명령어 출력 또는 누락된 경로>
### 제거 권장 (가치 낮음)
- 줄 <n>: <제거 이유>
### 모순
- <파일 A 줄 n> vs <파일 B 줄 m>: <충돌 내용>
### 검증되지 않음
- <명령어>: <실행하지 않은 이유>
### 제안된 버전
<더 짧은 파일 또는 diff>
규칙
- 증거가 의견보다 우선합니다: 모든 '반드시 수정' 항목은 명령어 출력이나 누락된 파일을 인용합니다.
- 소유자의 어조와 실제 사건이나 엄격한 제약 조건을 인코딩한 규칙은 유지합니다.
- 감사 중에 새 규칙을 추가하지 마세요. 끝에 별도로 최대 세 개까지 제안하세요.
- 비밀번호 같은 문자열은 실제로 취급하세요: 사용자에게 교체하라고 알리고, 보고서에 값을 반복하지 마세요.