mirror of
https://github.com/affaan-m/everything-claude-code.git
synced 2026-04-18 16:13:29 +08:00
docs(ko-KR): complete all command translations with full examples
Add missing example sessions, code blocks, and detailed sections to 14 command files that were previously summarized versions.
This commit is contained in:
@@ -22,6 +22,7 @@ description: 관용적 패턴, 동시성 안전성, 에러 처리, 보안에 대
|
||||
- Go 변경사항을 커밋하기 전
|
||||
- Go 코드가 포함된 PR 리뷰 시
|
||||
- 새 Go 코드베이스에 온보딩할 때
|
||||
- 관용적 Go 패턴 학습 시
|
||||
|
||||
## 리뷰 카테고리
|
||||
|
||||
@@ -30,20 +31,118 @@ description: 관용적 패턴, 동시성 안전성, 에러 처리, 보안에 대
|
||||
- 동기화 없는 레이스 컨디션
|
||||
- 고루틴 누수
|
||||
- 하드코딩된 인증 정보
|
||||
- unsafe 포인터 사용
|
||||
- 핵심 경로에서 에러 무시
|
||||
|
||||
### HIGH (수정 권장)
|
||||
- 컨텍스트 없는 에러 래핑 누락
|
||||
- 에러 반환 대신 panic 사용
|
||||
- 컨텍스트 전파 누락
|
||||
- 데드락을 유발하는 버퍼 없는 채널
|
||||
- 인터페이스 미충족 에러
|
||||
- 뮤텍스 보호 누락
|
||||
|
||||
### MEDIUM (고려)
|
||||
- 비관용적 코드 패턴
|
||||
- 공개 항목에 godoc 주석 누락
|
||||
- 비효율적인 문자열 연결
|
||||
- 슬라이스 사전 할당 누락
|
||||
- 테이블 기반 테스트 미사용
|
||||
|
||||
## 관련 커맨드
|
||||
## 실행되는 자동 검사
|
||||
|
||||
- `/go-test` - 먼저 테스트 통과 확인
|
||||
- `/go-build` - build 에러 발생 시
|
||||
- `/code-review` - Go 외 일반적인 관심사항
|
||||
```bash
|
||||
# 정적 분석
|
||||
go vet ./...
|
||||
|
||||
# 고급 검사 (설치된 경우)
|
||||
staticcheck ./...
|
||||
golangci-lint run
|
||||
|
||||
# 레이스 감지
|
||||
go build -race ./...
|
||||
|
||||
# 보안 취약점
|
||||
govulncheck ./...
|
||||
```
|
||||
|
||||
## 사용 예시
|
||||
|
||||
```text
|
||||
User: /go-review
|
||||
|
||||
Agent:
|
||||
# Go 코드 리뷰 보고서
|
||||
|
||||
## 리뷰된 파일
|
||||
- internal/handler/user.go (수정됨)
|
||||
- internal/service/auth.go (수정됨)
|
||||
|
||||
## 정적 분석 결과
|
||||
✓ go vet: 이슈 없음
|
||||
✓ staticcheck: 이슈 없음
|
||||
|
||||
## 발견된 이슈
|
||||
|
||||
[CRITICAL] 레이스 컨디션
|
||||
파일: internal/service/auth.go:45
|
||||
이슈: 동기화 없이 공유 맵에 접근
|
||||
```go
|
||||
var cache = map[string]*Session{} // 동시 접근!
|
||||
|
||||
func GetSession(id string) *Session {
|
||||
return cache[id] // 레이스 컨디션
|
||||
}
|
||||
```
|
||||
수정: sync.RWMutex 또는 sync.Map 사용
|
||||
```go
|
||||
var (
|
||||
cache = map[string]*Session{}
|
||||
cacheMu sync.RWMutex
|
||||
)
|
||||
|
||||
func GetSession(id string) *Session {
|
||||
cacheMu.RLock()
|
||||
defer cacheMu.RUnlock()
|
||||
return cache[id]
|
||||
}
|
||||
```
|
||||
|
||||
[HIGH] 에러 컨텍스트 누락
|
||||
파일: internal/handler/user.go:28
|
||||
이슈: 컨텍스트 없이 에러 반환
|
||||
```go
|
||||
return err // 컨텍스트 없음
|
||||
```
|
||||
수정: 컨텍스트와 함께 래핑
|
||||
```go
|
||||
return fmt.Errorf("get user %s: %w", userID, err)
|
||||
```
|
||||
|
||||
## 요약
|
||||
- CRITICAL: 1
|
||||
- HIGH: 1
|
||||
- MEDIUM: 0
|
||||
|
||||
권장: ❌ CRITICAL 이슈가 수정될 때까지 merge 차단
|
||||
```
|
||||
|
||||
## 승인 기준
|
||||
|
||||
| 상태 | 조건 |
|
||||
|------|------|
|
||||
| ✅ 승인 | CRITICAL 또는 HIGH 이슈 없음 |
|
||||
| ⚠️ 경고 | MEDIUM 이슈만 있음 (주의하여 merge) |
|
||||
| ❌ 차단 | CRITICAL 또는 HIGH 이슈 발견 |
|
||||
|
||||
## 다른 커맨드와의 연동
|
||||
|
||||
- `/go-test`를 먼저 사용하여 테스트 통과 확인
|
||||
- `/go-build`를 사용하여 build 에러 발생 시 수정
|
||||
- `/go-review`를 커밋 전에 사용
|
||||
- `/code-review`를 사용하여 Go 외 일반적인 관심사항 리뷰
|
||||
|
||||
## 관련 항목
|
||||
|
||||
- 에이전트: `agents/go-reviewer.md`
|
||||
- 스킬: `skills/golang-patterns/`, `skills/golang-testing/`
|
||||
|
||||
Reference in New Issue
Block a user