7. 테스트 및 품질 기준
현재 상태
테스트 러너는 Rstest(@rstest/core)이며, 설정은 루트 rstest.config.ts 하나입니다. 테스트 파일은 대상 파일 옆에 *.test.ts로 둡니다.
커버리지는 v8 provider로 항상 수집되며 coverage/에 text·html·lcov로 출력됩니다.
테스트 실행
pnpm test:agent는 사전 조건이 있습니다:
pnpm build— 에이전트가 띄울dist/server.js가 필요npx playwright install chromium— 최초 1회- 저장소 루트
.env에OPENAI_API_KEY(또는SILICONFLOW_API_KEY,API_KEY)
반드시 테스트해야 하는 핵심 시나리오
신규 코드 작성 시 테스트 규칙
- 새 도구를 추가할 때마다 해당 도구의 핸들러 단위 테스트를 함께 작성
- 파라미터 Zod 스키마가 추가/변경될 때 검증 테스트 추가
README.md와SKILL.md에 적은 명령이 실제로 동작하는지 확인- 네트워크·브라우저가 필요한 테스트는
describe.skipIf로 기본 실행에서 제외
품질 검증 방식
린트
@rslint/core의 ts / js / import / unicorn recommended 구성 사용@typescript-eslint/no-explicit-any는 off (MCP SDK 인터페이스 호환성)
포매팅
타입 검사
- 루트
tsconfig.json에"noEmit": true,strict: true include: ["src"]— 소스와 테스트 파일이 모두 검사 대상
빌드 검증
- tsup이 3개 엔트리(index, server, cli)를 모두 정상 번들링하는지 확인
- DTS 생성이 정상 동작하는지 확인
- 릴리스는 release-please(릴리스 PR 머지)가 처리하므로 CI에 릴리스 드라이런 단계가 없음
CI 파이프라인 (.github/workflows/ci.yml)
main을 대상으로 하는 모든 PR과 main push에서 실행됩니다.
pnpm install --frozen-lockfilepnpm lintpnpm format:checkpnpm typecheckpnpm testpnpm build
"작업 완료" 판단 기준
변경 사항이 "완료"되려면 다음을 모두 충족해야 합니다:
-
pnpm lint통과 -
pnpm format:check통과 -
pnpm typecheck통과 -
pnpm test통과 -
pnpm build정상 완료 - 도구를 추가·변경한 경우
README.md와skills/<bin>/SKILL.md를 손으로 갱신 - 도구·의존성·빌드 설정을 건드렸거나, 문서가 정해 주지 않은 선택을 했거나, 답을 받지 못한 질문에 가정을 세웠으면
.claude/decisions/에 결정 기록 작성 — 형식은 .claude/decision-log.md - Conventional Commits 형식의 커밋 메시지 작성
- 불필요한 파일(dist, node_modules 등)이 커밋에 포함되지 않음
-
src/common/변경 시 MCP 서버·CLI 두 경로 모두 확인