Communitygithub.com

AnthonyPoschen/agent-skills

소프트웨어 작업을 위한 진입점 역할을 하는 스킬입니다. 작업 유형에 따라 가장 관련성 높은 레퍼런스 문서를 로드합니다.

agent-skills란 무엇인가요?

이 스킬은 AI 에이전트가 소프트웨어 개발 작업을 체계적으로 수행할 수 있도록 설계된 진입점 역할을 합니다. 사용자의 요청(새 코드 작성, 리팩토링, 코드 리뷰, 디버깅, 아키텍처 설계 등)에 따라 가장 적합한 레퍼런스 문서(implementation, refactoring, review, debugging, design 등)를 로드하도록 라우팅합니다. 또한 일관된 코드 품질을 유지하기 위해 기준 규칙(Baseline Rules)을 제공하며, 정확성, 안전성, 사용자 의도를 최우선으로 하고, 프로젝트별 포맷터, 린터, 테스트 등의 로컬 패턴을 존중합니다. Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 사용할 수 있으며, 기존 SKILL.md 문서를 기반으로 작동합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add AnthonyPoschen/agent-skills

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Coding

이 스킬을 소프트웨어 작업의 진입점으로 사용하세요. 이 파일을 컨텍스트에 유지한 후, 작업에 가장 적합한 최소한의 레퍼런스 집합을 로드하세요.

라우팅

  • 새 코드를 작성하거나 동작을 확장하는 경우 ./references/implementation.md를 읽으세요.
  • 리팩토링, 정리, 단순화, 추출, 구조 변경 또는 재작업의 경우 ./references/refactoring.md를 읽으세요.
  • 코드 리뷰, PR 리뷰, diff 비평 또는 위험 평가의 경우 ./references/review.md를 읽으세요.
  • 디버깅, 실패하는 테스트, 회귀, 런타임 오류, CI 실패 또는 버그 수정의 경우 ./references/debugging.md를 읽으세요.
  • 아키텍처, API 설계, 모듈 경계, 의존성 방향 또는 설계 전용 논의의 경우 ./references/design.md를 읽으세요.
  • 공유 코드 품질 규칙은 코드를 작성하거나 변경할 때마다 ./references/standards.md를 읽고, 리뷰/설계 중 필요에 따라 참조하세요.
  • 단언(assertion) 전략(불변 조건 검사, 디버그 대 프로덕션 assert 결정, 실패 지향 계약)의 경우, 내부 가정을 검증하는 코드를 작성하거나 리뷰할 때 ./references/assertions.md를 읽으세요.

사용자의 현재 요청에 필요한 레퍼런스만 로드하세요. 작업에 여러 단계가 있는 경우, 해당 단계가 시작될 때 다음 레퍼런스를 로드하세요.

기준 규칙

  • 정확성, 안전성 및 사용자 의도가 스타일 선호도보다 우선합니다.
  • 프로젝트 포맷터, 린터, 테스트, 빌드 시스템, 프레임워크 규칙 및 시스템 차원의 로컬 패턴이 이 스킬의 기본 표준보다 우선합니다.
  • 로컬 패턴이 시스템적으로 간주되는 경우는 여러 인접 파일에 걸쳐 나타나거나, 도구에 의해 강제되거나, 명확한 프레임워크/애플리케이션 규칙의 일부인 경우입니다. 단순히 인접해 있다고 해서 일회성의 취약한 코드를 복사하지 마세요.
  • 시스템적인 프로젝트 패턴이 없는 경우 ./references/standards.md를 사용하세요.
  • 사용자가 명시적으로 변경을 요청하지 않는 한 공개 동작, API, 데이터 계약, 마이그레이션 및 운영 의미론을 유지하세요.
  • 편집 범위를 작업에 한정하세요. 터치하는 코드는 일관된 결과를 위해 충분히 개선하되, 관련 없는 레거시 코드는 정규화하지 마세요.

예제 조회

규칙 결정이 명확하지 않을 때만 예제를 사용하세요.

  • ./examples/README.md는 집중된 예제를 색인화합니다.
  • 한 번에 하나의 일치하는 예제 파일을 여세요.

관련 스킬