Communitygithub.com

Vmara2376/claude-ace

OpenAI 및 중국 LLM용 토큰 절약형 AI 코딩 어시스턴트 구축: AST 기반 컨텍스트, 셀프 힐링, 의도 검사 포함

claude-ace란 무엇인가요?

이 스킬은 OpenAI 및 중국 LLM(예: DeepSeek, Qwen 등)을 위한 효율적인 AI 코딩 어시스턴트를 설계하고 구축하는 방법을 제공합니다. 핵심 목표는 AST(Abstract Syntax Tree) 분석을 활용하여 필요한 코드 컨텍스트만 추출함으로써 토큰 소비를 최소화하는 것입니다. 또한, 자가 치유(self-healing) 메커니즘과 의도 검사(intent check)를 통해 잘못된 코드 생성이나 불필요한 작업을 방지하여 안정성과 신뢰성을 높입니다. 이 스킬은 OpenAI API 호환 서비스는 물론, 중국의 여러 LLM 플랫폼에서도 동작하도록 설계되어 비용 효율적이고 확장 가능한 코딩 도우미를 원하는 개발자에게 이상적입니다. SKILL.md 문서에는 어시스턴트의 아키텍처, 주요 기능, 설치 및 설정 방법, 사용 예시 등이 상세히 설명되어 있습니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add Vmara2376/claude-ace

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

claude-ace은(는) 무엇을 하나요?

OpenAI 및 중국 LLM을 위한 토큰 절약형 AI 코딩 어시스턴트를 AST 기반 컨텍스트, 셀프 힐링, 의도 검사와 함께 구축하세요.

이 스킬은 OpenAI 및 중국 LLM(예: DeepSeek, Qwen)을 위한 효율적인 AI 코딩 어시스턴트를 설계하고 구축하는 방법을 제공합니다. 핵심 목표는 AST(Abstract Syntax Tree) 분석을 활용하여 필요한 코드 컨텍스트만 추출함으로써 토큰 소비를 최소화하는 것입니다. 또한, 자가 치유(self-healing) 메커니즘과 의도 검사(intent check)를 통해 잘못된 코드 생성이나 불필요한 작업을 방지하여 안정성과 신뢰성을 높입니다.

주요 기능

  • AST 기반 컨텍스트 추출: 필요하지 않은 전체 파일 대신 함수 시그니처, 변수 선언 등 코드의 구조적 요소만 추출하여 토큰 사용량을 크게 줄입니다.
  • 자가 치유(self-healing): 잘못된 API 호출이나 오류 발생 시 자동으로 복구를 시도하여 작업 흐름을 유지합니다.
  • 의도 검사(intent check): 사용자의 요청이 실제로 필요한 작업인지 확인하고, 불필요한 계산이나 API 호출을 방지합니다.
  • 멀티 LLM 지원: OpenAI API 호환 서비스(예: OpenAI, Azure OpenAI) 및 여러 중국 LLM(DeepSeek, Qwen, Baidu Ernie 등)을 지원합니다.

설치 및 설정

  1. 저장소를 클론합니다:

    git clone https://github.com/Vmara2376/claude-ace.git
    cd claude-ace
    
  2. 필요한 패키지를 설치합니다:

    pip install -r requirements.txt
    
  3. 환경 변수를 설정합니다:

    export OPENAI_API_KEY="your-api-key"  # OpenAI 또는 호환 API 키
    export LLM_PROVIDER="openai"          # 또는 "deepseek", "qwen" 등
    

사용 예시

from claude_ace import AceAssistant

assistant = AceAssistant(provider="openai")
response = assistant.ask("주어진 함수에 대한 단위 테스트를 작성해 주세요.")
print(response)

아키텍처 개요

  • 컨텍스트 관리자: AST를 사용하여 코드베이스에서 필요한 정보만 추출하고 관리합니다.
  • 의도 분석기: 사용자 요청의 의도를 분석하여 불필요한 작업을 필터링합니다.
  • 자가 치유 모듈: API 오류나 예외 상황을 감지하고 자동으로 복구 로직을 실행합니다.
  • LLM 라우터: 다양한 LLM 제공자 간의 요청을 적절히 분배하고 연결합니다.

라이선스

이 프로젝트는 MIT 라이선스 하에 배포됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.

관련 스킬