한국어 · English

보안 취약점을 발견하면 비공개로 신고해 주세요:

이메일: timothyh124@gmail.com

보안 취약점에 대해 공개 GitHub 이슈를 생성하지 마세요. 48시간 이내에 응답하며, 공개 전에 문제를 해결하기 위해 협력합니다.

QABuddy는 AI 스킬 지시서(마크다운 파일)입니다. 설치하면 이 지시서가 AI에게 셸 명령 실행, 파일 읽기/쓰기, 외부 서비스(Jira, 브라우저) 연동 등 수행할 작업을 지시합니다.

스킬은 코드와 같습니다. 설치하기 전에 다른 실행 파일과 동일한 수준으로 검토하세요. AI에게 어떤 작업을 지시하는지 확인하세요.

• 워크스페이스 외부 파일 접근 (~/.ssh/, /etc/ 등)
• AI 플랫폼의 권한 시스템 없이 명령 실행
• 외부 서버로 데이터 전송 (스킬 지시서에 아웃바운드 HTTP 없음)
• AI 플랫폼의 설정이나 다른 설치된 스킬 수정

스킬 파일을 수정하는 PR을 리뷰할 때 다음을 확인하세요:

1. 명령 주입 — 새로운 bash 명령이 민감한 파일을 읽거나, 인증 정보에 접근하거나, 파괴적 작업을 수행하도록 지시하는지 확인
2. 데이터 유출 — 스킬이 외부 URL, 이메일, API로 데이터를 전송하도록 지시하는지 확인
3. 범위 초과 — 스킬이 필요 이상의 파일이나 도구에 접근하는지 확인. frontmatter의 tool-groups를 검토
4. 제약 조건 우회 — 기존 제약 조건을 약화하거나 제거하는 변경인지 확인 (예: "SDT 승인 후 등록" 삭제)
5. eval fixture 안전성 — 새 fixture가 시뮬레이션 중 유해한 작업을 지시하는지 확인

스킬은 다음 패턴을 따라야 합니다:

• 실행 전 확인 — 파괴적 또는 외부 작업은 SDT 승인 필요 (확인 단계에서 A/B/C 옵션)
• 최소한의 tool-groups — 스킬이 실제로 사용하는 도구만 선언
• 하드코딩된 경로 없음 — {{REFERENCE_PATH}}와 features-kb/ 상대 경로 사용
• 결과물에 비밀 정보 없음 — 보고서나 KB 결과물에 API 토큰, 비밀번호, 인증 정보를 포함하지 않음

1. 스킬을 읽어보세요 — 각 스킬은 core/skills/에 있는 마크다운 파일입니다. AI에게 어떤 작업을 지시하는지 확인하세요.
2. tool-groups를 확인하세요 — 각 스킬이 사용할 수 있는 도구를 선언합니다. read와 jira만 필요한 스킬에 bash와 browser가 있으면 안 됩니다.
3. 설정 스크립트를 검토하세요 — 심볼릭 링크를 생성하고 hook 설정 안내를 출력합니다. 설정 파일을 자동으로 수정하지 않습니다.

설정 스크립트는 cat .qabuddy.json을 실행하는 SessionStart hook을 제안합니다. 이것은 안전합니다 — 사용자가 관리하는 설정 파일을 읽습니다. hook 명령을 수정하면 실행되는 내용에 대한 책임은 사용자에게 있습니다.

contributeUpstream: true로 설정하면 /improve가 업스트림 QABuddy 저장소에 자동으로 PR을 생성합니다. 이 PR은:

• core/ 변경 사항만 포함합니다 (.qabuddy.json, features-kb/, 팀별 파일 제외)
• 관리자가 머지 전에 리뷰합니다
• gh CLI 인증이 필요합니다 (사용자의 GitHub 계정)

참고: 법적 효력이 있는 버전은 영문 원본입니다. 본 한국어 번역은 이해를 돕기 위한 참고용입니다.