fengshao1227/ccg-workflow

多模型协作工作流引擎 — /ccg:go 一个命令，AI 自动分析意图、选择策略、编排 Codex + Gemini + Claude 协作执行

CCG – Claude + Codex + Gemini 다중 모델 협업

무엇인가요 – ccg-workflow는 Node.js 기반 CLI로, Claude Code를 다른 코드 생성 모델(OpenAI Codex, xAI Grok, Moonshot Kimi Code, Antigravity)의 중심적인 오케스트레이터로 전환합니다. 모든 Claude 세션에 JavaScript 훅을 삽입하여 모델이 컨텍스트를 잃지 않도록 하며, 작은 Go 바이너리(codeagent-wrapper)를 통해 외부 모델에 병렬 분석 또는 구현을 전달합니다. 그 결과 자연어 요청(예: "이 API에 JWT 인증을 추가하세요")을 받아 자동으로 다음을 수행하는 "워크플로 엔진"이 탄생합니다.

프로젝트 컨텍스트 수집 (git 상태, 파일 트리, 기술 스택).
작업 분류 및 적절한 내장 전략 선택.
사양, 계획, 조사, 리뷰 아티팩트를 포함하는 영구적인 작업 디렉터리 (.ccg/tasks/...) 생성.
이중 모델 분석 또는 구현 실행, 사용자 승인을 위한 하드 스톱 계획 제시, 필요 시 장기 운영 "에이전트 팀" 자동 생성.
품질 게이트 체크(보안, 코드 품질, 문서화) 적용 후 최종 커밋 또는 롤백.

핵심 개념

구성 요소	역할
Claude Code	전략 결정 및 대화 주도하는 리더 오케스트레이터.
Hook Engine	네 가지 JS 훅(`workflow-state.js`, `session-start.js`, `subagent-context.js`, `skill-router.js`)이 각 Claude 턴에 작업 상태, 프로젝트 컨텍스트, 도메인 지식을 자동 삽입.
codeagent-wrapper	컴파일된 Go 바이너리로, Claude와 외부 LLM API(Codex, Gemini 등)를 연결하여 별도 CLI 없이 병렬 실행 가능.
Task System	영구적인 `.ccg/tasks/<name>/` 폴더로 JSON 상태, 마크다운 계획, 조사, 리뷰 파일 저장.
Strategies	10개의 사전 정의된 워크플로(예: `direct-fix`, `full-collaborate`, `debug-investigate`)가 작업 복잡도에 따라 자동 선택.
Quality Gates	변경 사항 승인 전 실행되는 내장 체크(`/ccg:verify-security`, `/ccg:verify-quality`, …).
도메인 지식	보안, DevOps, AI/MLOps 등 100개 이상의 마크다운 파일; 라우터가 관련 스니펫을 Claude 프롬프트에 삽입.
Skills	독립형 명령어(`/ccg:bt-panel`, `/ccg:seo-page-builder`, `/ccg:adsense-site-auditor`)로, 전체 다중 모델 엔진 없이도 사용 가능.

빠른 시작 옵션

옵션	제공되는 기능	설치 방법
A – 전체 설치	다중 모델 오케스트레이션, 모든 명령어, 훅, Go 브리지, 작업 엔진.	`npx ccg-workflow` (인터랙티브 워즈드) 또는 `npx ccg-workflow init --skip-prompt` (비인터랙티브 설정). Node ≥ 20 및 Claude Code CLI 필요.
B – 네이티브 플러그인	재사용 가능한 스킬과 품질 게이트 파일만 제공; 외부 모델 라우팅 및 Go 바이너리 없음.	`claude plugin marketplace add fengshao1227/ccg-workflow` 후 `claude plugin install ccg@ccg`. `/ccg:<skill>`로 호출.

일반 워크플로 (예시)

You: /ccg:go 이 API에 JWT 인증을 추가하세요

CCG Engine:
  1️⃣ git 상태 읽기, Node/Express 백엔드 감지.
  2️⃣ *중간 복잡도* 기능으로 분류 → `full-collaborate` 선택.
  3️⃣ `.ccg/tasks/add-jwt-auth/` 생성 및 `task.json` 스타터 생성.
  4️⃣ Codex와 Gemini를 병렬로 실행하여 구현 초안 생성.
  5️⃣ 마크다운 계획 표시 후 사용자 승인 대기 (하드 스톱).
  6️⃣ 에이전트 팀 생성, 코드 작성, 테스트 실행, 리뷰 보고서 생성.
  7️⃣ `/ccg:verify-security` 및 `/ccg:verify-quality` 게이트 실행.
  8️⃣ 변경 사항 커밋 또는 요청 시 롤백.

모든 상태는 작업 폴더에 영구 저장되어 나중에 재개하거나 감사 가능.

주요 명령어 (선택)

/ccg:go – 스마트 진입점; 개발 의도를 설명.
/ccg:commit – 컨벤셔널 커밋 메시지 생성 및 커밋 생성.
/ccg:rollback – 마지막 작업의 인터랙티브 취소.
/ccg:spec-* – OpenSpec 통합 (초기화, 조사, 계획, 구현, 리뷰).
/ccg:bt-panel – HTTP API를 통해 Baota/aaPanel 서버에 빌드 배포.
/ccg:seo-page-builder – SEO 중심 페이지 생성 또는 감사.
npx ccg-workflow dsh install – DeepSeek Harness 플러그인(dsh-ccg)으로 동일한 엔진 설치.

설치 및 구성

# 전체 설치 (인터랙티브)
npx ccg-workflow

# 또는 비인터랙티브
npx ccg-workflow init --skip-prompt

설정은 ~/.claude/ 아래에 있습니다:

~/.claude/
├── commands/ccg/          # 슬래시 명령어 정의
├── hooks/ccg/             # 네 가지 JS 훅 파일
├── skills/ccg/            # 품질 게이트 스크립트 및 도메인 지식
├── .ccg/
│   ├── config.toml        # 모델 라우팅, API 토큰, 성능 튜닝
│   ├── engine/            # 전략 JSON + 라우터 코드
│   └── prompts/           # 각 외부 모델용 전문 프롬프트
└── bin/codeagent-wrapper  # 컴파일된 Go 브리지

환경 변수(~/.claude/settings.json의 "env"에 설정)로 타임아웃 및 선택적 병렬 팀 모드 제어.

사용 사례

기능 개발 – 인증, API 엔드포인트 등 최소한의 수동 코딩으로 새 코드 작성.
버그 수정 – direct-fix 또는 debug-investigate 실행으로 이중 모델 진단 및 패치 획득.
코드 리뷰/감사 – review-audit 전략으로 자동 모델 간 리뷰 및 보안 검사.
문서 생성 – /ccg:gen-docs로 작업 아티팩트에서 README/DESIGN 파일 자동 생성.
사이트 운영 – 내장 스킬을 통해 빌드 배포 또는 SEO/AdSense 준수 감사.

라이선스 및 커뮤니티

라이선스: MIT (허용성 높고 상용 사용에 적합).
기여자: README에 기재된 8명의 핵심 기여자.
지원: X/Twitter @CCG_Workflow, 이메일 fengshao1227@gmail.com, GitHub Issues, Linux.do 커뮤니티 포럼.
후원: APIMart (저비용 AI 이미지/비디오 API), Gamma Remover (PDF/PPTX 워터마크 제거 도구).

결론

ccg-workflow는 개발자가 Claude Code를 "프로젝트 매니저"처럼 사용하면서, 무거운 코드 생성 및 리뷰 작업을 다른 LLM에 위임할 수 있는 풀스택 다중 모델 오케스트레이션 도구입니다. 영구적인 작업 아티팩트, 내장 품질 게이트, 즉시 사용 가능한 운영 스킬을 제공하며, 단일 npx 명령어 또는 네이티브 Claude 플러그인으로 설치 가능.