From b8cf1b2e91830e043aadb7a496f1d4e79c797d62 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Thu, 12 Nov 2026 02:37:18 +0900 Subject: [PATCH] =?UTF-8?q?docs(redteam):=20=EC=88=98=EC=A0=95=20=EC=BB=A4?= =?UTF-8?q?=EB=B0=8B=20=EC=A0=84=20=ED=8F=AC=EB=A7=B7=20=EA=B2=8C=EC=9D=B4?= =?UTF-8?q?=ED=8A=B8=20=EB=8B=A8=EA=B3=84=EB=A5=BC=20=EB=8D=94=ED=95=9C?= =?UTF-8?q?=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit red team 수정 절차에 "커밋 전 바뀐 파일에 대상 repo 포맷터를 돌린다" 단계가 없었다. 그래서 백엔드 템플릿 수정 PR에서 모듈 시험만 돌리고 push했다가 runner pr / gradle의 :app-bootstrap:spotlessJavaCheck에서 깨졌다. 같은 실수가 반복되지 않게 절차에 못 박는다. skills/redteam SKILL.md §6(고침과 재실행)과 CAMPAIGN.md §4(발견 처리)에 각각 한 줄을 더한다: 자바 템플릿은 ./gradlew spotlessApply 뒤 spotlessCheck. 스킬 지시가 바뀌므로 plugin.json version 0.1.0 → 0.1.1 (받는 쪽은 버전이 바뀌어야 갱신된다). 위험·한계: 문서·버전만 바뀐다. 훅·스크립트 동작 변화 없음. 검증: scripts/check.sh 통과(harness·redteam·template 시험, manifest validate). --- plugins/redteam/.claude-plugin/plugin.json | 2 +- plugins/redteam/CAMPAIGN.md | 3 ++- plugins/redteam/skills/redteam/SKILL.md | 1 + 3 files changed, 4 insertions(+), 2 deletions(-) diff --git a/plugins/redteam/.claude-plugin/plugin.json b/plugins/redteam/.claude-plugin/plugin.json index 90aa9bb..6a66edf 100644 --- a/plugins/redteam/.claude-plugin/plugin.json +++ b/plugins/redteam/.claude-plugin/plugin.json @@ -1,7 +1,7 @@ { "name": "redteam", "displayName": "Red Team", - "version": "0.1.0", + "version": "0.1.1", "description": "두 템플릿을 공격하는 red team 장치: 역할별 서브에이전트(정찰·인증/인가·입력·의존성·설정·프론트), 발동 스킬, 핀 고정 오픈소스 도구 실행 래퍼와 발견 수집 도구. 훅은 두지 않는다(요청할 때만 돈다).", "author": { "name": "donghyeon.kang" diff --git a/plugins/redteam/CAMPAIGN.md b/plugins/redteam/CAMPAIGN.md index 8ffabfe..4dee19d 100644 --- a/plugins/redteam/CAMPAIGN.md +++ b/plugins/redteam/CAMPAIGN.md @@ -28,7 +28,8 @@ 1. **근본 원인**을 적는다. 2. **전 코드에서 같은 모양**을 찾는다(한 곳의 버그는 보통 한 부류다). 3. **막는 시험**: 재현(RED) → 고침 → 통과(GREEN). 재분류(오탐·by-design)면 근거를 적고 의도를 시험/주석으로 고정한다. -4. 보고서는 각 템플릿 `docs/reviews/<날짜>-redteam-*.md`에. +4. **커밋 전 포맷 게이트**: 바뀐 파일에 대상 repo의 포맷터를 돌린다(자바 템플릿은 `./gradlew spotlessApply` → `spotlessCheck`). 시험만 돌리고 포맷 검사를 건너뛰면 CI `pr / gradle`(spotlessCheck)에서 깨진다. +5. 보고서는 각 템플릿 `docs/reviews/<날짜>-redteam-*.md`에. ## 5. 재실행 — 두 회차 연속 0 회차마다 **무엇을 새로 봤는지** 적는다(새 capability·새 벡터·수정 뒤 재공격). red team 장치를 다시 돌려 고친 발견이 다시 안 나옴을 보이고, **두 회차 연속 새 발견이 0일 때** 끝. diff --git a/plugins/redteam/skills/redteam/SKILL.md b/plugins/redteam/skills/redteam/SKILL.md index 07e56b9..043027b 100644 --- a/plugins/redteam/skills/redteam/SKILL.md +++ b/plugins/redteam/skills/redteam/SKILL.md @@ -66,6 +66,7 @@ python3 "${CLAUDE_PLUGIN_ROOT}/scripts/finding.py" summary findings.jsonl # o ## 6. 고침과 재실행 - 발견마다 **막는 시험**을 더한다: 재현(RED) → 고침 → 통과(GREEN). 템플릿 게이트 rc=0. +- **커밋 전 포맷 게이트:** 바뀐 파일에 대상 repo의 포맷터를 돌린다(자바 템플릿은 `./gradlew spotlessApply` 뒤 `spotlessCheck`). 모듈 시험만 돌리고 포맷 게이트를 건너뛰면 runner `pr / gradle`의 spotlessCheck에서 깨진다. - 고치지 않는 것은 근거를 적고 `status: accepted|wontfix`로 소유자 결정 칸에. - 끝에 red team 장치를 **다시 돌려** open 발견이 다시 나오지 않음을 보인다(회귀 0).