steipete/agent-scripts

해결하는 문제

이 프로젝트는 AI 에이전트(특히 Codex 및 Claude Code용으로 맞춤화됨)를 위한 공유 지침, 재사용 가능한 스킬, 휴대용 헬퍼 스크립트를 중앙 집중식으로 관리하는 시스템을 제공합니다. 여러 로컬 워크스페이스와 리포지토리 간에 규칙과 스킬을 수동으로 복사할 필요가 없어지며, 에이전트 동작이 여러 프로젝트에서 일관되게 유지됩니다.

작동 방식

이 시스템은 공유 파일과 심볼릭 링크의 조합을 사용하여 지침과 스킬을 배포합니다.

• 공유 지침: 중앙 AGENTS.MD 파일에는 전역 하드 규칙이 포함되어 있습니다. 다른 리포지토리는 중복을 피하기 위해 포인터 스타일의 AGENTS.MD를 통해 이 파일을 가리킵니다.
• 스킬 라우팅: 스킬은 라우팅을 위한 YAML 프론트 매터가 있는 SKILL.md 파일에 정의됩니다. 동기화 스크립트(scripts/sync-skills)는 서로 다른 에이전트에 필요한 미러를 생성합니다: Codex용 전체 루트 링크와 Claude Code용 플랫 스킬별 링크.
• 휴대용 헬퍼: 종속성이 적은 스크립트는 scripts/ 및 hooks/에 저장되어 스킬 검증과 같은 일반적인 기능과 에이전트 가드레일을 제공합니다.

대상 사용자

여러 로컬 프로젝트에서 Claude Code 또는 Codex와 같은 AI 에이전트를 사용하고 에이전트의 스킬 및 지침 "지식 기반"을 중앙 집중식으로 관리하려는 개발자.

주요 기능

• 멀티 에이전트 지원: Codex와 Claude Code가 요구하는 서로 다른 디렉터리 구조를 구체적으로 처리합니다.
• 멱등 동기화: sync-skills 스크립트는 오래된 링크를 정리하고 실제 파일을 덮어쓰지 않습니다.
• 스킬 검증: 스킬 정의가 올바른지 확인하기 위해 git 훅으로 사용되는 validate-skills 스크립트가 포함되어 있습니다.
• 브라우저 도구: 에이전트 기반 브라우저 자동화를 위한 독립형 Chrome DevTools 헬퍼가 포함되어 있습니다.