Communitygithub.com

zhaidewei/keep-or-sweep

유지, 수리, 보관, 또는 제거 — 증거 기반 에이전트 스킬

keep-or-sweep란 무엇인가요?

이 스킬은 에이전트가 하나의 명확히 경계 지어진 자산을 감사하여 증거 기반으로 유지(Keep), 수리 또는 교체(Repair or Replace), 보관(Archive), 삭제(Delete), 또는 일시 중지(Pause)라는 다섯 가지 처분 중 하나를 선택하도록 안내합니다. 개발자 도구와 AI 에이전트(Claude Code, Cursor, Codex 등) 환경에서 사용되며, 특히 레거시 코드나 중복 자산을 정리할 때 유용합니다. 워크플로는 자산 경계 설정, 읽기 전용 인벤토리 조사, 삭제 반사실 테스트, 역할 분류, 최종 처분 선택의 5단계로 구성됩니다. 이 스킬은 사용자 증거를 최우선으로 하며, 추측이나 유사성만으로 판단하지 않도록 주의합니다. 또한 실행 권한 범위 내에서만 행동하도록 강제하여 삭제 전 복구 방법을 명시하고, 삭제 후 예상 소비자를 검증합니다. 결정 트리 다이어그램을 통해 증거 부족 시 일시 중지하고, 삭제 시 관찰 가능한 동작 악화 여부, 유지 의무, 유지보수 메커니즘의 신뢰성을 단계적으로 평가합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add zhaidewei/keep-or-sweep

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

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

문서

Keep or Sweep

하나의 명확히 경계 지어진 자산을 감사하십시오. 이를 전체 저장소 중복 제거나 표준 저장소로 확장하지 마십시오.

워크플로

  1. 자산 경계 설정. 정확한 대상, 소유자 또는 권한, 허용된 작업, 영향 범위를 명시하십시오. 요청에 여러 독립 자산이 포함된 경우, 이 감사에서 하나의 명확한 대상을 선택하고 나머지는 범위 밖으로 목록화하십시오. 동일한 감사 내에서 목록을 계속 진행하지 마십시오.
  2. 읽기 전용 인벤토리. 실제 소비자, 호출자, 트리거, 의존성, 입력, 출력, 계약, 생성된 복사본, 이력, 보존 의무, 런타임 사용을 찾으십시오. 이름과 동작을 검색하십시오. 동적 사용과 사용할 수 없는 권한은 알 수 없는 상태로 남습니다.
  3. 삭제 반사실 테스트. 자산이 사라질 경우 어떤 관찰 가능한 사용자 또는 에이전트 동작이 악화될지를 기술하십시오. 이름 일치나 유사한 형태는 중복성을 증명하지 않습니다.
  4. 역할 분류. 진실의 원천, 프로젝션, 어댑터는 역할이지 판결이 아닙니다. 프로젝션의 경우, 소비자별 가치, 소스와의 일관성, 재생성 또는 동기화 가능성, 그리고 소유자, 트리거, 드리프트 감지, 복구 경로를 갖춘 유지보수 메커니즘을 검증하십시오.
  5. 정확히 하나의 처분을 선택하십시오.
    • 유지(Keep): 입증된 가치와 신뢰할 수 있는 유지보수 메커니즘이 있습니다.
    • 수리 또는 교체(Repair or Replace): 입증된 사용자가 있지만 현재 메커니즘이 신뢰할 수 없습니다.
    • 보관(Archive): 라이브 사용은 없지만 법적, 역사적, 감사, 또는 계약상 보존 의무가 있습니다.
    • 삭제(Delete): 관찰 가능한 동작이 악화되지 않고 보존 의무도 없습니다. 이는 권장 사항이며 실행을 승인하지 않습니다.
    • 일시 중지(Pause): 증거, 권한, 승인, 복구 가능성, 또는 되돌릴 수 없는 위험 분석이 불충분합니다.
  6. 권한 내에서만 실행하십시오. 읽기 전용 감사는 삭제, 덮어쓰기, 원격 상태 변경, 또는 되돌릴 수 없는 변경을 허용하지 않습니다. 삭제 전에는 복구 방법을 명시하십시오. 삭제 후에는 예상 소비자를 확인하고 아직 입증되지 않은 사항을 보고하십시오.

결정 트리

flowchart TD
    A["하나의 자산 경계 설정<br/>및 읽기 전용 인벤토리"] --> B{"증거가 충분한가?"}
    B -- "아니오" --> P["일시 중지하고<br/>누락된 증거를 명시"]
    B -- "예" --> C{"삭제가 관찰 가능한<br/>동작을 악화시키는가?"}
    C -- "알 수 없음" --> P
    C -- "아니오" --> D{"보존 의무가 있는가?"}
    D -- "예" --> R["보관"]
    D -- "아니오" --> X["삭제 권장"]
    C -- "예" --> F{"유지보수 메커니즘이<br/>신뢰할 수 있는가?"}
    F -- "예" --> K["유지"]
    F -- "아니오" --> N["수리 또는 교체"]

알려지지 않은 소비자, 동적 호출, 접근 부족, 증거 부재는 사용되지 않음을 의미하지 않습니다. 불확실할 때는 일시 중지하고 처분을 바꿀 수 있는 가장 작은 다음 확인 사항을 식별하십시오.

관련 스킬