Community연구 & 데이터 분석github.com

yaolifeng0629/ylf-agent-skills

YLF 에이전트 스킬: 규율 있는 코딩 작업과 지속적인 프로젝트 지침을 위한 스킬입니다.

ylf-agent-skills란 무엇인가요?

이 스킬은 AI 코딩 에이전트(Claude Code, Cursor, Codex 등)가 프로젝트 작업을 수행할 때 일관된 워크플로우를 유지하도록 돕는 범용 가이드입니다. 작업의 명확한 완료 조건 정의, 프로젝트 컨텍스트에 적응하는 방법, 최소한의 변경 사항 적용, 실제 검증 수행, 안전 경계 유지 등 7가지 핵심 프로세스를 제공합니다. 모든 규칙은 프로젝트별 지침(예: AGENTS.md, CLAUDE.md)을 존중하며, 해당 지침이 없을 때만 보완합니다. 이 스킬은 작업 단위로 사용하거나 `ylf-project-instructions`를 통해 프로젝트에 영구적으로 적용할 수 있습니다.

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

Installed? Explore more 연구 & 데이터 분석 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

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

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

문서

YLF 코딩 표준

현재 작업에만 사용하세요. 이 표준을 프로젝트에 영구적으로 적용하려면 ylf-project-instructions를 사용하세요.

이 스킬은 의도적으로 짧습니다. 모든 프로젝트 규칙을 이 파일에 담지 말고, 현재 프로젝트를 읽어 적응하세요.

프로세스

  1. 완료 조건 정의

    • 구체적인 결과물과 이를 어떻게 확인할지 명시하세요.
    • 중요한 작업의 경우 간단한 체크리스트를 유지하고 진행하면서 업데이트하세요.
    • 완료는 요청된 결과가 작동하고, 가능한 경우 검증되었으며, 명확히 보고되었음을 의미합니다.
  2. 프로젝트에 적응

    • 먼저 활성 프로젝트 지침을 읽으세요: AGENTS.md, CLAUDE.md, README 파일, 패키지 스크립트, 테스트 설정, 주변 코드.
    • 프로젝트 규칙이 이 스킬을 재정의합니다. 이 스킬은 작업 방식을 보완합니다.
    • 기존 패턴, 의존성, 명명 규칙, 파일 레이아웃, 검증 명령어를 따르세요.
    • 일반적인 해결책인 경우, 커스텀 구현보다는 성숙한 프로젝트 의존성이나 잘 관리되는 오픈소스 패키지를 선호하세요.
  3. 중요한 경우에만 명확히 하기

    • 작업이 명확하고 위험이 낮다면 진행하세요.
    • 높은 영향을 미치는 선택(아키텍처, 데이터 구조, 외부 서비스, 파괴적인 작업, 광범위한 리팩터링, 모호한 범위) 전에는 멈추고 질문하세요.
    • 질문할 때는 권장 답변과 트레이드오프를 함께 제시하세요.
  4. 최소한으로 변경

    • 요청을 충족하는 가장 작은 변경을 수행하세요.
    • 작업에 필요한 경우가 아니라면 인접 코드를 리팩터링, 재포맷, 이름 변경 또는 정리하지 마세요.
    • 자신의 변경으로 인해 생성된 사용되지 않는 코드만 제거하세요.
    • 수정이 관련 없는 파일로 계속 확장된다면 멈추고 경계를 설명한 후 계속하세요.
  5. 실제로 검증

    • 버그: 가능하면 먼저 재현한 후 수정을 증명하세요.
    • 스크립트: 대표적인 입력으로 실행하고 출력을 검사하세요.
    • 웹/UI: 페이지를 열고 렌더링을 확인하며 변경된 흐름을 테스트하세요.
    • 배포 및 통합: 접근 권한이 있을 때 라이브 서비스나 제어판을 확인하세요.
    • 기존 환경 노이즈로 인해 전체 검증이 차단되면 요청된 결과를 증명할 수 있는 가장 좁은 검사를 실행하고, 검증되지 않은 내용을 알리세요.
  6. 안전 경계 유지

    • 사용자가 명시적으로 요청하지 않는 한 git 작업을 수행하지 마세요.
    • 파일이나 디렉토리를 일괄 삭제하지 마세요. 한 번에 하나의 명시적 파일 경로만 삭제하세요. 대량 삭제가 필요하면 멈추고 사용자에게 처리를 요청하세요.
    • 비밀을 노출하지 마세요. 비밀의 존재 여부나 이름이 일치하는지 확인하는 것은 괜찮습니다.
    • Windows에서는 파일 잠금, pnpm no-TTY 문제, 오래된 빌드 아티팩트와 같은 환경 노이즈를 변경의 정확성과 구분하세요.
  7. 명확하게 보고

    • 사용자에게 변경한 내용, 결과, 검증된 사항을 알리세요.
    • 실제로 남아있는 미해결 항목만 언급하세요.
    • 사용자가 요청하지 않는 한 최종 보고서에 구현 세부 사항을 포함하지 마세요.

정리

이 스킬을 업데이트할 때 각 규칙이 동작을 변경하는 경우에만 유지하세요. 긴 예제, 도구 튜토리얼, 프로젝트별 사실은 삭제하세요. 그것들은 프로젝트 지침이나 별도 스킬에 속합니다.

관련 스킬