hashgraph-online/awesome-codex-plugins / plugins/alpoxdev/hypercore/skills/hyper-review
hyper-review
VerifiedUse 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.
| File | Kind | Size |
|---|---|---|
| SKILL.ko.md | markdown | 20.8 KB |
| SKILL.md | skill md | 19.2 KB |
| assets/evals/hyper-review-cases.jsonl | other | 16.4 KB |
| rules/code-smells.ko.md | markdown | 7.4 KB |
| rules/code-smells.md | markdown | 7.5 KB |
| rules/context-and-identity.ko.md | markdown | 6.5 KB |
| rules/context-and-identity.md | markdown | 5.9 KB |
| rules/fix-protocol.ko.md | markdown | 7.0 KB |
| rules/fix-protocol.md | markdown | 6.3 KB |
| rules/qa-matrix.ko.md | markdown | 7.0 KB |
| rules/qa-matrix.md | markdown | 6.5 KB |
| rules/review-checklist.ko.md | markdown | 10.1 KB |
| rules/review-checklist.md | markdown | 9.4 KB |
| rules/test-quality.ko.md | markdown | 6.9 KB |
| rules/test-quality.md | markdown | 6.3 KB |
| rules/verdicts.ko.md | markdown | 8.6 KB |
| rules/verdicts.md | markdown | 8.3 KB |
rules/review-checklist.ko.md
View on GitHub# 리뷰 체크리스트
여덟 루브릭 항목이다. 독립 리뷰어가 여덟 개를 모두 검토 대상 내용에 적용하고, 리더가 직접 검토할 때도 같은 여덟 개를 적용한다. 항목마다 판정 단어와 포인터가 최소 하나 붙는다.
## Contents
1. Item 1: goal
2. Item 2: constraints
3. Item 3: behavior across states
4. Item 4: code quality
5. Item 5: security
6. Item 6: missed context
7. Item 7: QA audit
8. Item 8: scope
9. Item shape
10. Severity
## 1. Item 1: goal
변경이 말하는 일을 하는가.
- 요청과 변경 자체의 설명에서 목표를 한 문장으로 쓰고, 그 목표가 확인된 것인지 추론된 것인지 밝힌다.
- 주 경로를 끝까지 따라간다. 진입점, 변경, 관찰 가능한 결과.
- "코드가 그렇게 보인다"와 "QA 행이 그렇게 보여 준다"를 구분한다. 통과를 뒷받침하는 것은 두 번째뿐이다.
- 변경이 목표를 일부만 달성했고 빠진 부분이 변경의 이유라면 그것은 메모가 아니라 블로커다.
판정: `met`, `partly met`, `not met`, `unclear`.
## 2. Item 2: constraints
사용자나 프로젝트가 세운 제약이 모두 유지된다.
- 명시된 제약을 모두 적고 `held`, `broken`, `not checked`로 표시한다.
- 눈에 안 보이는 제약도 본다. 공개 인터페이스, 파일 형식, 오류 계약, 모듈 경계, 이름 규칙, 라이선스 헤더, 지원 런타임 버전.
- 아무도 문서에 쓰지 않은 제약을 테스트와 호출자에서 읽는다. 다른 코드가 의존하는 함수는 문서가 없어도 계약이 있다.
- 작성자가 언급하지 않은 깨진 제약은 다른 코드에 영향을 주면 블로커, 프로젝트가 강제하지 않는 스타일에만 영향을 주면 메모다.
판정: 제약마다 `held`, `broken`, `not checked`.
## 3. Item 3: behavior across states
바뀐 동작이 변경이 닿는 상태에서 유지된다. 해피 패스 시연이 리뷰가 아닌 이유가 이 항목이다.
해당되는 것을 확인하고, 해당되지 않는 것은 이유와 함께 밝힌다.
- 비어 있음: 항목 없음, 입력 없음, 빠진 선택 필드, 없는 설정 값.
- 경계: 0, 1, 최댓값, 최댓값 하나 초과, 빈 문자열과 없는 문자열의 차이.
- 잘못된 형식: 잘못된 타입, 잘린 입력, 잘못된 인코딩, 알 수 없는 필드, 범위 밖 값.
- 실패: 의존성이 오류를 내거나, 시간 초과하거나, 닿지 않거나, 코드가 예상하지 않는 모양을 반환한다.
- 동시성: 호출자 둘, 재시도된 요청, 중복 메시지, 변경이 만들거나 건드리는 잠금이나 경쟁.
- 반복: 같은 작업 두 번, 마이그레이션 재실행, 재개된 작업.
상태마다 목표가 함의하는 결과를 적고, QA 매트릭스가 관찰한 결과를 적는다. 둘이 다르면 산출물이 붙은 블로커다.
판정: `holds`, `<state>에서 breaks`, `<state>에서 unproven`.
## 4. Item 4: code quality
변경을 다음 사람이 유지할 수 있는가. 취향이 아니라 측정 가능한 신호로 판단한다.
- 바뀐 단위마다 [code-smells.md](code-smells.md)를 적용하고, 걸린 트리거를 측정값과 함께 적는다.
- 변경이 이미 있는 것을 재사용하는지, 같은 일을 하는 두 번째 방법을 더하는지 확인한다. 중복을 이름 붙인다.
- 새 코드에 바뀌어야 할 이유가 하나인지, 이름이 그 일을 긍정형으로 말하는지 확인한다.
- 주석이 무엇이 아니라 왜를 설명하는지, 아래 줄을 다시 말하는 주석이 없는지 확인한다.
- 죽은 코드와 디버그 잔여물이 없는지 확인한다. 쓰지 않는 import, 닿을 수 없는 분기, `print`나 `console.log`, 주석 처리한 블록.
- 오류 처리를 확인한다. 오류는 그것을 다룰 수 있는 층에서 다루거나 맥락을 붙여 전파하고, 성공처럼 읽히는 기본값으로 삼키지 않는다.
판정: `clean`, `minor`, `blocking`, 트리거마다 이름을 붙인다.
## 5. Item 5: security
변경이 호출자가 해서는 안 되는 일을 할 수 있는 길을 더하지 않는다.
- 권한: 새 경로가 이웃 경로와 같은 권한 확인을 한다. 빠진 확인은 블로커다.
- 입력: 신뢰 경계를 넘는 값이 검증되고 목적지에 맞게 인코딩된다. 경계와 인코딩을 이름 붙인다.
- 비밀: 자격 증명, 토큰, 키, 개인 값이 코드, 테스트, 픽스처, 로그, 오류 메시지에 없다. 픽스처의 비밀은 분명히 가짜이고 그렇게 표시되지 않으면 블로커다.
- 데이터 노출: 오류 경로, 디버그 엔드포인트, 로그 줄이 성공 경로보다 많이 드러내지 않는다.
- 주입: 입력으로 만든 쿼리, 셸 명령, 템플릿, 경로, 역직렬화가 매개변수화되거나 허용 목록을 쓴다.
- 기본값: 새 기본값이 안전한 쪽이고, 주변 코드가 엄격한데 관대한 기본값이면 블로커다.
- 의존성: 새 의존성이 필요하고, 고정되며, 프로젝트가 이미 신뢰하는 출처에서 온다. 한 줄짜리 문제를 고치려고 더한 의존성은 최소한 메모다.
판정: `no new exposure`, `exposure: <what>`, `needs a threat-specific check`.
## 6. Item 6: missed context
변경이 주변 코드와 문서에 맞는다.
- 바뀐 함수, 타입, 필드의 다른 호출자를 모두 찾는다. 변경이 깨뜨리거나 일관성 없이 남기는 호출자를 이름 붙인다.
- 형제 경로를 본다. 다른 엔드포인트, 다른 명령, 다른 플랫폼, 다른 형식. 한쪽만 고치고 다른 쪽을 두면 발견 사항이다.
- 마이그레이션과 호환 경로를 본다. 오래된 행, 오래된 파일, 오래된 클라이언트, 진행 중인 작업.
- 변경이 틀리게 만드는 문서를 본다. readme, 도움말 문자열, 예제, 스키마 주석, 프로젝트가 관리하는 변경 기록.
- 설정과 환경을 본다. 새로 필요한 값, 새 권한, 새 포트, 새 파일 경로.
- 바뀌어야 하는데 바뀌지 않은 테스트를 본다.
판정: `consistent`, 또는 포인터가 붙은 빠진 목록.
## 7. Item 7: QA audit
리더의 매트릭스를 신뢰하지 않고 감사한다.
- 모든 행에 산출물이 있고, 적힌 경로에 그 산출물이 있다.
- 산출물이 행이 주장하는 것을 보여 준다. 상태를 보여 주지 않는 스크린샷, 주장한 줄이 없는 명령 출력은 감사를 통과하지 못한다.
- `N/A` 이유마다 이 목표와 이 변경을 지목한다. 일반적인 면제는 감사를 통과하지 못한다.
- 실행하지 못한 행은 `unproven`이고, 판정이 그것을 반영한다. 필수 `unproven` 행이 `passed` 아래에 있을 수 없다.
- 행의 정체성이 영수증의 정체성과 같다.
- 상태를 만든 행마다 정리가 일어났거나, 남은 것이 이름 붙었다.
- 행 집합이 위험 수준을 덮는다. 목표 행과 빌드 행만 있는 고위험 변경은 감사를 통과하지 못한다.
판정: `sound`, `thin`, `unreliable`, 실패한 행을 이름 붙인다.
## 8. Item 8: scope
변경이 있어야 할 것을 담고 그 밖의 것은 담지 않는다.
- 바뀐 경로를 목표와 건드린 영역에 견준다. 목표가 설명하지 않는 경로를 모두 이름 붙인다.
- 무관한 리팩터링, 포매팅 소음, 버전 올리기, 의존성 교체, 목적 없는 이름 변경, 지운 테스트는 범위 발견 사항이다.
- 시키지 않은 두 번째 버그를 고치는 변경은 그 수정이 옳아도 발견 사항이다. 목표에 견줘 리뷰되지 않았고 첫 변경과 함께 되돌려질 수 있다.
- 목표가 필요로 하는 파일이 빠진 것도 반대 방향의 범위 발견 사항이다. 마이그레이션, 테스트, export, 등록.
- 생성되어야 하는데 커밋된 파일, 커밋되어야 하는데 무시된 파일도 발견 사항이다.
판정: `tight`, 또는 더해진 경로와 빠진 경로 목록.
## 9. Item shape
항목 결과는 리뷰를 견줄 수 있게 같은 모양으로 쓴다.
```text
1. Goal: met | 목표 "..." | 산출물: qa-matrix 목표 행
2. Constraints: 3개 중 3개 held | ...
3. Behavior across states: 잘못된 형식에서 breaks | 산출물: ...
4. Code quality: minor | 냄새: buildInvoice 매개변수 5개(billing.ts:88)
5. Security: no new exposure | ...
6. Missed context: 일관됨. 단 docs/api.md:41 예제는 다름
7. QA audit: sound | 11행, 이유가 붙은 N/A 2개, unproven 0개
8. Scope: tight
```
판정 단어가 없는 항목은 답이 아니다. 판정은 있고 포인터가 없는 항목은 발견 사항이 아니라 단언이다.
## 10. Severity
발견 사항마다 심각도 하나를 붙이고, 나온 루브릭 항목을 함께 적는다.
| 심각도 | 뜻 | 판정에 미치는 영향 |
|---|---|---|
| 블로커 | 목표를 달성하지 못했거나, 제약이 깨졌거나, 보안 노출이 더해졌거나, 필수 상태가 깨졌거나, QA 증거를 신뢰할 수 없다 | 그것 하나로 `failed` |
| 고쳐야 함 | 실제지만 변경을 거절할 이유는 아니다. 임계값을 넘은 냄새, 빠진 문서, 얇은 테스트, 작은 불일치 | 발견 사항으로 적고 `passed` |
| 메모 | 작성자가 무시해도 되는 선호나 관찰 | `passed` |
정의되지 않았거나 일관되지 않은 심각도 단어는 `메모`로 읽는다. 알 수 없는 라벨이 몰래 판정을 올리거나 사라지면 안 된다.
## Sources
> Checked 2026-11-10.
| Claim | Source |
|---|---|
| 여덟 항목 루브릭 내용: 목표, 제약, 상태별 동작, 코드 품질, 보안, 놓친 맥락, QA 감사, 범위 | `dbc-hbin/omp-ulw@74df40f review-work` (메커니즘 참조, 다시 씀. 여덟 항목 묶음은 이 패키지 것) |
| 모든 주장에 산출물을 요구하고 코드 읽기를 증명으로 거부한다 | 같은 출처, 다시 씀 |
| 세 심각도와 판정에 미치는 영향 | 이 패키지가 고른 설계 |
### Evidence grade
루브릭 항목과 산출물 요구는 `MECHANISM`이다. 여덟 항목 묶음, 항목 줄 모양, 심각도 표는 `LOCAL`이다. 묶음은 측정된 것이 아니라, 원천 워크플로가 말하는 실패를 가장 작게 덮는 집합이다.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |