[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M765ADMRWBC725RZ7JY4GTQF":3,"skill-same:01M765ADMRWBC725RZ7JY4GTQF":62},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":29,"ownerHtmlUrl":30,"ownerBlogUrl":31,"ownerDescription":32,"updatedAt":33,"install":34,"resources":47},"01M765ADMRWBC725RZ7JY4GTQF","review",null,"Review current changes or specified files - ruff lint for Python files, an adversarial review-code pass, and a security scan only when security-sensitive files changed.","hashgraph-online\u002Fawesome-codex-plugins","hashgraph-online","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F160371962?v=4","01M6CNB6NRJVNNGN14TR01Q6D3","HOL (Hashgraph Online)","01M6JT1HSKKG9V68KQAQGBA7XP",1575,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002FThis-HW\u002Fhiway-kit\u002Fskills\u002Freview\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: review\ndescription: Review current changes or specified files - ruff lint for Python files, an adversarial review-code pass, and a security scan only when security-sensitive files changed.\n---\n\n# 코드 리뷰 실행\n\n호출되면 바로 파이프라인을 시작한다. 단계가 바뀔 때 한 줄로 진행을 알린다.\n\n새 기능·비단순 수정은 `references\u002Fengineering-evidence.md`, 보이는 사용자 동작을 바꿨으면\n`references\u002Fvisual-qa.md`를 해당 단계에서 읽는다. 관련 없는 참조까지 상시 로드하지 않는다.\n\n## 파이프라인 구조\n\n```\n대상 확정 (0단계) → 정적 분석 ruff (0.2) → 복잡도 flag (0.5) → 입력 준비 (1) → 범위 판단 (1.5)\n  → review-code (2) → security-scan (3, 보안 관련 파일이 있을 때만) → 요약 (4)\n```\n\n---\n\n## 0단계: 리뷰 대상 확정 [가장 먼저]\n\n**대상이 정해지기 전에 정적 분석을 돌리지 않는다** — 대상 없이 도는 ruff 는 아무것도 검사하지 않고도\n\"통과\"로 보고된다.\n\n호출 인자(Claude Code 는 스킬 본문 끝에 `ARGUMENTS:` 줄로 붙인다)에 파일\u002F디렉토리가 있으면 그것이 대상이다. 없으면 git 변경분이 대상이다:\n\n```bash\n# 비교 기준: 작업 트리(스테이징 포함)에 변경이 있으면 HEAD, 없으면 마지막 커밋(HEAD~1)\nBASE=HEAD\n[ -z \"$(git diff HEAD --name-only)\" ] && BASE=HEAD~1\ngit diff \"$BASE\" --name-only --diff-filter=d     # 읽을 대상 (삭제된 파일 제외)\ngit diff \"$BASE\" --name-only --diff-filter=D     # 삭제된 파일 — 읽을 수 없으니 diff 로만 본다\n```\n\n`--diff-filter=d` 는 삭제된 파일을 목록에서 뺀다(없는 파일을 ruff·Read 에 넘기지 않기 위해).\n`2>\u002Fdev\u002Fnull` 로 stderr 를 숨기지 않는다 — git 오류(저장소 아님, `HEAD~1` 없음)가 \"대상 없음\"으로\n둔갑한다. 두 목록이 모두 비면 **\"리뷰 대상 없음\"을 출력하고 멈춘다**(통과가 아니다).\n\n**형식:**\n\n```\n## 0단계: 리뷰 대상\n- 기준: [인자 지정 | git diff HEAD | git diff HEAD~1 (작업 트리 변경 없음)]\n- 대상: [N]개 ([.py N개 …])  삭제: [N]개\n```\n\n---\n\n## 0.2단계: 정적 분석 (Python 파일 포함 시)\n\n**0단계 대상에 `.py` 파일이 있으면 그 목록으로 ruff check를 실행합니다.**\n\n```bash\n# 0단계 목록의 .py 만. ruff 종료코드를 그대로 읽는다 — xargs 로 이으면 1 이 123 으로 바뀐다.\n# 목록은 `sh -c` 로 넘긴다: 호스트의 쉘이 zsh 면 따옴표 없는 $PYS 가 단어 분리되지 않아\n# 줄바꿈 낀 한 인자가 되고, ruff 가 \"No such file\" 을 낸다(실측). 공백 낀 경로는 파일을 하나씩 넘긴다.\nPYS=$(git diff \"$BASE\" --name-only --diff-filter=d -- '*.py')   # 인자를 지정했으면 그 대상 중 .py\nif [ -z \"$PYS\" ]; then echo \"Python 파일 없음\"\nelif ! command -v ruff >\u002Fdev\u002Fnull; then echo \"스킵됨 (ruff 미설치)\"\nelse PYS=\"$PYS\" sh -c 'ruff check $PYS'; echo \"ruff rc=$?\"; fi\n```\n\n**결과 처리** (ruff 종료코드 그대로 판독한다: 0 통과 · 1 발견 · 2 ruff 자체 오류):\n\n- 1: 출력을 리뷰 컨텍스트에 포함하여 review-code 에이전트에 전달\n- 0: \"정적 분석: 통과\" 메시지만 출력\n- 2: \"ruff 오류 — 정적 분석 미수행\"과 stderr 를 그대로 보고한다(통과로 쓰지 않는다)\n- ruff가 설치되지 않은 경우: \"스킵됨 (ruff 미설치)\" 메시지 출력\n\n**형식:**\n\n```\n## 0.2단계: 정적 분석 (ruff)\n- 대상: [파일 목록 또는 \"없음 (Python 파일 없음)\"]\n- 결과: [통과 | N건 발견 | 오류(미수행) | 스킵(ruff 미설치)]\n- 발견된 이슈: [있을 때만 출력]\n```\n\n---\n\n## 0.5단계: 복잡도 flag — 하이브리드 (advisory 전용, Python 파일 포함 시)\n\n**결정론 flag → LLM 판단** 2단 하이브리드입니다. 복잡도 수치는 **리젝 사유가 아니라\n리뷰 초점 신호**입니다.\n\n```bash\n# mccabe 복잡도 flag (ruff 내장, 기본 임계 10)\nruff check --select C901 [0.2단계와 동일한 대상 파일]\n```\n\n**결과 처리:**\n\n- flag된 함수가 있으면: 목록을 review-code 에이전트 컨텍스트에 다음 지시와 함께 전달 —\n  > 아래 함수들은 복잡도 임계를 넘었다(결정론 flag). **줄수·복잡도 수치 자체를 리젝\n  > 사유로 삼지 말고**, 다음 관점으로만 분리 타당성을 판단하라: ① 모듈\u002F함수 경계가\n  > 단일 책임인가 ② IN\u002FOUT 계약(인자·반환·부수효과)이 명확히 분리 가능한가\n  > ③ 분리 시 계약이 단순해지는가(아니면 그대로가 응집적인가). 응집적이면 flag를\n  > 기각하고 그 근거를 명시하라.\n- flag 없으면: \"복잡도: 통과\" 한 줄만.\n- **절대 blocking 아님**: 이 단계는 어떤 경우에도 리뷰를 실패시키지 않는다\n  (전역 lint(E,F)·stop-validator와 무관 — advisory 전용).\n- ruff 미설치: \"스킵됨 (ruff 미설치)\" — fail-open.\n\n**형식:**\n\n```\n## 0.5단계: 복잡도 flag (advisory)\n- flag: [없음 | 함수 N건 (파일:라인, 복잡도)]\n- 처리: [review-code 판단 위임 | 통과]\n```\n\n---\n\n## 1단계: 리뷰 입력 준비\n\n0단계에서 확정한 대상의 **내용**을 모은다:\n\n- 호출 인자가 있으면: 해당 파일\u002F디렉토리를 읽는다\n- 호출 인자가 없으면: 0단계의 `BASE` 로 `git diff \"$BASE\"` 를 뽑는다(삭제된 파일은 이 diff 로만 보인다)\n\n---\n\n## 1.5단계: 자동 범위 판단 (Auto-Scope)\n\n**변경 파일을 분석하여 리뷰 범위를 자동으로 결정합니다.**\n\n### 수동 오버라이드 확인\n\n호출 인자에 `--quick`이 포함되어 있으면:\n\n- scope = 'quick' (사용자 명시 오버라이드)\n- security_scan_needed = false\n- \"수동으로 quick 모드가 지정되었습니다\" 메시지 출력\n- 1.5단계 나머지 스킵하고 2단계로 진행\n\n### 자동 범위 판단\n\n변경 파일 목록을 분석하여 scope를 자동 결정:\n\n#### 보안 관련 파일 감지\n\n다음 경로 패턴에 매칭되는 파일이 **1개라도 있으면**:\n\n- `**\u002Fauth\u002F**`, `**\u002Fsecurity\u002F**`, `**\u002Fpayment\u002F**`\n- `**\u002Fmiddleware\u002F**`, `**\u002F*secret*`, `**\u002F*token*`\n- `**\u002Fconfig.py`\n\n프로젝트에 보안 경로 규약이 따로 있으면(AGENTS.md·CLAUDE.md 등) 그 경로도 이 목록에 더한다 — 이\n스킬은 소비자 프로젝트에도 설치되므로 특정 레포의 디렉토리 이름을 박아 두지 않는다.\n\n→ **scope = 'adversarial', security_scan_needed = true**\n\n#### Trivial 파일 판정\n\n다음 파일 유형이 **전체의 80% 이상**이면:\n\n- `*.md`, `*.txt`, `docs\u002F**`\n- `*.json`, `*.yml`, `*.yaml` (예외: `settings.json`, `project.yaml`)\n\n→ **scope = 'quick', security_scan_needed = false**\n\n#### 기본 (일반 코드)\n\n위 두 조건에 해당하지 않으면(소스·스크립트·에이전트\u002F스킬 정의 등 모든 코드):\n\n→ **scope = 'adversarial', security_scan_needed = false**\n\n### 판정 결과 출력\n\n```\n🔍 Auto-Scope 판정 결과:\n- 변경 파일: [N]개\n- 보안 관련: [N]개\n- Trivial: [N]개\n- **Scope: [adversarial | quick]**\n- Security Scan: [필요 | 불필요]\n```\n\n---\n\n## 1.7단계: 사용자 의견 처리 원칙 (조건부)\n\n**트리거**: 호출 인자에 파일 경로·옵션(`--quick` 등)이 아닌 **자연어 문장이 포함된 경우**에만 실행.\n\n예시:\n- `\u002Freview src\u002Fauth.py 보안이 걱정돼` → **실행** (자연어 의견 포함)\n- `\u002Freview src\u002Fauth.py` → 실행 안 함 (경로만)\n- `\u002Freview --quick` → 실행 안 함 (옵션만)\n\n### 처리 절차\n\n```\n1. Restate  — 의견을 기술적으로 재술 (오해 없게)\n2. Verify   — Read\u002FGrep 도구만으로 해당 코드를 직접 확인 (이 단계에서는 읽기 전용 — Bash 실행 없이)\n3. Evaluate — 기술적 타당성 판단\n4. Respond  — 동의 or 근거 있는 반박을 review-code 프롬프트에 반영\n```\n\n### 금지\n\n- \"맞습니다!\" \u002F \"좋은 지적이에요!\" (검증 없는 동의)\n- Verify 없이 의견을 바로 리뷰 방향에 반영\n\n### 처리 예시\n\n```\n의견: \"이 함수는 성능 문제가 있을 것 같아\"\nVerify: [Read로 함수 확인 → 중첩 루프 발견]\nEvaluate: 타당함 — O(n²) 확인됨\n→ review-code 프롬프트에 포함: \"사용자 지적 — 성능 이슈 가능성, 검증됨\"\n\n의견: \"이 부분은 타입 체크가 없어\"\nVerify: [Grep으로 상위 검증 로직 확인 → strict mode 확인]\nEvaluate: 상위에서 처리됨 — 중복 불필요\n→ review-code 프롬프트에 반영 안 함. 사용자에게 이유 명시.\n```\n\n---\n\n## 위임 수단이 없는 하네스 — 강등 경로\n\n아래 `subagent_type:` 블록은 운송 수단일 뿐이고, 불변식은 블록의 `prompt:` 계약(검사 항목·출력\n형식·완료 선언)이다. 쓸 수 있는 수단을 호스트에 확인하고 위에서부터 한 칸씩 내려간다:\n**① 네이티브 서브에이전트**(블록 그대로) → **② 호스트의 다른 격리 위임 수단**(에이전트 정의\n본문 `\u003C플러그인 루트>\u002Fagents\u002F\u003C이름>.md` 를 **요약 없이** 넘기고 뒤에 `prompt:` 를\n붙인다 — 플러그인 루트 탐색은 `skills\u002Fplan-task\u002Freferences\u002Ftask-tools-fallback.md` §A. 회신 요약이 아니라 계약\n산출물로 판정한다) → **③ 이 세션에서 같은 계약을 직접 수행.** 수단이 없다고 단계를 건너뛰거나\n하지 않은 위임을 했다고 보고하지 않는다. ③은 격리가 없다 — 직접 수행한 리뷰는 강등된 리뷰이므로 리포트에 `## Scope Used: [adversarial | quick] (직접 수행 — 격리 없음)` 을 적고, `## 완료:` 종료 선언은 그대로 요구된다.\n\n## 2단계: 코드 리뷰 실행\n\n> **`review-code`에는 Bash가 없다** (`tools: Read\u002FGlob\u002FGrep`, `disallowedTools`에 Bash).\n> 따라서 프롬프트에 \"`git diff`로 확인하라\"고 **위임하면 안 된다** — 에이전트가 실행하지\n> 못하고 빈 리뷰를 반환한다(2026-08-23 실측). 1단계에서 **main이 diff를 뽑아 프롬프트에\n> 인라인으로 붙이거나**, diff가 크면 **읽을 파일 경로 목록**을 명시해서 넘겨라.\n> (`security-scan`은 Bash가 있으므로 이 제약이 없다 — 두 에이전트를 같은 방식으로\n> 호출하지 말 것.)\n>\n> 또한 **에이전트의 마지막 메시지가 곧 반환값**이다. \"리포트 형식 그대로, 서두 없이,\n> 마지막 메시지로 출력하라\"를 프롬프트에 명시하지 않으면 진행 상황 서술이 반환될 수 있다.\n>\n> **한 번에 넘기는 파일 수를 제한하라.** 두 에이전트 모두 `maxTurns` 가 유한하다. 읽을\n> 파일을 10여 개 한꺼번에 넘기면 읽기만으로 턴이 소진되고 **리포트 없이 종료**한다 —\n> 호출자에게는 빈 결과가 돌아오고, 그것은 \"결함 0건\"과 구별되지 않는다(2026-09-09\n> 실측: 저장소 규모 대상을 한 번에 넘겨 17회 도구 호출로 턴을 소진, 두 에이전트 모두\n> 빈 반환). **대상이 6개를 넘으면 배치로 쪼개 여러 번 호출하라.** 각 배치의 결과를\n> main이 모아서 4단계 요약을 만든다. 부분 리포트는 실패가 아니다 — **빈 반환이 실패다.**\n>\n> **그리고 리포트가 `## 완료:` 줄로 끝나지 않으면 잘린 것으로 취급하라.** *\"비었으면\n> 실패\"* 만으로는 부족하다 — **절단된 출력은 비어 있지 않으므로 그 검사를 통과한다.**\n> 의도한 부분 보고와 중간에 끊긴 출력을 가르는 것은 **선언**뿐이다. 잘린 것으로\n> 판정되면 그 배치를 더 작게 쪼개 다시 호출하라.\n\n\n```\nTask tool 사용:\nsubagent_type: review-code\nmodel: opus\nprompt: |\n  다음 코드를 리뷰해주세요:\n  [1단계에서 확인한 코드\u002Fdiff]\n\n  **정적 분석 결과 (0.2단계):**\n  [0.2단계 ruff check 결과 - 있으면 포함, 없으면 \"정적 분석 통과\" 또는 \"Python 파일 없음\"]\n\n  **Auto-Scope 설정:**\n  - scope: [1.5단계에서 결정된 scope]\n  - security_scan_needed: [1.5단계 결과]\n\n  scope가 'quick'이면:\n  - CRITICAL, HIGH 등급만 스캔\n  - MEDIUM, LOW는 필터링\n  - 예상 시간: 1-2분\n\n  scope가 'adversarial'이면:\n  - 4개 페르소나 전체 공격\n  - 모든 등급 보고\n  - 예상 시간: 3-5분\n\n  리포트는 review-code 정의의 출력 형식(## 판정 … ## 완료:)을 그대로 따른다.\n```\n\n---\n\n## 3단계: 보안 검토 (조건부)\n\n**1.5단계에서 security_scan_needed = true인 경우에만 실행**\n\n코드에 보안 관련 파일이 포함되면 security-scan을 실행:\n\n```\nTask tool 사용:\nsubagent_type: security-scan\nmodel: sonnet\nprompt: |\n  다음 코드의 보안 취약점을 검사해주세요:\n  [대상 코드]\n\n  검사 항목:\n  - OWASP Top 10 취약점\n  - 인증\u002F인가 로직\n  - 입력 검증\n  - SQL 인젝션\n  - XSS\n```\n\n**security_scan_needed = false인 경우**:\n\n- 이 단계를 스킵하고 4단계로 진행\n\n---\n\n## 4단계: 결과 요약\n\n리뷰 결과를 사용자에게 요약 보고\n\n`review-code` 가 내는 형식 그대로 옮긴다(자체 등급 체계를 새로 만들지 않는다 — 판정·등급 정의는\n`agents\u002Freview-code.md` 의 \"판정 기준\"이 소유한다):\n\n### 리뷰 결과\n\n| 항목      | 결과                                     |\n| --------- | ---------------------------------------- |\n| 판정      | [REJECT \u002F CONDITIONAL \u002F ACCEPT]          |\n| Scope     | [adversarial \u002F quick] (직접 수행이면 그렇게 표기) |\n| CRITICAL  | [N개]                                    |\n| HIGH      | [N개]                                    |\n| MEDIUM    | [N개] (quick 에서는 0)                   |\n| LOW       | [N개] (quick 에서는 0)                   |\n| 완료 선언 | [`## 완료: 전체` \u002F `부분` \u002F 없음(잘림)]  |\n| 보안 이슈 | [N개 \u002F 스캔 안 함]                       |\n\n### 수정 필요 사항\n\n[CRITICAL\u002FHIGH 항목 목록 — 필요하면 MEDIUM 까지]\n","# 코드 리뷰 실행\n\n호출되면 바로 파이프라인을 시작한다. 단계가 바뀔 때 한 줄로 진행을 알린다.\n\n새 기능·비단순 수정은 `references\u002Fengineering-evidence.md`, 보이는 사용자 동작을 바꿨으면\n`references\u002Fvisual-qa.md`를 해당 단계에서 읽는다. 관련 없는 참조까지 상시 로드하지 않는다.\n\n## 파이프라인 구조\n\n```\n대상 확정 (0단계) → 정적 분석 ruff (0.2) → 복잡도 flag (0.5) → 입력 준비 (1) → 범위 판단 (1.5)\n  → review-code (2) → security-scan (3, 보안 관련 파일이 있을 때만) → 요약 (4)\n```\n\n---\n\n## 0단계: 리뷰 대상 확정 [가장 먼저]\n\n**대상이 정해지기 전에 정적 분석을 돌리지 않는다** — 대상 없이 도는 ruff 는 아무것도 검사하지 않고도\n\"통과\"로 보고된다.\n\n호출 인자(Claude Code 는 스킬 본문 끝에 `ARGUMENTS:` 줄로 붙인다)에 파일\u002F디렉토리가 있으면 그것이 대상이다. 없으면 git 변경분이 대상이다:\n\n```bash\n# 비교 기준: 작업 트리(스테이징 포함)에 변경이 있으면 HEAD, 없으면 마지막 커밋(HEAD~1)\nBASE=HEAD\n[ -z \"$(git diff HEAD --name-only)\" ] && BASE=HEAD~1\ngit diff \"$BASE\" --name-only --diff-filter=d     # 읽을 대상 (삭제된 파일 제외)\ngit diff \"$BASE\" --name-only --diff-filter=D     # 삭제된 파일 — 읽을 수 없으니 diff 로만 본다\n```\n\n`--diff-filter=d` 는 삭제된 파일을 목록에서 뺀다(없는 파일을 ruff·Read 에 넘기지 않기 위해).\n`2>\u002Fdev\u002Fnull` 로 stderr 를 숨기지 않는다 — git 오류(저장소 아님, `HEAD~1` 없음)가 \"대상 없음\"으로\n둔갑한다. 두 목록이 모두 비면 **\"리뷰 대상 없음\"을 출력하고 멈춘다**(통과가 아니다).\n\n**형식:**\n\n```\n## 0단계: 리뷰 대상\n- 기준: [인자 지정 | git diff HEAD | git diff HEAD~1 (작업 트리 변경 없음)]\n- 대상: [N]개 ([.py N개 …])  삭제: [N]개\n```\n\n---\n\n## 0.2단계: 정적 분석 (Python 파일 포함 시)\n\n**0단계 대상에 `.py` 파일이 있으면 그 목록으로 ruff check를 실행합니다.**\n\n```bash\n# 0단계 목록의 .py 만. ruff 종료코드를 그대로 읽는다 — xargs 로 이으면 1 이 123 으로 바뀐다.\n# 목록은 `sh -c` 로 넘긴다: 호스트의 쉘이 zsh 면 따옴표 없는 $PYS 가 단어 분리되지 않아\n# 줄바꿈 낀 한 인자가 되고, ruff 가 \"No such file\" 을 낸다(실측). 공백 낀 경로는 파일을 하나씩 넘긴다.\nPYS=$(git diff \"$BASE\" --name-only --diff-filter=d -- '*.py')   # 인자를 지정했으면 그 대상 중 .py\nif [ -z \"$PYS\" ]; then echo \"Python 파일 없음\"\nelif ! command -v ruff >\u002Fdev\u002Fnull; then echo \"스킵됨 (ruff 미설치)\"\nelse PYS=\"$PYS\" sh -c 'ruff check $PYS'; echo \"ruff rc=$?\"; fi\n```\n\n**결과 처리** (ruff 종료코드 그대로 판독한다: 0 통과 · 1 발견 · 2 ruff 자체 오류):\n\n- 1: 출력을 리뷰 컨텍스트에 포함하여 review-code 에이전트에 전달\n- 0: \"정적 분석: 통과\" 메시지만 출력\n- 2: \"ruff 오류 — 정적 분석 미수행\"과 stderr 를 그대로 보고한다(통과로 쓰지 않는다)\n- ruff가 설치되지 않은 경우: \"스킵됨 (ruff 미설치)\" 메시지 출력\n\n**형식:**\n\n```\n## 0.2단계: 정적 분석 (ruff)\n- 대상: [파일 목록 또는 \"없음 (Python 파일 없음)\"]\n- 결과: [통과 | N건 발견 | 오류(미수행) | 스킵(ruff 미설치)]\n- 발견된 이슈: [있을 때만 출력]\n```\n\n---\n\n## 0.5단계: 복잡도 flag — 하이브리드 (advisory 전용, Python 파일 포함 시)\n\n**결정론 flag → LLM 판단** 2단 하이브리드입니다. 복잡도 수치는 **리젝 사유가 아니라\n리뷰 초점 신호**입니다.\n\n```bash\n# mccabe 복잡도 flag (ruff 내장, 기본 임계 10)\nruff check --select C901 [0.2단계와 동일한 대상 파일]\n```\n\n**결과 처리:**\n\n- flag된 함수가 있으면: 목록을 review-code 에이전트 컨텍스트에 다음 지시와 함께 전달 —\n  > 아래 함수들은 복잡도 임계를 넘었다(결정론 flag). **줄수·복잡도 수치 자체를 리젝\n  > 사유로 삼지 말고**, 다음 관점으로만 분리 타당성을 판단하라: ① 모듈\u002F함수 경계가\n  > 단일 책임인가 ② IN\u002FOUT 계약(인자·반환·부수효과)이 명확히 분리 가능한가\n  > ③ 분리 시 계약이 단순해지는가(아니면 그대로가 응집적인가). 응집적이면 flag를\n  > 기각하고 그 근거를 명시하라.\n- flag 없으면: \"복잡도: 통과\" 한 줄만.\n- **절대 blocking 아님**: 이 단계는 어떤 경우에도 리뷰를 실패시키지 않는다\n  (전역 lint(E,F)·stop-validator와 무관 — advisory 전용).\n- ruff 미설치: \"스킵됨 (ruff 미설치)\" — fail-open.\n\n**형식:**\n\n```\n## 0.5단계: 복잡도 flag (advisory)\n- flag: [없음 | 함수 N건 (파일:라인, 복잡도)]\n- 처리: [review-code 판단 위임 | 통과]\n```\n\n---\n\n## 1단계: 리뷰 입력 준비\n\n0단계에서 확정한 대상의 **내용**을 모은다:\n\n- 호출 인자가 있으면: 해당 파일\u002F디렉토리를 읽는다\n- 호출 인자가 없으면: 0단계의 `BASE` 로 `git diff \"$BASE\"` 를 뽑는다(삭제된 파일은 이 diff 로만 보인다)\n\n---\n\n## 1.5단계: 자동 범위 판단 (Auto-Scope)\n\n**변경 파일을 분석하여 리뷰 범위를 자동으로 결정합니다.**\n\n### 수동 오버라이드 확인\n\n호출 인자에 `--quick`이 포함되어 있으면:\n\n- scope = 'quick' (사용자 명시 오버라이드)\n- security_scan_needed = false\n- \"수동으로 quick 모드가 지정되었습니다\" 메시지 출력\n- 1.5단계 나머지 스킵하고 2단계로 진행\n\n### 자동 범위 판단\n\n변경 파일 목록을 분석하여 scope를 자동 결정:\n\n#### 보안 관련 파일 감지\n\n다음 경로 패턴에 매칭되는 파일이 **1개라도 있으면**:\n\n- `**\u002Fauth\u002F**`, `**\u002Fsecurity\u002F**`, `**\u002Fpayment\u002F**`\n- `**\u002Fmiddleware\u002F**`, `**\u002F*secret*`, `**\u002F*token*`\n- `**\u002Fconfig.py`\n\n프로젝트에 보안 경로 규약이 따로 있으면(AGENTS.md·CLAUDE.md 등) 그 경로도 이 목록에 더한다 — 이\n스킬은 소비자 프로젝트에도 설치되므로 특정 레포의 디렉토리 이름을 박아 두지 않는다.\n\n→ **scope = 'adversarial', security_scan_needed = true**\n\n#### Trivial 파일 판정\n\n다음 파일 유형이 **전체의 80% 이상**이면:\n\n- `*.md`, `*.txt`, `docs\u002F**`\n- `*.json`, `*.yml`, `*.yaml` (예외: `settings.json`, `project.yaml`)\n\n→ **scope = 'quick', security_scan_needed = false**\n\n#### 기본 (일반 코드)\n\n위 두 조건에 해당하지 않으면(소스·스크립트·에이전트\u002F스킬 정의 등 모든 코드):\n\n→ **scope = 'adversarial', security_scan_needed = false**\n\n### 판정 결과 출력\n\n```\n🔍 Auto-Scope 판정 결과:\n- 변경 파일: [N]개\n- 보안 관련: [N]개\n- Trivial: [N]개\n- **Scope: [adversarial | quick]**\n- Security Scan: [필요 | 불필요]\n```\n\n---\n\n## 1.7단계: 사용자 의견 처리 원칙 (조건부)\n\n**트리거**: 호출 인자에 파일 경로·옵션(`--quick` 등)이 아닌 **자연어 문장이 포함된 경우**에만 실행.\n\n예시:\n- `\u002Freview src\u002Fauth.py 보안이 걱정돼` → **실행** (자연어 의견 포함)\n- `\u002Freview src\u002Fauth.py` → 실행 안 함 (경로만)\n- `\u002Freview --quick` → 실행 안 함 (옵션만)\n\n### 처리 절차\n\n```\n1. Restate  — 의견을 기술적으로 재술 (오해 없게)\n2. Verify   — Read\u002FGrep 도구만으로 해당 코드를 직접 확인 (이 단계에서는 읽기 전용 — Bash 실행 없이)\n3. Evaluate — 기술적 타당성 판단\n4. Respond  — 동의 or 근거 있는 반박을 review-code 프롬프트에 반영\n```\n\n### 금지\n\n- \"맞습니다!\" \u002F \"좋은 지적이에요!\" (검증 없는 동의)\n- Verify 없이 의견을 바로 리뷰 방향에 반영\n\n### 처리 예시\n\n```\n의견: \"이 함수는 성능 문제가 있을 것 같아\"\nVerify: [Read로 함수 확인 → 중첩 루프 발견]\nEvaluate: 타당함 — O(n²) 확인됨\n→ review-code 프롬프트에 포함: \"사용자 지적 — 성능 이슈 가능성, 검증됨\"\n\n의견: \"이 부분은 타입 체크가 없어\"\nVerify: [Grep으로 상위 검증 로직 확인 → strict mode 확인]\nEvaluate: 상위에서 처리됨 — 중복 불필요\n→ review-code 프롬프트에 반영 안 함. 사용자에게 이유 명시.\n```\n\n---\n\n## 위임 수단이 없는 하네스 — 강등 경로\n\n아래 `subagent_type:` 블록은 운송 수단일 뿐이고, 불변식은 블록의 `prompt:` 계약(검사 항목·출력\n형식·완료 선언)이다. 쓸 수 있는 수단을 호스트에 확인하고 위에서부터 한 칸씩 내려간다:\n**① 네이티브 서브에이전트**(블록 그대로) → **② 호스트의 다른 격리 위임 수단**(에이전트 정의\n본문 `\u003C플러그인 루트>\u002Fagents\u002F\u003C이름>.md` 를 **요약 없이** 넘기고 뒤에 `prompt:` 를\n붙인다 — 플러그인 루트 탐색은 `skills\u002Fplan-task\u002Freferences\u002Ftask-tools-fallback.md` §A. 회신 요약이 아니라 계약\n산출물로 판정한다) → **③ 이 세션에서 같은 계약을 직접 수행.** 수단이 없다고 단계를 건너뛰거나\n하지 않은 위임을 했다고 보고하지 않는다. ③은 격리가 없다 — 직접 수행한 리뷰는 강등된 리뷰이므로 리포트에 `## Scope Used: [adversarial | quick] (직접 수행 — 격리 없음)` 을 적고, `## 완료:` 종료 선언은 그대로 요구된다.\n\n## 2단계: 코드 리뷰 실행\n\n> **`review-code`에는 Bash가 없다** (`tools: Read\u002FGlob\u002FGrep`, `disallowedTools`에 Bash).\n> 따라서 프롬프트에 \"`git diff`로 확인하라\"고 **위임하면 안 된다** — 에이전트가 실행하지\n> 못하고 빈 리뷰를 반환한다(2026-08-23 실측). 1단계에서 **main이 diff를 뽑아 프롬프트에\n> 인라인으로 붙이거나**, diff가 크면 **읽을 파일 경로 목록**을 명시해서 넘겨라.\n> (`security-scan`은 Bash가 있으므로 이 제약이 없다 — 두 에이전트를 같은 방식으로\n> 호출하지 말 것.)\n>\n> 또한 **에이전트의 마지막 메시지가 곧 반환값**이다. \"리포트 형식 그대로, 서두 없이,\n> 마지막 메시지로 출력하라\"를 프롬프트에 명시하지 않으면 진행 상황 서술이 반환될 수 있다.\n>\n> **한 번에 넘기는 파일 수를 제한하라.** 두 에이전트 모두 `maxTurns` 가 유한하다. 읽을\n> 파일을 10여 개 한꺼번에 넘기면 읽기만으로 턴이 소진되고 **리포트 없이 종료**한다 —\n> 호출자에게는 빈 결과가 돌아오고, 그것은 \"결함 0건\"과 구별되지 않는다(2026-09-09\n> 실측: 저장소 규모 대상을 한 번에 넘겨 17회 도구 호출로 턴을 소진, 두 에이전트 모두\n> 빈 반환). **대상이 6개를 넘으면 배치로 쪼개 여러 번 호출하라.** 각 배치의 결과를\n> main이 모아서 4단계 요약을 만든다. 부분 리포트는 실패가 아니다 — **빈 반환이 실패다.**\n>\n> **그리고 리포트가 `## 완료:` 줄로 끝나지 않으면 잘린 것으로 취급하라.** *\"비었으면\n> 실패\"* 만으로는 부족하다 — **절단된 출력은 비어 있지 않으므로 그 검사를 통과한다.**\n> 의도한 부분 보고와 중간에 끊긴 출력을 가르는 것은 **선언**뿐이다. 잘린 것으로\n> 판정되면 그 배치를 더 작게 쪼개 다시 호출하라.\n\n\n```\nTask tool 사용:\nsubagent_type: review-code\nmodel: opus\nprompt: |\n  다음 코드를 리뷰해주세요:\n  [1단계에서 확인한 코드\u002Fdiff]\n\n  **정적 분석 결과 (0.2단계):**\n  [0.2단계 ruff check 결과 - 있으면 포함, 없으면 \"정적 분석 통과\" 또는 \"Python 파일 없음\"]\n\n  **Auto-Scope 설정:**\n  - scope: [1.5단계에서 결정된 scope]\n  - security_scan_needed: [1.5단계 결과]\n\n  scope가 'quick'이면:\n  - CRITICAL, HIGH 등급만 스캔\n  - MEDIUM, LOW는 필터링\n  - 예상 시간: 1-2분\n\n  scope가 'adversarial'이면:\n  - 4개 페르소나 전체 공격\n  - 모든 등급 보고\n  - 예상 시간: 3-5분\n\n  리포트는 review-code 정의의 출력 형식(## 판정 … ## 완료:)을 그대로 따른다.\n```\n\n---\n\n## 3단계: 보안 검토 (조건부)\n\n**1.5단계에서 security_scan_needed = true인 경우에만 실행**\n\n코드에 보안 관련 파일이 포함되면 security-scan을 실행:\n\n```\nTask tool 사용:\nsubagent_type: security-scan\nmodel: sonnet\nprompt: |\n  다음 코드의 보안 취약점을 검사해주세요:\n  [대상 코드]\n\n  검사 항목:\n  - OWASP Top 10 취약점\n  - 인증\u002F인가 로직\n  - 입력 검증\n  - SQL 인젝션\n  - XSS\n```\n\n**security_scan_needed = false인 경우**:\n\n- 이 단계를 스킵하고 4단계로 진행\n\n---\n\n## 4단계: 결과 요약\n\n리뷰 결과를 사용자에게 요약 보고\n\n`review-code` 가 내는 형식 그대로 옮긴다(자체 등급 체계를 새로 만들지 않는다 — 판정·등급 정의는\n`agents\u002Freview-code.md` 의 \"판정 기준\"이 소유한다):\n\n### 리뷰 결과\n\n| 항목      | 결과                                     |\n| --------- | ---------------------------------------- |\n| 판정      | [REJECT \u002F CONDITIONAL \u002F ACCEPT]          |\n| Scope     | [adversarial \u002F quick] (직접 수행이면 그렇게 표기) |\n| CRITICAL  | [N개]                                    |\n| HIGH      | [N개]                                    |\n| MEDIUM    | [N개] (quick 에서는 0)                   |\n| LOW       | [N개] (quick 에서는 0)                   |\n| 완료 선언 | [`## 완료: 전체` \u002F `부분` \u002F 없음(잘림)]  |\n| 보안 이슈 | [N개 \u002F 스캔 안 함]                       |\n\n### 수정 필요 사항\n\n[CRITICAL\u002FHIGH 항목 목록 — 필요하면 MEDIUM 까지]\n",{"name":5,"description":7},"main","40706766fd37c03ca624f5206741fef55dd2a684","plugins\u002FThis-HW\u002Fhiway-kit\u002Fskills\u002Freview",491,"https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins","https:\u002F\u002Fhol.org\u002Fplugins\u002Fbest-codex-plugins","https:\u002F\u002Fgithub.com\u002Fhashgraph-online","https:\u002F\u002Fhol.org","Open-source standards and developer tools for interoperable AI agents: discovery, identity, communication, payments, privacy and security.","2026-11-14 14:06:13",{"source":8,"skillName":5,"commands":35,"prompt":45,"zipAvailable":46},[36,39,42],{"tool":37,"command":38},"npx","npx skills add hashgraph-online\u002Fawesome-codex-plugins --skill review",{"tool":40,"command":41},"bunx","bunx skills add hashgraph-online\u002Fawesome-codex-plugins --skill review",{"tool":43,"command":44},"pnpm","pnpm dlx skills add hashgraph-online\u002Fawesome-codex-plugins --skill review","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002FThis-HW\u002Fhiway-kit\u002Fskills\u002Freview\u002FSKILL.md",true,[48,54,58],{"path":49,"resourceType":50,"resourceTypeDesc":51,"sizeBytes":52,"sourceHtmlUrl":53},"agents\u002Fopenai.yaml","REFERENCE","参考文档",409,"https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002FThis-HW\u002Fhiway-kit\u002Fskills\u002Freview\u002Fagents\u002Fopenai.yaml",{"path":55,"resourceType":50,"resourceTypeDesc":51,"sizeBytes":56,"sourceHtmlUrl":57},"references\u002Fengineering-evidence.md",2247,"https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002FThis-HW\u002Fhiway-kit\u002Fskills\u002Freview\u002Freferences\u002Fengineering-evidence.md",{"path":59,"resourceType":50,"resourceTypeDesc":51,"sizeBytes":60,"sourceHtmlUrl":61},"references\u002Fvisual-qa.md",1296,"https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002FThis-HW\u002Fhiway-kit\u002Fskills\u002Freview\u002Freferences\u002Fvisual-qa.md",[63,73,81,89,97,105],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":67,"licenseFileUrl":68,"sourceHtmlUrl":69,"categories":70,"keywords":71,"publishedAt":72},"01M7DV332YQMGD8WTRJ9DZQXTB","worktable-review-with-annotations","Create, inspect, reply to, update, or resolve situated Worktable annotations. Use when feedback belongs to a Doc section, block, text range, or HTML Doc, or when the user asks to address existing review feedback and coordinate a requested artifact edit.","MIT","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-review-with-annotations\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-review-with-annotations\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":67,"licenseFileUrl":77,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":72},"01M7DV2YGHCZVBEB1AHYB6CGHE","worktable-find-and-synthesize-context","Find, assess, and synthesize context from Worktable Docs and Records. Use when the user asks what a workspace contains, wants workspace-backed research, needs current facts reconciled across artifacts, or requests a cited synthesis without changing workspace state.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-find-and-synthesize-context\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-find-and-synthesize-context\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":67,"licenseFileUrl":85,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":72},"01M7DV2TQN1H11ME2SAF9MXN7V","worktable-create-or-update-docs","Create, edit, rename, or maintain narrative Worktable Docs. Use for plans, decisions, briefs, notes, research syntheses, and other durable prose when the user requests a new artifact or a safe update to an existing one.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-update-docs\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-update-docs\u002FSKILL.md",[],[],{"skillNo":90,"name":91,"nameZh":6,"description":92,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":67,"licenseFileUrl":93,"sourceHtmlUrl":94,"categories":95,"keywords":96,"publishedAt":72},"01M7DV2NE452NEA8TXATKSNAJH","worktable-create-or-manage-records","Organize repeated structured information as durable Worktable Records. Use for research datasets, inventories, directories, pipelines, trackers, and other collections whose items need identity, fields, filtering, links, validation, or individual updates.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-records\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-records\u002FSKILL.md",[],[],{"skillNo":98,"name":99,"nameZh":6,"description":100,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":67,"licenseFileUrl":101,"sourceHtmlUrl":102,"categories":103,"keywords":104,"publishedAt":72},"01M7DV2HENRBR2KSCVM064WH0Y","worktable-create-or-manage-interactive-html","Create or improve durable visual and interactive artifacts in Worktable. Use for dashboards, trackers, calculators, mini apps, slide presentations, and other requests that benefit from a polished HTML Doc.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-interactive-html\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-interactive-html\u002FSKILL.md",[],[],{"skillNo":106,"name":107,"nameZh":6,"description":108,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":67,"licenseFileUrl":109,"sourceHtmlUrl":110,"categories":111,"keywords":112,"publishedAt":72},"01M7DV2CADR5R7RQFFYPNAGR9Y","worktable-collaborate-threads","Read, answer, and hand off messages through durable Worktable threads with users or other authenticated participants. Use when the user asks to check addressed messages, reply to a participant, continue a thread, request another agent's help, wait briefly for a response, or watch for comments and messages sent to the agent.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-collaborate-threads\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-collaborate-threads\u002FSKILL.md",[],[]]