Agent Skill MCP

Claude Code용 에이전트 스킬을 제공하는 MCP(Model Context Protocol) 서버 프로젝트입니다.

설치

./install.sh

에이전트

error-fixer

오류를 체계적으로 분석하고, 다중 LLM 검증을 거쳐 안전하게 수정하는 에이전트입니다.

Model: opus
Version: 2.0.0
아키텍처: 오케스트레이터 + 7개 서브에이전트

서브에이전트 아키텍처

agents/error-fixer/
├── agent.md                    ← 오케스트레이터 (라우팅 + 조율만)
├── manifest.json
├── mcp-config.json
├── commands/
│   ├── fix_error.md
│   ├── fix_lint.md             ← 린트 전용 커맨드
│   ├── project_profile.md
│   ├── error_history.md
│   └── rollback_fix.md
├── rules/                      ← 공유 규칙 (모든 서브에이전트가 참조)
│   ├── error-analysis.md
│   ├── project-profiling.md
│   ├── rollback-safety.md
│   ├── incremental-verification.md
│   ├── self-hosted-multi-model.md
│   └── lint-fixing.md
└── agents/                     ← 서브에이전트
    ├── error-detector.md       ← Phase 0: 오류 식별 + 라우팅
    ├── deep-context-analyzer.md ← Phase 2a: 8단계 Deep Context 탐색
    ├── fix-planner.md          ← Phase 2b+4: 기획서 생성/피드백 통합
    ├── cross-llm-validator.md  ← Phase 3: 3계층 Cross-LLM 검증
    ├── code-fixer.md           ← Phase 6: 점진적 코드 수정
    ├── lint-fixer.md           ← Phase L0-L4: 린트 전용 수정
    └── security-reviewer.md    ← 보안 집중 검토

모델 정책

| LLM | 모델 | 용도 | |-----|------|------| | Claude | opus | 모든 서브에이전트 (오케스트레이터 포함) | | Codex/OpenAI | gpt-5.2-codex | Cross-LLM 보안/품질 검증 | | Gemini | gemini-3.0-pro | Cross-LLM 기술 검증 |

워크플로우

Full Pipeline (/fix_error):

입력 → error-detector → 프로파일 로드 → deep-context-analyzer
→ fix-planner → cross-llm-validator (병렬) → fix-planner (통합)
→ 사용자 승인 → code-fixer → security-reviewer → 최종 검증

Lint Pipeline (/fix_lint):

입력 → error-detector → lint-fixer
→ (보안 룰시) cross-llm-validator → 최종 리포트

서브에이전트 상세

| # | 서브에이전트 | Phase | 역할 | |---|------------|-------|------| | 1 | error-detector | 0 | 입력 유형 판별 (로그/URL/스크린샷/린트/자연어), 라우팅 결정 | | 2 | deep-context-analyzer | 2a | 8단계 자동 탐색 (import 체인, 타입 추적, 역참조, 테스트, git, context7) | | 3 | fix-planner | 2b+4 | 수정 기획서 작성 + Cross-LLM 피드백 통합 | | 4 | cross-llm-validator | 3 | Gemini + OpenAI 병렬 검증, 3계층 아키텍처 | | 5 | code-fixer | 6 | Minimal Diff 원칙, 점진적 수정 + 롤백 안전장치 | | 6 | lint-fixer | L0-L4 | 린터 감지 → 파싱 → 분류 → auto-fix → 수동수정 → 검증 | | 7 | security-reviewer | - | OWASP Top 10 체크, 의존성 취약점, 하드코딩 시크릿 검출 |

MCP 도구

| MCP 서버 | 도구 | 용도 | |----------|------|------| | error-context-analyzer | parseError | 오류 텍스트 파싱 → 구조화된 에러 정보 | | error-context-analyzer | matchErrorPattern | 알려진 패턴 매칭 → 빠른 해결 제안 | | error-context-analyzer | parseLintOutput | 린터 출력 파싱 → 구조화된 린트 이슈 | | error-context-analyzer | analyzeImports | import/require 경로 파싱 → 의존성 맵 (JS/TS/Python) | | error-context-analyzer | saveErrorRecord | 해결 이력 저장 | | error-context-analyzer | searchErrorHistory | 과거 이력 검색 | | context7 | resolve-library-id | 라이브러리명 → context7 ID | | context7 | query-docs | 라이브러리 최신 API 문서 조회 | | gemini-cli | geminiChat | Gemini 모델 기술 검토 | | openai-cli | openai_chat | OpenAI 모델 보안/품질 검토 |

자체 멀티모델 검증 구축

API 키 없이 CLI 로그인 기반으로 멀티모델 검증을 구축할 수 있습니다:

Gemini: gemini login → execFile("gemini", ...) CLI 호출
Codex: codex login → ~/.codex/auth.json OAuth 토큰 → fetch 호출
Claude: claude login → execFile("claude", ...) CLI 호출

결과 통합은 Debate 패턴 (독립 검토 → 상호 비판 → 합의 종합) 적용. 상세: rules/self-hosted-multi-model.md

homepage-builder

사용자 설명을 기반으로 홈페이지/웹사이트를 자동 생성하는 에이전트입니다.

Model: opus

go-home-reporter

일일 업무 보고서를 자동 생성합니다. Git/GitHub 이력 수집 및 문서 AI 분석을 수행합니다.

Model: sonnet

obsidian-yaml-optimizer

마크다운 문서의 YAML 프론트매터를 자동 최적화합니다. 안전 모드로 동작하여 기존 값을 보존하면서 추가만 허용합니다.

Model: haiku

MCP 서버

error-context-analyzer

오류 컨텍스트를 분석하는 MCP 서버입니다. 스택 트레이스 파싱, 에러 패턴 매칭, import 분석, 린트 출력 파싱, 에러 이력 관리 기능을 제공합니다.

도구 목록:

parseError - 오류 텍스트를 파싱하여 구조화된 에러 정보 추출 (스택 트레이스, 에러 타입, 파일 위치)
matchErrorPattern - 에러 텍스트를 알려진 패턴 DB와 매칭하여 즉시 해결 가능 여부 판단
parseLintOutput - 린터 출력(ESLint, Prettier, Biome, Stylelint, Pylint, Ruff)을 파싱하여 구조화된 린트 이슈 추출
analyzeImports - JS/TS/Python 파일의 import/require/from 경로를 파싱하여 의존성 맵 생성 (상대경로, 패키지, 빌트인 분류)
saveErrorRecord - 해결한 오류를 이력 DB에 저장
searchErrorHistory - 과거 에러 이력 검색

import-analyzer 지원 패턴:

JS/TS: import ... from, require(), dynamic import(), export ... from
Python: import, from ... import
분류: 상대경로 (로컬 파일) / 패키지 (외부 라이브러리) / 빌트인 (Node.js/Python 내장)

gemini-cli

Gemini CLI를 래핑한 MCP 서버입니다.

openai-cli

OpenAI CLI를 래핑한 MCP 서버입니다.

프로젝트 구조

.
├── CLAUDE.md
├── README.md
├── install.sh
├── package.json
├── agents/
│   ├── error-fixer/
│   │   ├── agent.md              ← 오케스트레이터
│   │   ├── manifest.json
│   │   ├── mcp-config.json
│   │   ├── agents/               ← 서브에이전트 (7개)
│   │   │   ├── error-detector.md
│   │   │   ├── deep-context-analyzer.md
│   │   │   ├── fix-planner.md
│   │   │   ├── cross-llm-validator.md
│   │   │   ├── code-fixer.md
│   │   │   ├── lint-fixer.md
│   │   │   └── security-reviewer.md
│   │   ├── commands/
│   │   │   ├── fix_error.md
│   │   │   ├── fix_lint.md
│   │   │   ├── project_profile.md
│   │   │   ├── error_history.md
│   │   │   └── rollback_fix.md
│   │   └── rules/
│   │       ├── error-analysis.md
│   │       ├── incremental-verification.md
│   │       ├── rollback-safety.md
│   │       ├── project-profiling.md
│   │       ├── self-hosted-multi-model.md
│   │       └── lint-fixing.md
│   ├── go-home-reporter/
│   │   ├── agent.md
│   │   ├── manifest.json
│   │   ├── mcp-config.json
│   │   ├── commands/
│   │   └── rules/
│   ├── homepage-builder/
│   │   ├── agent.md
│   │   ├── manifest.json
│   │   └── mcp-config.json
│   └── obsidian-yaml-optimizer/
│       ├── agent.md
│       ├── manifest.json
│       ├── mcp-config.json
│       ├── commands/
│       └── *.md (규칙 문서들)
└── mcp-servers/
    ├── error-context-analyzer/
    │   ├── index.ts
    │   ├── package.json
    │   ├── tsconfig.json
    │   └── src/
    │       ├── import-analyzer.ts
    │       ├── context-extractor.ts
    │       ├── error-database.ts
    │       ├── pattern-matcher.ts
    │       └── parsers/
    │           ├── stack-trace-parser.ts
    │           └── lint-output-parser.ts
    ├── gemini-cli/
    │   ├── index.ts
    │   ├── package.json
    │   └── tsconfig.json
    ├── openai-cli/
    │   ├── index.ts
    │   ├── package.json
    │   └── tsconfig.json
    └── shared/
        ├── package.json
        ├── save-response.ts
        └── error-history-manager.ts

변경 이력

v2.0.0 — Error Fixer 서브에이전트 아키텍처 + Lint Fixing (2026-02-02)

모놀리식 error-fixer를 오케스트레이터 + 7개 서브에이전트로 분리하여, 각 기능이 독립적이고 재사용 가능한 에이전트 시스템으로 재설계했습니다.

참고: everything-claude-code (13개 에이전트 패턴), claude-code-showcase (훅 자동화 패턴)

주요 변경 사항

아키텍처 변경:

agent.md를 경량 오케스트레이터로 리팩토링 (라우팅 + 데이터 전달만 담당)
7개 전문 서브에이전트 신규 생성 (agents/ 디렉토리)
모델 정책 변경: sonnet → opus (모든 서브에이전트)
Cross-LLM 검증 모델 업그레이드: gemini-2.5-pro → gemini-3.0-pro, gpt-5.2-codex 유지
manifest.json v1.1.0 → v2.0.0 (agents 배열 추가, 스킬 확장)

신규 서브에이전트 (7개):

| # | 파일 | 역할 | |---|------|------| | 1 | agents/error-detector.md | 입력 유형 자동 판별 (로그/URL/스크린샷/린트/자연어) + full/lint 라우팅 결정 | | 2 | agents/deep-context-analyzer.md | 8단계 Deep Context 탐색 전담 (import 체인, 타입 추적, 역참조, 테스트, git, context7 문서) | | 3 | agents/fix-planner.md | 수정 기획서 작성 + Cross-LLM 피드백 통합 (Phase 2b와 Phase 4를 단일 에이전트로 통합) | | 4 | agents/cross-llm-validator.md | Gemini + OpenAI 병렬 검증, 3계층 아키텍처 (필수/선택 계층 분리) | | 5 | agents/code-fixer.md | Minimal Diff 원칙 도입, 점진적 수정 + 롤백 안전장치 | | 6 | agents/lint-fixer.md | 린트 전용 파이프라인 (L0-L4): 린터 감지 → 파싱 → 분류 → auto-fix → 수동수정 → 검증 | | 7 | agents/security-reviewer.md | OWASP Top 10 체크리스트, 의존성 취약점 감사, 하드코딩 시크릿 검출 |

Lint Fixing 기능 (신규):

/fix_lint 커맨드 추가 (commands/fix_lint.md)
parseLintOutput MCP 도구 추가 — ESLint, Prettier, Biome, Stylelint, Pylint, Ruff 출력 파서
lint-output-parser.ts — JSON 및 텍스트 형식 모두 지원하는 멀티 린터 파서
rules/lint-fixing.md — 린터별 자동 수정 명령어, 보안 린트 규칙 목록, 안전 규칙

MCP 서버 변경:

mcp-servers/error-context-analyzer/index.ts — parseLintOutput 도구 추가 (Tool 6)
mcp-servers/error-context-analyzer/src/parsers/lint-output-parser.ts — 신규 파서 모듈

규칙 파일 변경:

rules/error-analysis.md — lint-error, lint-security 카테고리 추가
rules/deep-context-analysis.md — 서브에이전트 참조 노트 추가
rules/cross-llm-validation.md — 서브에이전트 참조 노트 추가
rules/plan-generation.md — 서브에이전트 참조 노트 추가
rules/plan-consolidation.md — 서브에이전트 참조 노트 추가

오케스트레이션 흐름:

Full Pipeline: error-detector → 프로파일 → deep-context-analyzer → fix-planner → cross-llm-validator → fix-planner(통합) → 승인 → code-fixer → security-reviewer → 최종 검증
Lint Pipeline: error-detector → lint-fixer → (보안룰시) cross-llm-validator → 리포트

파일 변경 요약

| 변경 | 파일 | 설명 | |------|------|------| | 신규 | agents/error-fixer/agents/error-detector.md | 오류 식별 서브에이전트 | | 신규 | agents/error-fixer/agents/deep-context-analyzer.md | Deep Context 서브에이전트 | | 신규 | agents/error-fixer/agents/fix-planner.md | 기획서 생성 서브에이전트 | | 신규 | agents/error-fixer/agents/cross-llm-validator.md | Cross-LLM 검증 서브에이전트 | | 신규 | agents/error-fixer/agents/code-fixer.md | 코드 수정 서브에이전트 | | 신규 | agents/error-fixer/agents/lint-fixer.md | 린트 수정 서브에이전트 | | 신규 | agents/error-fixer/agents/security-reviewer.md | 보안 검토 서브에이전트 | | 신규 | agents/error-fixer/commands/fix_lint.md | /fix_lint 커맨드 | | 신규 | agents/error-fixer/rules/lint-fixing.md | 린트 수정 규칙 | | 신규 | mcp-servers/error-context-analyzer/src/parsers/lint-output-parser.ts | 멀티 린터 출력 파서 | | 수정 | agents/error-fixer/agent.md | 오케스트레이터로 리팩토링, opus 모델 | | 수정 | agents/error-fixer/manifest.json | v2.0.0, agents 배열/lint 스킬 추가 | | 수정 | agents/error-fixer/rules/error-analysis.md | lint-error 카테고리 추가 | | 수정 | mcp-servers/error-context-analyzer/index.ts | parseLintOutput 도구 추가 | | 수정 | README.md | 서브에이전트 아키텍처 문서화 |

v1.1.0 — Deep Context Analysis + Cross-LLM 3계층 검증

error-fixer 에이전트에 8단계 Deep Context Analysis 추가
3계층 Cross-LLM 검증 프로토콜 (gemini-cli + openai-cli / pal-mcp-server / code-review-mcp)
context7 통합으로 외부 라이브러리 최신 문서 자동 조회
피드백 통합 전략 및 기획서 고도화

v1.0.0 — Initial Release

error-fixer, homepage-builder, go-home-reporter, obsidian-yaml-optimizer 4개 에이전트
error-context-analyzer, gemini-cli, openai-cli 3개 MCP 서버
기본 오류 분석 및 수정 파이프라인

라이선스

MIT

MCP Servers