addyosmani/agent-skills

해결하는 문제

AI 코딩 에이전트는 종종 시니어 개발자만큼 엄격한 엔지니어링 규율이 부족하여 테스트를 건너뛰거나, 성능을 무시하거나, 적절한 명세 없이 바로 코드 작성으로 넘어가는 경우가 많습니다. 이 프로젝트는 "skills"라고 불리는 구조화된 워크플로우 라이브러리를 제공하여, 에이전트가 전체 소프트웨어 개발 수명 주기에 걸쳐 프로덕션급 엔지니어링 모범 사례를 따르도록 강제합니다.

작동 방식

이 프로젝트는 AI 에이전트의 시스템 프롬프트 또는 명령어 세트 역할을 하는 24개의 Markdown 기반 스킬로 구성되어 있습니다. 각 스킬은 참조 문서가 아닌 프로세스로 설계되었으며, 다음과 같은 특징이 있습니다:

• 단계별 워크플로우: 체크포인트와 종료 기준이 있는 명확한 작업 시퀀스.
• 합리화 방지 테이블: 품질 단계를 건너뛰기 위해 에이전트가 하는 일반적인 변명(예: "나중에 테스트를 추가하겠습니다")에 대해 미리 정의된 반박.
• 검증 게이트: 작업이 완료된 것으로 간주되기 전에 증거(예: 테스트 통과 또는 런타임 데이터)에 대한 엄격한 요구 사항.
• 슬래시 명령어: 특정 수명 주기 단계에 매핑되는 미리 정의된 트리거(예: /spec, /plan, /build).

이러한 스킬은 CLI를 통해 또는 Markdown 파일을 에이전트의 구성에 추가하여 다양한 AI 에이전트(예: Claude Code, Cursor, Codex 및 Copilot)에 설치할 수 있습니다.

대상 독자

AI 생성 코드가 품질, 보안 및 유지 관리성에 대한 전문 표준을 충족하는지 확인하고자 하는 AI 코딩 에이전트를 사용하는 개발자.

주요 특징

• 포괄적인 수명 주기 커버리지: 초기 요구 사항 수집( /spec)부터 배포(/ship)까지 모든 것을 다루는 24개의 스킬이 포함되어 있습니다.
• 에이전트 페르소나: 코드 리뷰를 위한 시니어 스태프 엔지니어 및 취약점 감사를 위한 보안 엔지니어와 같은 전문가 페르소나가 포함되어 있습니다.
• 폭넓은 호환성: Claude Code, Cursor, Windsurf 및 GitHub Copilot을 포함한 다양한 AI 도구와 함께 작동합니다.
• 자율 모드: /build auto 명령을 사용하면 에이전트가 테스트 주도 검증을 유지하면서 자율적으로 작업을 계획하고 구현할 수 있습니다.