hatyibei/shingan

shingan은(는) 무엇을 하나요?

AI 에이전트 워크플로우 정적 분석기 — 실행 전 무한 루프, 비용 폭발, PII 유출 경로를 탐지합니다. Go + 양파 아키텍처 + 팩토리 패턴 + Vertex AI 통합.

개요

shingan은 AI 에이전트(Claude Code, Cursor, Codex 등)의 워크플로우 정의를 정적으로 분석하여 잠재적인 문제를 실행 전에 발견합니다. 이를 통해 개발자는 안정적이고 안전한 AI 워크플로우를 구축할 수 있습니다.

주요 기능

• 무한 루프 탐지: 재귀적 호출이나 조건 없는 반복 구조를 식별합니다.
• 비용 폭발 분석: 예상 비용이 임계값을 초과하는 워크플로우 경로를 찾습니다.
• PII 유출 경로 탐지: 워크플로우 내에서 개인 식별 정보가 외부로 유출될 가능성이 있는 지점을 분석합니다.

아키텍처

• 양파 아키텍처 (Onion Architecture): 핵심 도메인 로직을 중심으로 인프라스트럭처 계층을 분리하여 유연성과 테스트 용이성을 확보합니다.
• 팩토리 패턴 (Factory Pattern): 다양한 분석기 인스턴스를 생성하고 관리하는 데 사용됩니다.
• Vertex AI 통합: 구글 클라우드의 Vertex AI를 활용하여 고급 머신러닝 기반 분석을 수행합니다.

설치 및 사용법

go get github.com/hatyibei/shingan

기본 사용 예시:

package main

import (
    "fmt"
    "github.com/hatyibei/shingan"
)

func main() {
    analyzer := shingan.NewAnalyzer()
    result := analyzer.Analyze("path/to/workflow.yaml")
    fmt.Println(result)
}

설정

환경 변수:

• VERTEX_AI_PROJECT_ID: Vertex AI 프로젝트 ID
• VERTEX_AI_LOCATION: Vertex AI 리전 (기본값: us-central1)
• COST_THRESHOLD: 비용 경고 임계값 (기본값: 100.0)

기여

버그 리포트와 풀 리퀘스트는 GitHub 저장소를 통해 환영합니다.

라이선스

MIT