103kaz/claude-code-loops

review-loop

현재 브랜치에서 개발 루프를 실행합니다: verify, diff 검토, 수정, 그리고 한 바퀴에서 아무것도 발견되지 않을 때까지 반복합니다. 범위는 전체 코드베이스가 아닌 diff만입니다. 이 스킬은 푸시하거나 풀 리퀘스트를 열지 않습니다. 해당 작업은 사용자에게 남겨집니다.

단계

1. .claude/verify.sh를 실행합니다. 실패하면 먼저 수정합니다. 파일이 없으면 사용자에게 알리고 /code-loops:init-verify를 안내한 후, 검증 없이 진행하며 보고서에 그 사실을 명시합니다.
2. diff를 결정합니다. 첫 번째 바퀴: 브랜치의 기준 브랜치에 대한 diff (git diff origin/HEAD...HEAD, 커밋되지 않은 변경사항에 대한 git diff HEAD, 그리고 git status --short에서 직접 읽은 추적되지 않은 파일들). origin/HEAD가 설정되지 않은 경우 origin/main 또는 origin/master를 시도합니다. 둘 다 없으면 사용자에게 기준 브랜치를 물어봅니다. diff가 비어 있으면(예: 기준 브랜치 자체에 있는 경우), 검토할 내용이 없다고 보고하고 중단합니다. 커밋되지 않은 변경사항이 브랜치 작업과 관련 없는 것으로 보이면 수정하지 말고 보고서에 언급합니다. 이후 바퀴: 이전 바퀴에서 변경한 내용만 diff로 사용합니다.
3. diff를 검토합니다.
   • 코드를 변경하는 경우 code-review 스킬을 중간 수준의 노력으로 사용합니다. 해당 스킬을 사용할 수 없으면 직접 diff를 읽어 버그(잘못된 결과, 누락된 오류 경로, 변경으로 인해 깨지는 호출자)를 찾습니다.
   • 문서만 변경하는 경우(.md 및 유사 파일), 대신 /code-loops:doc-code-consistency를 diff에 대해 실행합니다.
4. 발견된 문제를 수정합니다. 커밋하지 않고 사용자에게 맡깁니다. 각 수정 후 1단계로 돌아갑니다. 한 바퀴에서 아무것도 발견되지 않을 때까지 반복합니다. 수정하지 않기로 결정한 발견 사항은 한 줄 이유를 함께 남깁니다. 세 바퀴 연속으로 발견 사항이 계속 나타나면(verify.sh 실패 포함), 중단하고 남은 내용을 보고합니다.
5. diff가 문서에서 설명하는 코드를 변경한 경우, 마지막에 /code-loops:doc-code-consistency를 diff에 대해 한 번 실행하고 발견한 내용을 수정합니다.
6. 독립적인 리뷰를 한 번 제공합니다. 단, diff가 문서 전용인 경우는 제외합니다. 사용자에게 실행 여부를 묻고(AskUserQuestion), 이 diff가 검토할 가치가 있는지(크기, 위험 영역)에 대한 한 줄 메모를 추가합니다. 기본값은 '아니오'입니다. '예'인 경우 diff만 보고 빌드 방법은 보지 않는 하위 에이전트를 시작합니다. 읽기 전용 에이전트 유형(예: Explore)이 있으면 사용하고, 그렇지 않으면 파일을 편집하지 말라고 지시합니다. 변경 사항을 깨뜨리는 입력, 상태 및 순서를 찾고 각각을 파일:줄 증거와 함께 보고하도록 합니다. .claude/review/checklist.md가 있으면 그에 대해서도 검사하도록 합니다. 발견한 내용을 수정한 후, 해당 수정 사항에 대해서만 1단계와 3단계를 실행합니다. 하위 에이전트를 사용할 수 없으면 이 단계를 건너뛰고 보고서에 그 사실을 명시합니다.
7. 몇 줄로 보고합니다: "결과: 발견 사항 없음" 또는 "결과: 유지된 발견 사항"과 각 발견 사항 및 그 이유. verify.sh 통과 여부, 소요된 바퀴 수, 독립 리뷰 실행 여부를 추가합니다.

각 바퀴를 조용히 유지하십시오: 저장소가 아닌 diff를 읽고, 이전 바퀴의 발견 사항을 반복하지 마십시오.