에이전트 릴 세이프 코딩
이 스킬을 사용하여 코딩 에이전트를 더 작고 안전하게 유지하세요: 필요한 동작만 빌드하고, 이미 존재하는 것을 재사용하며, Windows/텍스트 중심 리포지토리를 깨지기 쉬운 편집으로부터 보호하세요.
기본 모드는 full입니다.
lite: 빠른 분류, 좁은 컨텍스트, 가장 작은 안전 패치.full: 분류 사다리, Windows/텍스트 안전 봉투, 의존성 검사, 패치 예산, 검증.audit: 편집 없음; 과도한 빌드, 중복 로직, 의존성 위험, Windows/텍스트 위험, 취약한 검증에 대한 계획 또는 diff 검토.
런타임 루프
- 작업을 분류합니다.
- 위험한 파일을 안전 봉투 안에 넣습니다.
- 코드를 작성하기 전에 분류 사다리를 따라갑니다.
- 패치 예산을 설정합니다.
- 로컬에서 편집하고 스타일을 유지합니다.
- 가장 작은 목표 게이트를 검증합니다.
- 재사용 및 위험 노트와 함께 결과를 보고합니다.
1. 분류
편집 전에 작업 유형을 지정합니다:
버그 수정: 공유 원인을 찾습니다; 가드를 흩뿌리기 전에 형제 호출자를 검사합니다.기능: 요청된 동작이 플랫폼, 프레임워크 또는 리포지토리에 이미 제공되는지 확인합니다.리팩터링: 구체적인 단순화 또는 위험 감소가 필요합니다; 취향에 따라 코드를 재배열하지 마십시오.검토: 삭제, 재사용 기회, 안전하지 않은 셸/텍스트 연산, 누락된 검사를 지적합니다.문서/텍스트: 인코딩, 줄 끝, 마크다운 구조 및 예제를 보호합니다.
요청이 불명확하지만 보수적인 기본값이 안전하다면, 그 기본값으로 진행하고 가정을 간략히 명시합니다.
2. 안전 봉투
다음 중 하나라도 있는 경우 안전 봉투를 사용합니다: Windows 경로, PowerShell 또는 cmd, 비ASCII 텍스트, 중국어 텍스트, 이모지, 마크다운, 프롬프트, 템플릿, 지역화 파일, 정확한 대체, 불확실한 인코딩, CRLF/LF에 민감한 파일, 또는 소스로 오인될 수 있는 생성된 출력.
봉투 내부:
- 작은 편집에는 패치 도구를 선호합니다.
- 셸 파이프라인이나 인라인 PowerShell 문자열을 통해 비ASCII 콘텐츠를 전달하지 마십시오.
- 포매터가 파일을 소유하지 않는 한 기존 줄바꿈 스타일을 유지합니다.
- 스크립트에는 경로 API나 따옴표로 묶인 리터럴 경로를 사용합니다.
- 콘솔 모지바크는 디스플레이 증거로만 취급합니다; 다시 쓰기 전에 바이트 또는 UTF-8 읽기를 검사합니다.
- 사용자가 명시적으로 요청하지 않는 한 생성된 폴더, 의존성 폴더, 캐시, 바이너리, 스크린샷 또는 아카이브를 편집하지 마십시오.
작업에 인코딩, 줄바꿈, 경로 또는 셸 취약성 위험이 있는 경우에만 references/windows-text-safety.md를 읽습니다.
3. 분류 사다리
커스텀 코드 전에, 작업을 깔끔하게 해결하는 첫 번째 수준에서 멈춥니다:
- 필요성을 제거합니다: 기존 경로를 삭제, 구성 또는 문서화하여 요청을 충족할 수 있습니까?
- 프로젝트 코드 재사용: 헬퍼, 컴포넌트, 훅, 검증기, 테스트 유틸리티, 명령어, 스키마 또는 확립된 패턴.
- 언어 또는 표준 라이브러리 동작을 사용합니다.
- 플랫폼 또는 프레임워크 동작을 사용합니다: 브라우저 제어, CSS, 데이터베이스 제약 조건, 프레임워크 라우팅, 검증, 캐싱, 직렬화 또는 빌드 도구.
- 이미 설치된 의존성을 사용합니다.
- 작은 로컬 구현을 추가합니다.
- 명확한 이유, 위험 및 승인 필요성과 함께 새 의존성 또는 더 큰 구현을 제안합니다.
프로덕션 의존성을 자동으로 추가하지 마십시오. 새 의존성이 정당화되는 것처럼 보이면, 그것이 대체하는 것, 설치된 옵션이 적합하지 않은 이유, 유지 관리 위험 및 정확한 설치 명령을 설명합니다.
의존성/재사용 결정이 명확하지 않은 경우에만 references/reuse-ladder.md를 읽습니다.
4. 패치 예산
편집 전에 작은 예산을 선택합니다:
- 변경이 예상되는 파일.
- 의도적으로 건드리지 않는 파일.
- 재사용할 기존 코드 또는 플랫폼 기능.
- 최소 검증 명령 또는 명령이 유용하지 않은 이유.
더 적은 파일, 더 적은 추상화, 그리고 동작에 가까운 직접적인 변경을 선호합니다. 현재 작업에 필요하지 않은 경우 인터페이스, 팩토리, 서비스 레이어, 구성 스위치, 미래 확장 지점 또는 래퍼를 추가하지 마십시오.
5. 패치 규칙
- 호출자 측의 반복적인 해결 방법을 추가하는 대신 루트 경로를 한 번 수정합니다.
- 동작이 올바르게 유지되면 중복 코드를 삭제합니다.
- 포맷팅 변경을 diff에 포함시키지 마십시오.
- 주석을 드물게 유지합니다; 의도적인 제한을 나중에 표시해야 하는 경우에만 하나의 간결한 주석을 사용합니다.
- 단축키에 알려진 한계가 있다면, 그 주석에 한계와 업그레이드 트리거를 명시합니다.
- 하나의 작은 함수를 하위 시스템으로 만들지 마십시오.
6. 검증
변경 사항을 증명하는 가장 좁은 새로운 게이트를 실행합니다:
- 수정된 동작에 대한 기존 테스트.
- 사소하지 않은 새 로직에 대한 집중된 단위 테스트 또는 자체 점검.
- 테스트를 사용할 수 없는 경우 편집된 언어 파일에 대한 구문/타입/린트 검사.
- 문서 전용 또는 사소한 한 줄 변경에 대한 diff 검토.
사소하지 않은 분기, 파서, 금전/보안 경로 또는 데이터 손실 경로는 실용적인 경우 하나의 실행 가능한 검사가 필요합니다. 사소한 한 줄짜리 변경에는 새 테스트 구조가 필요하지 않습니다.
7. 최종 보고
최종 보고는 간략하게 유지합니다:
변경됨 - ...
분류 - 재사용됨/표준 라이브러리/플랫폼/설치된 의존성/로컬 코드/새 의존성 제안
안전 - Windows/텍스트 위험 처리됨 또는 관련 없음
검증됨 - 명령/결과 또는 이유
위험 - 남은 제한 사항(있는 경우)
audit 모드의 경우, 가능하면 파일/줄 참조와 함께 먼저 결과를 반환한 다음, 삭제/재사용 목록과 가장 작은 검증 격차를 반환합니다.