compliancelint은(는) 무엇을 하나요?
EU AI Act 규정 준수: IDE에서 직접 스캔, 증명 및 문서화. 스캐너는 코드로 확인 가능한 위반 사항을 찾고, AI는 하이브리드 의무에 대한 증거를 수집하며, Human Gate는 순수 증명을 캡처합니다. 소스 공개(BSL 1.1), MCP-네이티브, 감사 추적 포함.
개요
ki-sum/compliancelint는 EU AI Act 준수를 위한 통합 개발 환경(IDE) 도구입니다. 코드 분석, AI 지원 증거 수집, 인간 검증 게이트를 결합하여 규정 준수 프로세스를 자동화합니다.
주요 기능
1. 스캐너 (Scanner)
스캐너는 코드 저장소를 분석하여 EU AI Act에서 요구하는 규칙을 위반할 가능성이 있는 패턴을 식별합니다. 예를 들어:
- 알고리즘 편향성: 데이터 세트 또는 모델에서 잠재적 편향을 감지합니다.
- 투명성 부족: 설명 가능성 또는 문서화가 부족한 영역을 찾습니다.
- 오류 보고 누락: 로깅 또는 오류 처리 구현이 없는 경우를 확인합니다.
스캐너는 정적 분석 규칙을 사용하여 코드에서 직접 확인 가능한 위반 사항에 초점을 맞춥니다.
2. AI 증거 수집 (AI Evidence Collection)
AI 에이전트가 하이브리드 의무(일부는 코드로, 일부는 문서나 프로세스로 증명해야 하는 요구사항)에 대한 증거를 수집합니다. AI는 다음을 수행합니다:
- 관련 파일, 커밋 메시지 및 이슈 트래커를 분석합니다.
- 증거를 구조화된 형식으로 요약합니다.
- 추가 인간 검증이 필요한 영역을 표시합니다.
3. Human Gate
Human Gate는 순수 증명(인간의 판단이나 조직 정책이 필요한 영역)을 캡처합니다. 이는 다음을 포함합니다:
- 윤리적 영향 평가.
- 조직 정책 준수 확인.
- 외부 규정 준수 인증.
개발자는 Human Gate를 통해 증명을 입력하고 확인할 수 있습니다.
4. 감사 추적 (Audit Trail)
모든 스캔 결과, AI 수집 증거 및 인간 증명은 변경 불가능한 감사 추적으로 기록됩니다. 이는 규제 기관 제출 및 내부 감사에 사용할 수 있습니다.
지원 플랫폼
- MCP 네이티브: Model Context Protocol을 지원하는 모든 환경 (예: Claude Code, Cursor, 기타 AI 어시스턴트).
- IDE: VS Code, JetBrains, 기타 주요 IDE.
- CLI: 명령줄 인터페이스로 CI/CD 파이프라인에 통합 가능.
사용 방법
MCP 서버로 실행하기
npx @ki-sum/compliancelint mcp
CLI로 스캔하기
npx @ki-sum/compliancelint scan ./path/to/project
Human Gate 증명 추가하기
npx @ki-sum/compliancelint attest --type ethical-impact --file ./attestation.md
라이선스
BSL 1.1 (Business Source License 1.1) - 소스 공개 라이선스. 상업적 사용에는 제한이 있을 수 있습니다. 자세한 내용은 LICENSE 파일을 참조하세요.
구성
compliancelint.config.json 파일을 프로젝트 루트에 생성하여 사용자 정의 규칙 및 설정을 구성할 수 있습니다. 예:
{
"scanner": {
"rules": ["bias-detection", "transparency-check"],
"ignorePaths": ["node_modules", "dist"]
},
"aiEvidence": {
"model": "claude-3-opus",
"collectFrom": ["docs", "issues", "commits"]
},
"humanGate": {
"requiredAttestations": ["ethical-impact", "policy-compliance"]
}
}
감사 추적 내보내기
npx @ki-sum/compliancelint export-audit --format json --output ./audit-report.json
참고 자료
기여하기
소스는 GitHub에서 공개되어 있습니다. 버그 신고, 기능 제안 및 풀 리퀘스트를 환영합니다.