사용자 지정 규칙
사용자 지정 규칙은 터미널 환경에서 Bob Shell이 요청에 응답하는 방식에 영향을 미치며, 출력을 특정 선호도 및 프로젝트 요구 사항에 맞게 조정합니다. 코딩 스타일, 문서 접근 방식, 의사결정 프로세스를 제어할 수 있습니다.
사용자 지정 규칙이란?
사용자 지정 규칙은 터미널 환경에서 작업할 때 Bob Shell이 필요에 맞게 접근하도록 방향을 제시하는 선호도, 제약 조건, 지침을 정의하여 Bob Shell의 기본 동작을 확장합니다.
일반적인 용도:
- 코딩 스타일 선호도 (들여쓰기, 명명 규칙)
- 문서 형식 및 표준
- 테스트 방법론 및 요구 사항
- 프로젝트 워크플로 및 프로세스
- 팀 고유의 관행
규칙 범위
Bob Shell은 규칙이 적용되는 위치를 결정하는 두 가지 규칙 범위를 지원합니다:
- 전역 규칙: 모든 프로젝트에 자동으로 적용됩니다
- 워크스페이스 규칙: 현재 프로젝트 내에서만 적용됩니다
개인 또는 조직 전체 표준에는 전역 규칙을 사용하세요. 프로젝트별 요구 사항에는 워크스페이스 규칙을 사용하세요.
구성 방법
Bob Shell은 IBM Bob IDE와 동일한 사용자 지정 규칙 시스템을 사용합니다.
파일 기반 구성
가장 간단한 방법은 워크스페이스 루트의 단일 파일을 사용하는 것입니다:
.bobrules- 일반 워크스페이스 규칙.bobrules-code- Code 모드 규칙.bobrules-{modeSlug}- 특정 모드 규칙
.bobrules 파일 만들기:
# 프로젝트 루트에서
echo "Use 4 spaces for indentation" > .bobrules디렉토리 기반 구성
더 나은 구성을 위해 디렉토리를 사용하세요:
워크스페이스 구조:
.bob/
├── rules/ # 일반 규칙
│ └── coding-style.md
└── rules-code/ # Code 모드 규칙
└── typescript.md전역 구조:
Linux/macOS: ~/.bob/rules/
Windows: %USERPROFILE%\.bob\rules\
워크스페이스 규칙 만들기:
mkdir -p .bob/rules
echo "# Project standards" > .bob/rules/coding-style.md전역 규칙 만들기:
# Linux/macOS
mkdir -p ~/.bob/rules
echo "# Global standards" > ~/.bob/rules/coding-standards.md
# Windows
mkdir %USERPROFILE%\.bob\rules
echo # Global standards > %USERPROFILE%\.bob\rules\coding-standards.md규칙 우선순위
Bob Shell은 다음 순서로 여러 소스의 규칙을 결합합니다:
- 전역 규칙 (
~/.bob/rules/) - 워크스페이스 규칙 (
.bob/rules/)
각 수준 내에서 모드별 규칙이 일반 규칙보다 먼저 로드됩니다. 워크스페이스 규칙은 전역 규칙을 재정의할 수 있습니다.
효과적인 규칙 작성하기
구체적이고 실행 가능하게
좋은 예: "터미널에서 파일 작업을 제안할 때 항상 상대 경로를 사용하세요"
피해야 할 예: "좋은 경로를 사용하세요"
명확한 구조 사용
주제별로 규칙을 구성하세요:
# Shell Commands
- Prefer using standard Unix commands over specialized tools when possible
- Include explanations of what each flag does
# Script Style
- Format shell script examples with proper error handling
- Use portable shell syntax that works across bash, zsh, and other common shells
# File Operations
- Always check for file existence before operations in shell scripts
- Always use relative paths when suggesting file operations효과적인 규칙 예시
- "터미널에서 파일 작업을 제안할 때 항상 상대 경로를 사용하세요"
- "가능하면 특수 도구보다 표준 Unix 명령을 선호하세요"
- "적절한 오류 처리가 포함된 셸 스크립트 예시를 형식에 맞게 작성하세요"
- "명령을 제안할 때 각 플래그의 기능을 설명해 주세요"
- "셸 스크립트에서 작업 전에 항상 파일 존재 여부를 확인하세요"
- "bash, zsh 및 기타 일반 셸에서 작동하는 이식 가능한 셸 문법을 사용하세요"
고급 구성
모드별 규칙
전용 디렉토리로 특정 모드를 대상으로 하세요:
| 디렉토리 | 목적 |
|---|---|
rules/ | 모든 모드에 대한 일반 규칙 |
rules-code/ | Code 모드 전용 |
rules-plan/ | Plan 모드 전용 |
rules-{mode}/ | 사용자 지정 모드 |
AGENTS.md 파일 사용하기
팀 표준화를 위해 워크스페이스 루트의 AGENTS.md 파일을 사용할 수 있습니다:
# Team Standards
- Follow company coding guidelines
- Use approved libraries only
- Document all API changes주요 사항:
- 기본적으로 자동으로 로드됩니다
- 프로젝트와 함께 버전 관리됩니다
- 설정에서
"bob-shell.useAgentRules": false로 비활성화 가능 - 모드별 규칙 다음, 일반 워크스페이스 규칙 이전에 로드됩니다
파일 동작
- 재귀적 읽기: Bob Shell은 하위 디렉토리를 포함하여 규칙 디렉토리의 모든 파일을 읽습니다
- 알파벳 순서: 파일은 파일 이름의 알파벳 순서로 처리됩니다
- 자동 필터링: 캐시 파일(
.DS_Store,*.bak,*.cache,*.log,*.tmp,Thumbs.db) 제외 - 심볼릭 링크: 최대 깊이 5로 지원됩니다
- 빈 파일: 자동으로 건너뜁니다
팀 표준화
프로젝트 수준 표준
버전 관리 하에 워크스페이스 .bob/rules/ 디렉토리를 사용하세요:
# 버전 관리에 추가
git add .bob/rules/
git commit -m "Add Bob custom rules"이렇게 하면 Bob Shell을 사용하는 팀원들이 특정 프로젝트에서 일관된 동작을 유지할 수 있습니다.
조직 전체 표준
팀원들에게 전역 규칙을 배포하세요:
- 공유 규칙 repository 만들기
- 팀원들이
~/.bob/rules/에 복제 - 일관성을 위해 주기적으로 업데이트
하이브리드 접근 방식
두 가지 방식을 결합할 수 있습니다:
- 조직 표준에는 전역 규칙
- 프로젝트별 요구 사항에는 워크스페이스 규칙
- 필요한 경우 워크스페이스 규칙이 전역 규칙을 재정의