Community코딩 & 개발github.com

에이전트 명령 유지보수

코딩 에이전트 명령과 그 탐색 경로를 유지보수합니다. AGENTS.md, CLAUDE.md, 에이전트 규칙 또는 명령 프로젝션을 생성하거나 변경할 때 사용합니다. 요청이 하나의 에이전트만 명시하더라도 에이전트 안내 또는 배포가 변경될 때마다 이 스킬을 사용하십시오.

에이전트 명령 유지보수란 무엇인가요?

이 스킬은 다중 에이전트 시스템에서 에이전트 명령(instruction)을 일관되게 유지 관리하기 위한 절차와 모범 사례를 제공합니다. 여러 에이전트(예: Claude Code, Cursor, Codex)가 동일한 프로젝트에서 작업할 때 각 에이전트마다 별도의 명령 파일이 존재할 수 있으며, 서로 다른 명령 메커니즘(예: Claude의 Markdown 규칙과 Codex의 명령 규칙)은 동일해 보여도 실제로 다른 의미를 가질 수 있습니다. 이 스킬은 하나의 정식 출처(canonical source)를 유지하고, 나머지 에이전트별 위치는 투영(projection)이나 어댑터로 처리하도록 안내합니다. 이를 통해 명령 콘텐츠 변경 시 모든 에이전트에 일관된 업데이트가 적용되고, 배포 및 검증까지 자동화된 워크플로우를 지원합니다. '모든 작업에 항상 로드되는 명령 파일에 조건부 안내를 넣지 말 것', '이름이 같은 메커니즘을 동등하게 취급하지 말 것', '하나의 투영만 업데이트하지 말 것' 등의 주의사항을 포함하여 실제 운영 환경에서 발생할 수 있는 함정을 방지하는 데 중점을 둡니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/SebastienElet/agent-skills/tree/HEAD/skills/agent-instructions

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

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

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

문서

에이전트 명령 유지보수은(는) 무엇을 하나요?

개요

에이전트 안내를 범위 내에 두고, 검색 가능하게 유지하며, 하나의 정식 출처에서 파생되도록 합니다. 명령 콘텐츠, 어댑터, 배포 또는 검증을 변경하기 전에 공유 유지보수 정책을 적용하십시오.

사용법

글로벌 또는 프로젝트 명령, 에이전트별 규칙 파일, 그리고 이들을 노출하는 구성에 대한 변경 사항에 이 스킬을 사용하십시오. 예: $agent-instructions add a Codex instruction source.

단계

  1. references/maintenance.md를 완전히 읽습니다.
  2. 기존 명령 계층 구조와 변경의 영향을 받는 모든 탐색 경로를 검사합니다.
  3. 하나의 정식 출처를 선택하고 에이전트별 위치는 투영 또는 어댑터로 유지합니다.
  4. 출처를 소비하는 모든 설치 프로그램, 생성된 파일, 인덱스 및 검증 장벽을 업데이트합니다.
  5. 영향을 받는 각 에이전트 투영을 독립적으로 검증합니다.

주의사항

  • 항상 로드되는 명령에 조건부 안내를 넣는 경우 — 모든 작업이 컨텍스트 비용을 부담합니다. 점진적 공개를 지원하는 에이전트에게는 스킬로 노출하십시오.
  • 이름이 같은 메커니즘을 동등하게 취급하는 경우 — Claude Markdown 규칙과 Codex 명령 규칙은 서로 다른 의미를 가집니다. 소비자의 탐색 계약을 확인하십시오.
  • 하나의 투영만 업데이트하는 경우 — 다른 에이전트는 조용히 오래된 동작을 유지합니다. 선언된 모든 소비자를 열거하고 실제 대상을 테스트하십시오.

제약 조건

  • 공유 명령 동작에 대해 하나의 정식 출처를 유지하십시오.
  • 호환성 해결 패치로 항상 로드되는 명령 파일에 조건부 규칙을 절대 주입하지 마십시오.
  • 실제 배포된 대상을 확인하지 않은 투영을 정상으로 보고하지 마십시오.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

관련 스킬