Communitygithub.com

AgentPilotLab/agent-lean-safe-coding

Codex, Claude Code 및 AI 에이전트를 위한 Windows 안전 린 코딩 스킬 및 플러그인 패키지입니다.

agent-lean-safe-coding란 무엇인가요?

이 스킬은 AI 코딩 에이전트(Codex, Claude Code 등)가 더 작고 안전하게 코드를 작성하도록 돕는 가이드입니다. 커스텀 코드를 작성하기 전에 먼저 기존 코드, 표준 라이브러리, 플랫폼 기능, 또는 이미 설치된 의존성을 재사용할 것을 권장하며(lite/full/audit 모드 지원), 특히 Windows 환경이나 비ASCII 텍스트, 마크다운, 프롬프트 등을 다룰 때 발생할 수 있는 깨지기 쉬운 편집 문제를 방지하기 위한 '안전 봉투(Safety Envelope)' 개념을 도입합니다. 작업 분류, 트리아지 사다리, 패치 예산 설정, 최소 검증, 최종 보고 등의 단계로 구성된 런타임 루프를 통해 에이전트가 불필요한 추상화나 중복 코드를 추가하지 않도록 제한합니다. 이 스킬은 `references/windows-text-safety.md`와 `references/reuse-ladder.md` 두 개의 참조 문서를 포함하여 복잡한 의사 결정을 지원합니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add AgentPilotLab/agent-lean-safe-coding

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

에이전트 릴 세이프 코딩

이 스킬을 사용하여 코딩 에이전트를 더 작고 안전하게 유지하세요: 필요한 동작만 빌드하고, 이미 존재하는 것을 재사용하며, Windows/텍스트 중심 리포지토리를 깨지기 쉬운 편집으로부터 보호하세요.

기본 모드는 full입니다.

  • lite: 빠른 분류, 좁은 컨텍스트, 가장 작은 안전 패치.
  • full: 분류 사다리, Windows/텍스트 안전 봉투, 의존성 검사, 패치 예산, 검증.
  • audit: 편집 없음; 과도한 빌드, 중복 로직, 의존성 위험, Windows/텍스트 위험, 취약한 검증에 대한 계획 또는 diff 검토.

런타임 루프

  1. 작업을 분류합니다.
  2. 위험한 파일을 안전 봉투 안에 넣습니다.
  3. 코드를 작성하기 전에 분류 사다리를 따라갑니다.
  4. 패치 예산을 설정합니다.
  5. 로컬에서 편집하고 스타일을 유지합니다.
  6. 가장 작은 목표 게이트를 검증합니다.
  7. 재사용 및 위험 노트와 함께 결과를 보고합니다.

1. 분류

편집 전에 작업 유형을 지정합니다:

  • 버그 수정: 공유 원인을 찾습니다; 가드를 흩뿌리기 전에 형제 호출자를 검사합니다.
  • 기능: 요청된 동작이 플랫폼, 프레임워크 또는 리포지토리에 이미 제공되는지 확인합니다.
  • 리팩터링: 구체적인 단순화 또는 위험 감소가 필요합니다; 취향에 따라 코드를 재배열하지 마십시오.
  • 검토: 삭제, 재사용 기회, 안전하지 않은 셸/텍스트 연산, 누락된 검사를 지적합니다.
  • 문서/텍스트: 인코딩, 줄 끝, 마크다운 구조 및 예제를 보호합니다.

요청이 불명확하지만 보수적인 기본값이 안전하다면, 그 기본값으로 진행하고 가정을 간략히 명시합니다.

2. 안전 봉투

다음 중 하나라도 있는 경우 안전 봉투를 사용합니다: Windows 경로, PowerShell 또는 cmd, 비ASCII 텍스트, 중국어 텍스트, 이모지, 마크다운, 프롬프트, 템플릿, 지역화 파일, 정확한 대체, 불확실한 인코딩, CRLF/LF에 민감한 파일, 또는 소스로 오인될 수 있는 생성된 출력.

봉투 내부:

  • 작은 편집에는 패치 도구를 선호합니다.
  • 셸 파이프라인이나 인라인 PowerShell 문자열을 통해 비ASCII 콘텐츠를 전달하지 마십시오.
  • 포매터가 파일을 소유하지 않는 한 기존 줄바꿈 스타일을 유지합니다.
  • 스크립트에는 경로 API나 따옴표로 묶인 리터럴 경로를 사용합니다.
  • 콘솔 모지바크는 디스플레이 증거로만 취급합니다; 다시 쓰기 전에 바이트 또는 UTF-8 읽기를 검사합니다.
  • 사용자가 명시적으로 요청하지 않는 한 생성된 폴더, 의존성 폴더, 캐시, 바이너리, 스크린샷 또는 아카이브를 편집하지 마십시오.

작업에 인코딩, 줄바꿈, 경로 또는 셸 취약성 위험이 있는 경우에만 references/windows-text-safety.md를 읽습니다.

3. 분류 사다리

커스텀 코드 전에, 작업을 깔끔하게 해결하는 첫 번째 수준에서 멈춥니다:

  1. 필요성을 제거합니다: 기존 경로를 삭제, 구성 또는 문서화하여 요청을 충족할 수 있습니까?
  2. 프로젝트 코드 재사용: 헬퍼, 컴포넌트, 훅, 검증기, 테스트 유틸리티, 명령어, 스키마 또는 확립된 패턴.
  3. 언어 또는 표준 라이브러리 동작을 사용합니다.
  4. 플랫폼 또는 프레임워크 동작을 사용합니다: 브라우저 제어, CSS, 데이터베이스 제약 조건, 프레임워크 라우팅, 검증, 캐싱, 직렬화 또는 빌드 도구.
  5. 이미 설치된 의존성을 사용합니다.
  6. 작은 로컬 구현을 추가합니다.
  7. 명확한 이유, 위험 및 승인 필요성과 함께 새 의존성 또는 더 큰 구현을 제안합니다.

프로덕션 의존성을 자동으로 추가하지 마십시오. 새 의존성이 정당화되는 것처럼 보이면, 그것이 대체하는 것, 설치된 옵션이 적합하지 않은 이유, 유지 관리 위험 및 정확한 설치 명령을 설명합니다.

의존성/재사용 결정이 명확하지 않은 경우에만 references/reuse-ladder.md를 읽습니다.

4. 패치 예산

편집 전에 작은 예산을 선택합니다:

  • 변경이 예상되는 파일.
  • 의도적으로 건드리지 않는 파일.
  • 재사용할 기존 코드 또는 플랫폼 기능.
  • 최소 검증 명령 또는 명령이 유용하지 않은 이유.

더 적은 파일, 더 적은 추상화, 그리고 동작에 가까운 직접적인 변경을 선호합니다. 현재 작업에 필요하지 않은 경우 인터페이스, 팩토리, 서비스 레이어, 구성 스위치, 미래 확장 지점 또는 래퍼를 추가하지 마십시오.

5. 패치 규칙

  • 호출자 측의 반복적인 해결 방법을 추가하는 대신 루트 경로를 한 번 수정합니다.
  • 동작이 올바르게 유지되면 중복 코드를 삭제합니다.
  • 포맷팅 변경을 diff에 포함시키지 마십시오.
  • 주석을 드물게 유지합니다; 의도적인 제한을 나중에 표시해야 하는 경우에만 하나의 간결한 주석을 사용합니다.
  • 단축키에 알려진 한계가 있다면, 그 주석에 한계와 업그레이드 트리거를 명시합니다.
  • 하나의 작은 함수를 하위 시스템으로 만들지 마십시오.

6. 검증

변경 사항을 증명하는 가장 좁은 새로운 게이트를 실행합니다:

  • 수정된 동작에 대한 기존 테스트.
  • 사소하지 않은 새 로직에 대한 집중된 단위 테스트 또는 자체 점검.
  • 테스트를 사용할 수 없는 경우 편집된 언어 파일에 대한 구문/타입/린트 검사.
  • 문서 전용 또는 사소한 한 줄 변경에 대한 diff 검토.

사소하지 않은 분기, 파서, 금전/보안 경로 또는 데이터 손실 경로는 실용적인 경우 하나의 실행 가능한 검사가 필요합니다. 사소한 한 줄짜리 변경에는 새 테스트 구조가 필요하지 않습니다.

7. 최종 보고

최종 보고는 간략하게 유지합니다:

변경됨 - ...
분류 - 재사용됨/표준 라이브러리/플랫폼/설치된 의존성/로컬 코드/새 의존성 제안
안전 - Windows/텍스트 위험 처리됨 또는 관련 없음
검증됨 - 명령/결과 또는 이유
위험 - 남은 제한 사항(있는 경우)

audit 모드의 경우, 가능하면 파일/줄 참조와 함께 먼저 결과를 반환한 다음, 삭제/재사용 목록과 가장 작은 검증 격차를 반환합니다.

관련 스킬