Skip to content

hashgraph-online/awesome-codex-plugins / plugins/alpoxdev/hypercore/skills/hyper-review

hyper-review

Verified

Use this skill when a change that already exists needs a verdict - review only a diff, a branch, a pull request, or the working tree, with an independent reviewer, a hands-on QA matrix, and a test-quality and code-smell gate, or review and fix the confirmed blockers when the user explicitly asks for repairs. It binds the verdict to the reviewed content, saves `.hyper/review/[slug].md`, and edits no source file unless the user asked to fix. Do not use it for a change that does not exist yet, a design or look review, a deployment failure, a runtime failure to diagnose, or a one-line wording edit.

rules/fix-protocol.ko.md

View on GitHub
# 수정 프로토콜

리뷰 후 수정 모드에서만 이 파일을 읽는다. 리뷰 전용 모드에서는 검토 대상 트리를 건드리지 않고, 발견 사항은 보고서로 간다. 여기서는 변경이 확정된 블로커를 없애는 최소한이고, 정해진 순서로 적용하며, 그 뒤 리뷰를 다시 돌린다.

## Contents

1. Preconditions
2. The change ladder
3. The safe execution order
4. What stays
5. Re-review
6. Out of bounds

## 1. Preconditions

첫 편집 전에 모두 참이어야 한다.

- 사용자가 리뷰만이 아니라 리뷰 후 수정을 요청했다. "고쳐라", "블로커를 수리해", "리뷰를 반영해"는 해당한다. "판단만 해줘"와 그냥 "리뷰해줘"는 해당하지 않는다.
- 블로커가 적혀 있고, 각각 `file:line`이나 산출물과 관찰된 실패가 붙는다.
- 내용 정체성을 기록해, 수리한 트리를 검토한 트리와 비교할 수 있다.
- 변경이 사용자의 전달 규칙이 편집을 허락하는 브랜치나 워크트리에 있다. 사용자가 내주지 않은 분리된 헤드에서는 절대 수리하지 않는다.

하나라도 어기면 실행은 리뷰 전용으로 남고 보고서가 그렇게 밝힌다.

## 2. The change ladder

블로커를 없애는 가장 낮은 단을 고른다. 더 깔끔해 보인다는 이유로 높은 단으로 올라가지 않는다.

| 단 | 행동 | 쓰는 때 |
|---|---|---|
| 1 | 삭제 | 코드가 확실히 죽었거나, 블로커가 닿을 수 없는 낡은 분기 |
| 2 | 재사용 | 변경이 프로젝트에 이미 있는 헬퍼나 패턴을 다시 구현해 블로커가 생겼다 |
| 3 | 제자리 단순화 | 블로커가 틀린 조건, 과하게 지은 분기, 현재 모양 안의 중복 재검증 |
| 4 | 단위 추출 | 블로커가 크기나 결합 트리거이고, 추출한 단위에 실제 경계나 두 번째 호출자가 있다 |
| 5 | 추상화 도입 | 현재 계약이 여러 구현을 요구할 때만. 블로커 수정에는 거의 해당하지 않는다 |

사다리 규칙:

- 블로커 하나에 단 하나. 두 단을 넘는 수정은 블로커 둘이거나 범위 변경이다.
- 사다리를 써서 블로커가 요구하지 않는 의존성, 호환 계층, 새 공개 API, 설정 플래그를 더하지 않는다.
- 블로커와 그 호출자보다 넓게 닿는 수정은 적용하지 않고 계획으로 보고서에 쓴다.

## 3. The safe execution order

1. **기준선.** 블로커를 보여 주는 가장 좁은 테스트나 가장 작은 실제 시나리오를 돌리고 실패 출력을 기록한다. 이것이 이전 상태다.
2. **참조 지도.** 바꿀 기호마다 호출자, 구현, 테스트, 설정 참조를 모두 찾아 목록으로 만든다.
3. **기호 인식 이름 변경·이동.** 편집이 이름 변경이나 이동이면 텍스트 치환보다 편집기의 언어 인식 이름 변경을 먼저 쓴다.
4. **구조적 재작성 미리보기.** 구문 트리를 바꾸거나 블록을 옮기는 편집이면 적용 전에 미리 본다.
5. **일관된 편집 하나.** 블로커 수정을 반쪽이 아니라 통째로 적용해, 옛 경로와 새 경로가 반쯤 함께 있는 상태를 만들지 않는다.
6. **영향받은 파일 전체 읽기.** diff만이 아니라 파일을 통째로 읽는다.
7. **소유자 검사.** 가장 좁은 테스트, 그다음 바뀐 영역의 프로젝트 선언 테스트와 빌드를 돌리고 출력을 기록한다.
8. **실제 표면 스모크.** 사용자나 호출자가 보는 것은 매트릭스가 쓴 것과 같은 호출로 확인한다.
9. **정체성 재계산.** 아래 새 리뷰를 돌린다.

어느 단계에서든 수정이 틀렸다는 것이 드러나면 그 자리에서 멈춘다. 반쯤 적용한 편집을 되돌리는 편이 이어 가는 것보다 싸다.

## 4. What stays

수리는 블로커처럼 보여도 지지하는 것을 모두 유지한다.

- 신뢰 경계의 입력 검증, 보안 확인, 권한 확인.
- 실패를 침묵이 아니라 보고된 실패로 바꾸는 오류 처리.
- 공개 시그니처, 전송 형식, 마이그레이션 파일, 다른 코드나 데이터가 의존하는 인터페이스.
- 반복처럼 보이지만 타입 시스템이 넘지 못하는 경계에 있는 가드.
- 의도된 동작을 담아 지금 실패하는 테스트. 테스트가 아니라 코드를 고친다.

블로커를 없애려고 실패하는 테스트를 약화, 건너뛰기, 삭제, 다시 기록하지 않는다. 가는 길에 두 번째 발견 사항을 고쳐 범위를 넓히지 않는다. 그 발견 사항은 수정 메모와 함께 보고서로 간다.

## 5. Re-review

수리는 판정이 아니다.

- 수리 뒤 내용 정체성을 다시 계산한다.
- 영향받은 QA 행을 다시 돌리고, 수리한 동작에 행을 더한다.
- 리뷰어가 옛 내용을 판정했으므로 새 리뷰 레인을 다시 돌린다.
- 보고서에 새 정체성을 옛 정체성 옆에 쓰고, 수리한 블로커마다 사라졌음을 보여 주는 산출물을 붙인다.
- 새 리뷰가 통과했을 때만 `Result: fixed: <n> blockers repaired, review passed on <identity>`로 끝낸다. 블로커가 살아남거나 새 블로커가 나타나면 결과는 살아남은 블로커를 붙인 `failed`다.

수리 패스는 최대 두 번이다. 세 번째 패스는 변경이 아니라 리뷰어의 인내를 검토하게 된다. 대신 살아남은 블로커를 보고서에 쓰고 멈춘다.

## 6. Out of bounds

어떤 모드에서도 절대 하지 않는다.

- 커밋, 푸시, 병합, 태그, 끌어오기 요청 열기, 배포
- 사용자 데이터, 브랜치, 워크트리, 잠금 파일, 이 실행의 산출물이 아닌 추적되지 않은 파일 삭제
- 배포된 환경이 이미 적용한 마이그레이션 재작성
- 블로커 수정의 부수 효과로 의존성 버전, 잠금 파일, CI 설정, 저장소 설정 변경
- 블로커가 건드리지 않는 파일 재포매팅
- 메시지, 주석, 프롬프트의 정확한 문구를 고정하는 테스트 추가

수정이 이것 중 하나를 필요로 하는 블로커는 수리하지 않고 이유와 함께 `blocked`로 보고한다.

## Sources

> Checked 2026-11-10.

| Claim | Source |
|---|---|
| 삭제, 재사용, 단순화, 추출, 추상화 사다리와 기준선, 참조 지도, 기호 인식 이름 변경, 재작성 미리보기, 일관된 편집 하나, 소유자 테스트의 안전한 실행 순서 | `dbc-hbin/omp-ulw@74df40f refactor` (메커니즘 참조, 다시 씀. 텍스트를 복사하지 않음) |
| 경계 검증, 보안 확인, 오류 처리, 공개 시그니처 유지 | 같은 출처, 다시 씀 |
| 수리 뒤 옛 정체성과 새 정체성을 함께 기록하며 다시 리뷰한다 | 이 패키지가 고른 설계 |
| 수리 두 번 상한과 범위 밖 목록 | 이 패키지가 고른 설계 |

### Evidence grade

사다리와 안전한 실행 순서는 `MECHANISM`이다. 재리뷰 요구, 수리 상한, 금지 목록은 `LOCAL`이다. 사다리는 출처가 고른 순서이지 측정된 최적값이 아니다.
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 321kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 321kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 321kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 197kUpdated Claude CodeCodexVerifiedInstall