AgentSkillsCN

best-practices

应用各领域的最佳实践，采用经过验证的模式与方法论。

SKILL.md
--- frontmatter
name: best-practices
description: 기술별 베스트 프랙티스를 적용합니다. 검증된 패턴과 방법론을 사용합니다.
user-invocable: false
allowed-tools: [Read, Glob, Grep, mcp__tavily__tavily-search]
agent: calab-plugin:code-reviewer
agents:
  primary: calab-plugin:code-reviewer
  orchestration:
    analyze: [calab-plugin:code-reviewer, Explore]
    research: [calab-plugin:deep-researcher]
    apply: [calab-plugin:code-reviewer]
    validate: [calab-plugin:validator]
    fix: [calab-plugin:reinforcer]

Best Practices Skill

목적

각 기술에 대해 검증된 베스트 프랙티스와 디자인 패턴을 적용하여 일관되고 유지보수 가능한 코드를 생성합니다.

기술별 레퍼런스 파일

기술레퍼런스 파일
Pythonreferences/python/python.md
Goreferences/go/go.md
Rustreferences/rust/rust.md
Javareferences/java/java.md
Reactreferences/react/react.md
Next.jsreferences/nextjs/nextjs.md
Node.jsreferences/nodejs/nodejs.md
TypeScriptreferences/typescript/typescript.md
Tailwindreferences/tailwind/tailwind.md
Testingreferences/testing/testing.md
API Designreferences/api/api-design.md
Databasereferences/database/database.md

베스트 프랙티스 적용 프로토콜

2. 베스트 프랙티스 로드 (필수)

code
references/{language}/{technology}.md 읽기
→ 패턴, 규칙, 예시 코드 확인
→ 금지 사항 확인
→ 체크리스트 확인

3. 코드 생성 시 적용

  • •파일 구조: 해당 기술의 권장 구조 사용
  • •네이밍: 기술별 컨벤션 적용
  • •패턴: 검증된 디자인 패턴 사용
  • •에러 처리: 표준 에러 처리 패턴 적용
  • •테스트: 기술별 테스트 패턴 적용
  • •금지 사항: 각 파일의 "금지 사항" 섹션 반드시 준수

지원 기술 (12개)

기술파일주요 내용
Pythonpython.mdType Hints, Pydantic, FastAPI, pytest
Gogo.mdError Handling, Context, Concurrency
Rustrust.mdOwnership, Result/Option, thiserror, Axum
Javajava.mdHexagonal Architecture, Spring Boot, JPA
Reactreact.md컴포넌트 패턴, 훅, 상태 관리
Next.jsnextjs.mdApp Router, 서버 컴포넌트, 데이터 페칭
Node.jsnodejs.md레이어 아키텍처, 에러 처리, 로깅
TypeScripttypescript.md타입 패턴, 제네릭, 유틸리티 타입
Tailwind CSStailwind.md유틸리티 클래스, 반응형, CVA
Databasedatabase.md스키마 설계, 쿼리 최적화, 마이그레이션
API Designapi-design.mdREST/GraphQL, 버저닝, 에러 응답
Testingtesting.mdTDD, 단위/통합/E2E 테스트 패턴

출력 형식

코드 생성 전 확인 (Silent Mode)

사용자에게 매번 알림을 보내지 않고 자동 적용합니다. 단, 적용한 패턴을 코드 주석이나 응답 말미에 간략히 언급합니다.

code
// Applied: python.md (Type Hints, Pydantic)
// Applied: react.md + tailwind.md (Function Components, CVA)

코드 생성 체크리스트

코드 생성 시 다음을 확인:

  • • 해당 기술의 베스트 프랙티스 파일 로드 완료
  • • 해당 기술의 권장 디렉토리 구조 사용
  • • 파일당 500줄 이하
  • • 모든 함수에 주석 (JSDoc/Docstring)
  • • 해당 기술의 네이밍 컨벤션 적용
  • • 에러 처리 패턴 적용
  • • 타입 정의 완전성
  • • 금지 사항 미적용 확인

🚨 Anthropic 공식 가이드라인 (필수 적용)

출처: docs.anthropic.com, console.anthropic.com

코드 작업 전 필수 행동

code
1. 관련 파일 먼저 읽고 이해 (추측 금지)
2. 코드베이스의 스타일, 컨벤션, 추상화 파악
3. 충분한 컨텍스트 확보 후 답변/수정 제안

할루시네이션 방지 규칙

  • •열어보지 않은 파일 추측 금지
  • •사용자가 언급한 파일 반드시 먼저 읽기
  • •확실하지 않으면 "확인 필요" 인정
  • •근거 없는 주장 절대 금지

상세 가이드: references/common/anthropic-official.md

참조 파일

폴더 구조 (스킬 내부 - 언어별 분류)

code
skills/best-practices/references/
├── _sections.md    # 전체 섹션 정의
├── _template.md    # 새 규칙 템플릿
├── typescript/     # 27개 (통합 + 세부 규칙)
├── react/          # 44개 (통합 + 세부 규칙)
├── python/         # 20개 (통합 + 세부 규칙)
├── go/             # 21개 (통합 + 세부 규칙)
├── rust/           # 21개 (통합 + 세부 규칙)
└── common/         # 12개 (공통 가이드)

참조 예시 (스킬 내부 경로)

bash
# 전체 구조 확인
Read references/_sections.md

# 언어별 통합 가이드
Read references/typescript/typescript.md
Read references/react/react.md

# 기술별 인덱스
Read references/react/react-index.md
Read references/typescript/ts-index.md

# 세부 규칙
Read references/react/react-async-defer-await.md
Read references/typescript/ts-error-result-pattern.md

# 공통 가이드
Read references/common/api-design.md
Read references/common/security.md