사용자 정의 규칙은 Bob이 요청에 응답하는 방식에 영향을 미치며 특정 기본 설정 및 프로젝트 요구 사항에 맞게 출력을 조정합니다. 사용자 정의 규칙을 구성해 Bob의 코딩 스타일, 문서 접근 방식 및 의사 결정 프로세스를 제어하세요.

사용자 정의 규칙이란 무엇인가요?

사용자 정의 규칙은 Bob이 작업에 접근하는 방식을 결정하는 기본 설정, 제약 조건 및 지침을 정의하여 Bob의 기본 동작을 확장하여 요구 사항을 충족합니다.

일반적인 용도는 다음과 같습니다:

코딩 스타일 기본 설정(들여쓰기, 명명 규칙)

문서 형식 및 표준

테스트 방법론 및 요구 사항

프로젝트 워크플로우 및 프로세스

팀별 규칙

모드에 대한 사용자 정의 규칙 추가

사용자 정의 규칙을 모드에 추가하는 두 가지 방법이 있습니다:

UI를 통해

모든 프로젝트에 적용되는 규칙을 구성합니다:

Bob 사이드바의 오른쪽 상단 모서리에 있는 세 개의 점을 클릭합니다.

모드를 클릭합니다.

규칙을 편집하려는 모드를 선택합니다.

편집을 클릭합니다.

**모드별 사용자 정의 지침(선택 사항)**으로 스크롤합니다.

규칙을 입력합니다.

저장을 클릭합니다.

모드별 규칙 파일을 통해

모드는 .bob/rules-{mode-slug}/ 디렉토리에 저장된 추가 규칙 파일을 가질 수도 있습니다:

01-style-guide.md

02-formatting.txt

디렉토리의 파일은 알파벳순으로 로드되고 모드 구성의 customInstructions 속성과 결합됩니다. 자세한 내용은 사용자 정의 모드를 참조하세요.

프로젝트 수준 규칙을 사용하여 Bob의 동작 표준화에 대해 자세히 알아보세요.

규칙 범위

Bob은 규칙이 적용되는 위치를 결정하는 두 가지 규칙 범위를 지원합니다:

전역 규칙: 모든 프로젝트에 자동으로 적용됩니다

워크스페이스 규칙: 현재 프로젝트 내에서만 적용됩니다

개인 또는 조직 전체 표준에는 전역 규칙을 사용합니다. 프로젝트별 요구 사항에는 워크스페이스 규칙을 사용합니다.

구성 방법

디렉토리 기반 구성

워크스페이스 루트의 .bob/ 아래 디렉토리를 사용합니다:

워크스페이스 구조:

coding-style.md

typescript.md

rules/ - 모든 모드에 대한 일반 규칙

rules-agent/ - Agent 모드별 규칙

전역 구조:

Linux/macOS: ~/.bob/rules/ Windows: %USERPROFILE%\.bob\rules\

워크스페이스 규칙 만들기:

mkdir -p .bob/rules
echo "# 프로젝트 표준" > .bob/rules/coding-style.md

전역 규칙 만들기:

# Linux/macOS
mkdir -p ~/.bob/rules
echo "# 전역 표준" > ~/.bob/rules/coding-standards.md

# Windows
mkdir %USERPROFILE%\.bob\rules
echo # 전역 표준 > %USERPROFILE%\.bob\rules\coding-standards.md

규칙 우선순위

Bob은 여러 소스의 규칙을 다음 순서로 결합합니다:

전역 규칙 (~/.bob/rules/)

워크스페이스 규칙 (.bob/rules/)

각 수준 내에서 모드별 규칙이 일반 규칙보다 먼저 로드됩니다. 워크스페이스 규칙은 전역 규칙을 재정의할 수 있습니다.

효과적인 규칙 작성

구체적이고 실행 가능하게

좋음: "JavaScript 파일에서 들여쓰기에 4개의 공백 사용"

피하기: "코드를 예쁘게 포맷"

명확한 구조 사용

주제별로 규칙을 구성합니다:

# 코드 스타일
- 변수에 camelCase 사용
- 클래스에 PascalCase 사용

# 테스트
- 모든 공개 함수에 대한 단위 테스트 작성
- 테스트 프레임워크로 Jest 사용

# 문서
- 공개 API에 JSDoc 주석 추가

효과적인 규칙 예제

"항상 4개의 공백 너비로 들여쓰기에 공백 사용"

"변수 이름에 camelCase 사용"

"모든 새 기능에 대한 단위 테스트 작성"

"코드를 제공하기 전에 추론 설명"

"웹사이트에 기능을 추가할 때 반응형이고 접근 가능한지 확인"

고급 구성

모드별 규칙

전용 디렉토리로 특정 모드를 대상으로 합니다:

디렉토리	목적
`rules/`	모든 모드에 대한 일반 규칙
`rules-agent/`	Agent 모드만
`rules-plan/`	Plan 모드만
`rules-ask/`	Ask 모드만
`rules-{mode}/`	모든 사용자 정의 모드

`AGENTS.md` 파일 사용

팀 표준화를 위해 워크스페이스 루트에 AGENTS.md 파일을 사용할 수 있습니다:

# 팀 표준
- 회사 코딩 지침 준수
- 승인된 라이브러리만 사용
- 모든 API 변경 사항 문서화

중요한 세부 사항:

기본적으로 자동으로 로드됨

프로젝트와 함께 버전 제어

설정에서 "bob-code.useAgentRules": false로 비활성화

모드별 규칙 이후에 로드되지만 일반 워크스페이스 규칙 이전에 로드됨

파일 동작

재귀 읽기: Bob은 하위 디렉토리를 포함하여 규칙 디렉토리의 모든 파일을 읽습니다

알파벳 순서: 파일은 파일 이름별로 알파벳 순서로 처리됩니다

자동 필터링: 캐시 파일 제외(.DS_Store, *.bak, *.cache, *.log, *.tmp, Thumbs.db)

심볼릭 링크: 최대 깊이 5로 지원

빈 파일: 자동으로 건너뜀

팀 표준화

프로젝트 수준 표준

버전 제어 하에 워크스페이스 .bob/rules/ 디렉토리를 사용합니다:

# 버전 제어에 추가
git add .bob/rules/
git commit -m "Bob 사용자 정의 규칙 추가"

이는 특정 프로젝트에 대해 팀 구성원 간에 일관된 동작을 보장합니다.

조직 전체 표준

팀 구성원에게 전역 규칙을 배포합니다:

공유 규칙 저장소 만들기

팀 구성원이 ~/.bob/rules/로 복제

일관성을 위해 정기적으로 업데이트

하이브리드 접근 방식

두 접근 방식을 결합할 수 있습니다:

조직 표준에 대한 전역 규칙

프로젝트별 요구 사항에 대한 워크스페이스 규칙

필요에 따라 워크스페이스 규칙이 전역 규칙을 재정의

사용자 정의 규칙

이 페이지에서