scripts/ 디렉토리 활용 가이드

개발을 하다 보면 반복적인 로컬 작업이나 운영 업무 때문에 흐름이 끊길 때가 많아요. 매번 복잡한 명령어를 기억해서 입력하는 건 번거롭고 실수하기도 쉽죠. 이럴 때 유용한 것이 바로 프로젝트의 scripts/ 디렉토리예요.

필요한 것

• 프로젝트 내 scripts/ 디렉토리 접근 권한
• 로컬 개발 환경

빠른 시작

scripts/ 디렉토리는 로컬 워크플로우와 운영 작업을 돕는 스크립트들을 모아두는 곳이에요. 5분 안에 이 디렉토리를 올바르게 사용하는 방법을 알려드릴게요.

1. 스크립트 선택: 수행하려는 작업이 특정 스크립트와 명확히 연결되어 있다면 scripts/에 있는 파일을 사용하세요.
2. CLI 우선 확인: 만약 동일한 기능을 수행하는 CLI 명령어가 있다면 스크립트보다 CLI를 사용하는 것이 좋아요. 예를 들어, 인증 모니터링을 할 때는 스크립트 대신 openclaw models status --check 명령어를 우선적으로 사용합니다.
3. 코드 검토: 스크립트는 실행하는 호스트 환경(host-specific)에 따라 다르게 동작할 수 있어요. 새로운 장비에서 실행하기 전에는 반드시 스크립트 내용을 먼저 읽어보세요.
4. 스크립트 추가: 새로운 스크립트를 추가할 때는 기능을 집중시키고 관련 문서에 짧은 설명을 적어주세요. 문서가 없다면 새로 만들어야 합니다.

문제 해결

• 스크립트가 새로운 장비에서 실행되지 않나요? 스크립트는 특정 실행 환경에 종속적일 수 있어요. 실행하기 전에 코드를 읽고 현재 환경에 맞는지 확인하는 과정이 필요해요.
• 언제 스크립트를 써야 할지 헷갈리나요? 문서나 릴리스 체크리스트에서 직접 언급된 경우가 아니라면 스크립트 사용은 선택 사항이에요. CLI 도구가 있다면 CLI를 먼저 사용하세요.

궁금한 점이 더 있다면 AI Setup Assistant에서 바로 도움을 받아보세요.

다음 단계

• /automation/auth-monitoring