Community라이팅 & 에디팅github.com

alex-jb/shadow-mentor

Shadow — 온디바이스 AI 협의회 및 규제 은행 업무 감사 체인. 하나의 엔진, 4개의 디바이스 클라이언트, 5개의 페르소나 팩.

shadow-mentor란 무엇인가요?

Shadow Mentor는 규제된 대출 업무를 위해 설계된 5-음성 AI 규정 준수 협의회입니다. 이 스킬은 Claude Desktop, Cursor, Zed, OpenCode, OpenClaw와 같은 주요 AI 에이전트 플랫폼에서 MCP를 통해 실행되며, 중간 규모 미국 은행에 규정 준수 책임자 좌석당 연간 1,800달러에 제공됩니다. Shadow는 LLM 채팅을 조달 부서가 방어할 수 있는 대출 실행 규정 준수 표면으로 변환하는 6개의 MCP 도구 세트를 제공합니다. 주요 기능으로는 5-음성 협의회(차단/에스컬레이션/승인 판결), 기관 위험 프리미티브(VaR, 예상 손실, 집중도 측정), 교차 세션 메모리 복원, 개인별 Brier 보정 통계, 시나리오 열거, 그리고 모든 임계값에 대한 소스 출처 추적이 있습니다. 모든 도구는 프로세스 내에서 실행되어 네트워크 호출 없이 작동하며, CFPB, ECOA, SR 26-2 규정을 준수합니다. Shadow는 MCP STDIO 공급망 위협, MCPTox 프롬프트 인젝션, MosaicLeaks 다중 턴 정보 유출 같은 2026년 MCP 보안 위협에 대해 방어하며, 308개의 테스트를 통과하고 Shadow Agentic Score 87 ± 3을 기록했습니다.

지원 대상✓Claude Code~Codex CLI✓Cursor✓Antigravity✓OpenCode
npx skills add alex-jb/shadow-mentor

Installed? Explore more 라이팅 & 에디팅 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

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

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

문서

shadow-mentor은(는) 무엇을 하나요?

규제된 대출을 위한 5-음성 AI 규정 준수 협의회. Claude Desktop / Cursor / Zed / OpenCode / OpenClaw에 MCP를 통해 드롭인하여 사용하세요. 중간 규모 미국 은행 제안: 규정 준수 책임자 좌석당 연간 1,800달러. 오픈 소스 MIT.

기능

LLM 채팅을 조달 부서가 방어할 수 있는 대출 실행 규정 준수 표면으로 변환하는 여섯 개의 MCP 도구:

  • shadow_loan_council — 결정론적 5-음성 판결(차단 / 에스컬레이션 / 승인) + 음성별 근거 + 위험 패킷 + 적용된 임계값. FICO < 700은 고정된 테스트와 함께 하드코딩된 if 문입니다.
  • shadow_risk_tools — 기관 위험 프리미티브: VaR(역사적 / 파라메트릭 / 몬테카를로), 예상 손실, 집중도(HHI / 지니), 섹터 노출, 상관관계(피어슨 / 스피어만 / EWMA), 팩터 노출, 베타 분해
  • shadow_recall — 페르소나 + 시나리오로 키가 지정된 교차 세션 메모리 복원
  • shadow_calibration — 페르소나별 Brier 보정 통계(SR 26-2 모델 위험 모니터링용)
  • shadow_scenarios — 표면 열거(5 페르소나 × 4 시나리오 × 4 디바이스 클라이언트 × 2 공급자)
  • shadow_traceability — CFPB / ECOA / SR 26-2에 따른 모든 임계값(BRD vs 부록 vs 위험 선호도 노트)에 대한 소스 출처 속성

모든 도구는 프로세스 내에서 실행됩니다. 도구 본문 내부에서 네트워크 호출이 없습니다. AA01–AA05 불이익 조치 코드는 CFPB 게시판 2024-09를 준수합니다.

은행 조달 부서가 10분 안에 검토할 수 있는 이유

세 개의 소스 파일 + 네 개의 테스트 파일:

  1. lib/audit-guardrail.js — 12-패턴 정규식 출력 게이트(스키마 계층 안전성)
  2. lib/run-loan-council.js — if (loan.fico < CREDIT_THRESHOLDS.FICO_FLOOR) return { verdict: "block", ... }(결정론적 최소값)
  3. installer/tools.json — 고정된 설치 대상 × 범위 카탈로그(EMA 대비)

테스트 표면:

  • test/mcptox-canary.test.js — MCPTox §3 공격 카테고리 + MosaicLeaks 적용 범위를 다루는 28개의 계약 테스트
  • test/oauth-scaffold.test.js + test/oauth-loan-council-wiring.test.js — 엔터프라이즈 관리 인증 범위 카탈로그 + 라이브 배선
  • test/glm-call.test.js — 다중 공급자 계약(Anthropic + GLM-5.2)
  • test/tools-catalog.test.js — 카탈로그 표류 게이트

308/308 테스트 통과. Shadow Agentic Score 87 ± 3 (n=6).

빠른 설치

git clone https://github.com/alex-jb/shadow-mentor
cd shadow-mentor
npm install
node bin/install.mjs                          # 감지된 MCP 호스트 확인
node bin/install.mjs --host cursor --dry-run  # 병합된 설정 미리보기
node bin/install.mjs --host cursor            # 쓰기

명명된 2026 MCP 위협 방어

  • OX Security MCP STDIO 공급망 권고(2026년 5월) — Shadow의 도구 본문은 frozen lib/ 모듈만 호출합니다. 신뢰할 수 없는 셸 입력이 도구 본문에 도달하지 않습니다.
  • MCPTox 벤치마크(arXiv 2508.14925) — Shadow는 엄격한 JSON 열거형 판결을 반환하며, 서술형이 아닙니다. 오염된 설명이 스키마를 넘어 응답 표면을 확장할 수 없습니다.
  • MosaicLeaks 다중 턴 정보 유출 — canary-토큰 계약 테스트는 공격자가 도구 경계를 넘어 canary를 유출할 수 없다는 불변성을 고정합니다.
  • MCP 엔터프라이즈 OAuth(EMA) — 옵트인 SHADOW_REQUIRE_BEARER=1는 /api/loan-council에 shadow:council 범위를 적용합니다. OAuth2 / Azure AD 클레임 형식과 함께 작동합니다.

링크

관련 스킬