company-analysis

Company Analysis

AI-native company research skill for coding agents. Korean reports, source verification, and three parallel research agents.

AI Level을 먼저 판정하고, Level 4·5 기업만 세 개의 독립 에이전트가 ANS 기준에 맞춰 조사하는 한국어 기업 분석 스킬입니다. 메인은 세 조사본을 검증한 뒤 ANS 최종 평가와 통합 원고를 작성합니다. Level 1·2·3은 제외하고, 판단 근거가 부족하면 보류 사유와 필요한 자료를 알린 뒤 멈춥니다.

이 폴더 전체가 배포 단위입니다. 개인 경로, 특정 모델, 특정 에이전트 도구 이름, API 키 설정을 포함하지 않습니다. Agent Skills 형식을 사용하며, 실행은 설치한 호스트의 도구로 수행합니다.

설치 방법 · 전체 워크플로우 · 생성되는 파일

필요한 기능

• 웹 검색과 원문 페이지 열기
• 참조 문서 읽기와 Markdown 파일 저장
• 상세 분석 시 세 개의 독립 서브에이전트를 병렬 실행하고 결과 회수

파일시스템을 공유하지 않는 호스트에서는 메인이 자료 전문을 전달하고, 에이전트가 반환한 문서 전문을 파일로 저장합니다. 실행 중 메시지가 없으면 재판정 근거를 찾은 에이전트가 조기 종료 응답으로 보고합니다. 취소·재개 기능의 차이는 스킬 본문에서 처리합니다.

서브에이전트 기능이 없거나 사용이 금지된 환경에서는 상세 분석을 멈춥니다. 이 스킬을 설치한다고 호스트의 도구나 권한이 추가되지는 않습니다. 일반 채팅에 문서만 붙여 넣는 것은 동일한 병렬 조사 실행을 보장하지 않습니다.

빠른 설치

Skills CLI로 설치할 수 있습니다. Node.js와 npm이 있는 터미널에서 실행하고 사용할 에이전트와 설치 범위를 선택하세요.

npx skills add lpshi2002/company-analysis

개인 스킬로 특정 에이전트에 설치하려면:

# Claude Code
npx skills add lpshi2002/company-analysis -g -a claude-code

# Codex
npx skills add lpshi2002/company-analysis -g -a codex

설치할 스킬만 확인하려면:

npx skills add lpshi2002/company-analysis --list

CLI 없이 설치하려면 아래 수동 설치 방법을 사용하세요.

수동 설치

저장소를 복제합니다.

git clone https://github.com/lpshi2002/company-analysis.git

복제한 company-analysis/ 폴더 전체를 사용하는 도구의 스킬 디렉터리로 복사합니다. SKILL.md만 복사하면 참조 자료가 누락됩니다.

호스트	개인 설치 위치	호출 예시
Codex	~/.agents/skills/company-analysis/	$company-analysis https://기업공식주소
Claude Code	~/.claude/skills/company-analysis/	/company-analysis https://기업공식주소
다른 Agent Skills 호스트	해당 호스트의 스킬 디렉터리	해당 호스트의 호출 방식

프로젝트 한 곳에서만 사용하려면 프로젝트의 .agents/skills/ 또는 .claude/skills/ 아래에 설치할 수 있습니다. 플랫폼별 설치·호출 예시는 안내일 뿐 조사 본문의 의존성이 아닙니다.

macOS/Linux에서 복제된 company-analysis/ 폴더의 상위 디렉터리에서 실행하는 예시입니다. 사용할 호스트의 블록만 실행합니다. 기존 설치가 있으면 덮어쓰지 않고 멈춥니다.

Codex:

mkdir -p "$HOME/.agents/skills"
if [ -e "$HOME/.agents/skills/company-analysis" ] || [ -L "$HOME/.agents/skills/company-analysis" ]; then
  echo '기존 company-analysis 설치가 있습니다. 백업한 뒤 교체하세요.'
else
  cp -R company-analysis "$HOME/.agents/skills/company-analysis"
fi

Claude Code:

mkdir -p "$HOME/.claude/skills"
if [ -e "$HOME/.claude/skills/company-analysis" ] || [ -L "$HOME/.claude/skills/company-analysis" ]; then
  echo '기존 company-analysis 설치가 있습니다. 백업한 뒤 교체하세요.'
else
  cp -R company-analysis "$HOME/.claude/skills/company-analysis"
fi

이전에 다른 개인·프로젝트 경로에 같은 이름을 설치했다면 중복 등록되지 않도록 기존 설치 위치도 확인하세요. 인식 여부는 호스트의 스킬 목록에서 확인합니다. Windows에서는 폴더를 사용자 홈 아래 해당 위치로 복사하거나 호스트의 설치 기능을 사용합니다.

사용

company-analysis로 https://기업공식주소 를 분석해줘.
기준일은 오늘로 하고, Level 4·5 통과 기업만 상세 분석해줘.

기본 저장 위치는 실행 작업공간의 outputs/company-analysis/<company-slug>-<YYYY-MM-DD>/입니다. 별도 저장 위치와 조사 기준일을 지정할 수 있습니다.

통과 시 사전 판정본, 에이전트 조사본 3개, 통합 발표용 원고를 생성합니다. 제외·보류 시 사전 판정본과 사유만 전달합니다. ANS 숫자 점수는 사용자가 요청하고 필요한 배점이 제공됐을 때만 산출합니다. 현재 네 평가 영역의 가중치와 세부 배점은 미정입니다.

단계별 자료 로딩

스킬 시작 시에는 공통 근거 규칙과 AI Level 선별 지침만 읽습니다. 제외·보류 기업을 위해 상세 조사 프롬프트나 최종 원고 양식까지 미리 읽지 않습니다.

단계	메인의 참조 자료
사전 선별	evidence-rules.md + screening.md
Level 4·5 통과 후 조사 배정	ans-framework.md 전체 + agent-prompts.md
결과 회수 후 독립 검증·평가·통합	output-template.md

세 조사 에이전트는 공통 근거 규칙, Level 기준, ANS 기준 전체와 자기 역할의 업무 계약을 읽습니다. ANS 기준을 통합 단계까지 미루지 않습니다. 메인이 이미 읽었다는 이유로 새 에이전트의 읽기를 생략하지 않으며, 지침 재독을 줄이는 것과 원출처 독립 재검증은 구분합니다. 사용자 지정 자료의 필독 요구와 분석 기준, 세 독립 조사 및 재판정·보완 절차는 유지합니다.

전체 워크플로우

사용자는 기업명이나 공식 URL을 입력합니다. 메인 에이전트가 먼저 AI Level을 판정하고, Level 4·5로 확인된 기업에만 ANS 항목을 배정해 세 개의 조사 에이전트를 병렬 실행합니다. 메인 에이전트는 현재 대화를 진행하는 AI이며, 서브에이전트는 서로 다른 조사 범위를 맡는 독립 작업입니다.

flowchart TD
    A[기업명 또는 공식 URL 입력] --> B[메인: 대상 확인 및 AI Level 사전 판정]
    B --> C{판정 결과}
    C -->|Level 1·2·3| D[제외 근거와 사전 판정본 전달 후 종료]
    C -->|판정 보류| E[부족한 근거와 필요한 자료 전달 후 종료]
    C -->|Level 4·5| F[ANS 항목 배정 후 세 독립 에이전트 병렬 조사]
    F --> G[1번: 기업·창업자·경쟁환경]
    F --> H[2번: 실제 AI 활용·Level 재검증]
    F --> I[3번: 투자·시장·재무·Exit 근거]
    G --> J[메인: 결과 회수·누락 보완·원출처 재검증]
    H --> J
    I --> J
    J --> K{Level 4·5 통과 유지?}
    K -->|아니오| L[사전 판정 갱신 및 제외·보류 안내 후 종료]
    K -->|예| N[메인: 전체 근거로 ANS 최종 평가]
    N --> M[통합 발표용 조사 Markdown 작성·최종 검수]

그림은 정상적인 결과 회수 흐름입니다. 조사 중 통과 판정을 뒤집는 근거가 도착하면 세 작업이 모두 끝나기 전이라도 메인이 재판정합니다. 도구 제한이나 보완 후에도 남은 조사 누락은 기업의 Level 판정과 구분해 안내하고 중단합니다.

1. 기업과 조사 범위 확인

기업명만 입력하면 메인이 공식 URL과 정확한 대상을 확인합니다. 동명기업 등으로 대상이 불명확하면 구분 정보를 확인합니다. 현재·이전 사명과 조사 기준일을 정하고, 사용자가 제공한 방법론·자료가 있으면 읽습니다. 기업이 명확하면 불필요한 재확인 없이 진행합니다.

조사 대상은 매번 새로 입력한 기업입니다. 과거 다른 기업의 조사본은 조사 방식만 참고하고, 그 기업의 사실·수치·출처를 새 대상에 옮기지 않습니다. 저장 위치는 사용자가 지정할 수 있습니다.

2. 메인 에이전트가 AI Level 사전 판정

이 단계에서는 아직 세 조사 에이전트를 실행하지 않습니다. 메인이 공식 제품·기술 자료, 창업 배경, 경영진·엔지니어의 설명과 실제 운영 사례를 직접 열어 다음 기준을 검토합니다.

분류·Level	기준
AI-Zero (Level 1)	AI를 활용하지 않는 기업
AI-Tooled (Level 2)	AI를 검색·조회·요약·코딩 등의 도구로 사용하는 기업
AI-Core (Level 3)	AI가 핵심 업무를 담당하는 회사
AI-Native (Level 4)	AI를 전제로 사업모델과 워크플로우를 설계한 기업
AI-Orchestrated (Level 5)	AI가 전사 핵심 기능을 담당하고 사람은 목표·제약·예외만 관리하는 단계

Level 2·3의 활동이 확인돼도 바로 제외하지 않습니다. Level 4·5 기업도 검색·요약·코딩을 할 수 있으므로, 더 높은 단계에 해당하는지까지 조사합니다.

• 기존 사업에 AI 기능이나 자동화를 단순히 추가한 정도는 Level 4로 인정하지 않습니다. 사업모델과 핵심 워크플로우를 AI 전제로 완전히 새롭게 재설계한 경우는 전후 구조·시점·실제 운영 근거를 확인한 뒤 검토합니다.
• 일부 제품·부서·파일럿이나 향후 계획을 회사 전체의 수준으로 확대하지 않습니다. “AI-native”라는 자기소개만으로 통과시키지 않습니다.
• 사람의 승인 절차가 있다는 이유만으로 탈락시키지 않습니다. 사람이 실제로 맡는 일과 AI의 실행 범위를 확인합니다.
• 자료가 없다는 이유로 Level 1로 판단하거나, Level 4·5가 불명확하다는 이유로 Level 3으로 확정하지 않습니다.

사전 판정 결과	다음 행동
Level 4·5 확인	사전 판정본을 저장하고 상세 분석 진행
Level 4는 확인, Level 5만 불명확	Level 4로 통과하고 Level 5의 미확인 범위를 명시
Level 4·5까지 검토한 결과 Level 1·2·3으로 판정	제외 근거·출처·사전 판정본을 전달하고 종료
Level 4·5 여부를 가를 근거 부족 또는 핵심 출처 충돌	판정 보류 사유·확인된 사실·필요 자료를 전달하고 종료

제외·보류 기업은 투자·경쟁사·ANS·Exit 상세 분석과 통합 원고 작성을 시작하지 않습니다. 보류 후 추가 자료가 오면 사전 판정부터 재개합니다. 상세 기준은 AI Level·ANS 기준에 있습니다.

3. ANS 항목을 배정하고 세 에이전트가 병렬 조사

메인은 동일한 기업·기준일·사전 판정본·사용자 자료·출처 검증 규칙과 ANS 담당 항목을 세 에이전트에 전달합니다. 각 에이전트는 처음부터 담당 ANS 질문에 맞춰 원문을 조사하고, 기존 기업 조사 내용과 함께 지지·반대 근거·미확인 범위·직접 출처를 표로 정리합니다. 각자 맡은 문서 하나만 작성하며 최종 ANS 판정·점수는 내리지 않습니다.

담당	무엇을 조사하는가	결과 파일
1번: 기업·창업자·경쟁환경	창업 배경과 피벗, 초기·현재 사업모델, AI 전제 설계 이력, 창업자의 기술·인재 영입·사업 역량, 고객과 수익원, 현재 규모, 직접·대체재·잠재·인접 경쟁사, 차별점. ANS 창업자·경쟁해자 여섯 질문 근거	01-company-founders.md
2번: 실제 AI 활용·Level 재검증	핵심 업무의 입력→처리→출력, AI 시스템별 기술·역할·실행 범위, 실제 배포와 데모·계획의 구분, 사람의 검토·승인·예외처리, 정확도·자동완료율·시간·비용 등의 공개 수치, Level 4·5 근거 재검증. ANS AI 기술 여섯 질문·실제 운영·효율 근거	02-ai-operations.md
3번: 투자·시장·공개 재무·Exit	전체 투자 라운드·투자자별 이유, 미래산업·TAM·공개 ARR·성장, 마진 경로, 유사 IPO·M&A와 입력이 확인되는 Exit 배수·회수 수치. ANS 투자 신호·미래산업·공개 재무 근거	03-investors-ans.md

ANS 기준에 따른 조사는 세 에이전트가 나눠 수행하고, ANS 최종 평가는 전체 결과를 검증한 메인만 수행합니다. 별도 네 번째 평가 에이전트는 만들지 않습니다. 03-investors-ans.md의 ANS는 평가용 근거라는 의미이며 전체 평가 결과가 아닙니다. AI Level은 분석 대상 선별 기준이고, ANS는 통과 기업의 종합 평가 기준입니다.

ANS 영역	전체 비중	주요 평가 내용
AI 기술 기준	미정	모델 교체 설계·공급사 동일 기능 대응·실제 교체 이력, 복제하기 어려운 기술·서비스/파트너 연결·특정 분야 인재/기술 역량
경쟁해자	미정	경쟁사 대비 고객 도입·확대, 업무시스템 통합, 반복 사용 증거, 직접 경쟁사·대체재·잠재 경쟁사 비교
정성 신호	미정	대형 VC의 두 조건, 창업자의 확신·능력, 지정 미래산업과 비중
공개 재무 대리지표	미정	새 문서에 세부 기준이 없어 기존 최근 펀딩·TAM·공개 ARR·성장 조사를 유지

메인은 검증 후 기본 평가를 확인 / 부분 확인 / 판단 불가 / 불충족으로 제시합니다. 숫자 점수를 요청받아도 배점이 미정이면 가중 총점은 산출하지 않습니다. 높은 투자금이나 ANS 평가로 선별을 대신하지 않습니다. 각 에이전트의 전체 업무 계약은 에이전트 프롬프트에 있습니다.

4. 결과 회수와 누락·판정 변경 처리

메인은 각 결과를 받으면 사전 통과 판정을 뒤집는 근거부터 확인합니다. 제외·보류로 바뀌면 사전 판정본을 갱신하고 상세 분석을 중단합니다. 취소할 수 없는 작업의 결과도 최종 원고에 통합하지 않습니다.

통과가 유지되면 세 조사본을 모두 회수합니다. 실패하거나 빈 결과가 있으면 누락 항목을 지정해 한 번 보완합니다. 같은 에이전트를 재개할 수 없으면 동일 자료·업무·기존 결과를 새 독립 에이전트에 전달합니다. 보완 후에도 조사 자체가 누락되면 분석 미완료와 누락 항목을 알리고 멈추며, 메인이 추측으로 채우지 않습니다. 조사를 했지만 공개자료가 없는 항목은 조사 누락과 구분해 최종 평가에서 판단 불가로 남깁니다.

5. 메인이 원출처를 독립 재검증

메인은 세 조사본을 단순히 이어 붙이지 않습니다. 핵심 주장과 수치를 뒷받침하는 원문을 직접 다시 열고 다음을 확인합니다.

• 기업·AI: 창업자와 사업모델, Level 4·5 판정 근거, AI 시스템의 실제 운영 범위, 사람의 역할
• 수치: 정확한 지표명·단위·대상·분모·측정 시점과 회사 자체 평가·독립 검증의 구분
• 투자: 라운드 종결 여부, 투자 참여와 투자자 본인이 직접 설명한 투자 이유의 구분
• 경쟁사·Exit: 경쟁사 선정과 차별점의 근거, IPO·M&A의 지분가치와 기업가치(EV), 재무분모의 기간·정의와 배수 산식

출처가 주장을 직접 지지하지 않으면 문장을 약화하거나 삭제합니다. 서로 다른 에이전트가 같은 내용을 썼다는 이유만으로 사실로 인정하지 않습니다. Exit 계산에 필요한 입력이 없으면 배수 산출 불가로 남기고, 유사기업의 배수를 조사 대상의 적정가치로 단정하지 않습니다. 세부 규칙은 근거와 출처 검증을 따릅니다.

6. 메인이 ANS 전체 항목을 최종 평가

세 조사본의 검증·보완을 마친 뒤 메인이 네 평가 영역을 종합 평가합니다. 1번의 창업자·경쟁해자 근거, 2번의 AI 기술 여섯 질문과 실제 운영 근거, 3번의 VC·산업·재무 근거를 연결합니다. 한 조사본만으로 판정하거나 에이전트별 점수를 평균 내지 않습니다.

각 질문에 관련 조사본·원출처, 지지·반대 근거, 한계, 최종 판정을 표시합니다. AI 기술과 경쟁해자는 각각 여섯 질문을 따로 평가하며, 기술 연결 기반의 존재와 경쟁사 대비 업무시스템 통합의 깊이를 구분합니다.

• 대형 VC: 조사 기준일로 최근 3년 내 단일 US$500M 이상 펀드 조성과 최근 5년 내 US$1B 이상 IPO·M&A Exit를 모두 확인합니다. 대상 기업 투자 참여도 별도로 검증합니다.
• 창업자: 아이디어·제품에 대한 확신과 회사를 이끌 능력을 구분합니다. 이전 창업·Series B 이상 성장, AI 제품·논문·특허·코드 기여, 핵심 인재 합류, 문제·제품 지식을 확인합니다.
• 미래산업: 바이오·헬스케어 30%, 기후 & 지속가능성 25%, AI 인프라 20%, AI 데이터 15%, 금융·보험·회계 10%입니다. 복수 산업 비중을 자동 합산하거나 기업 점수로 환산하지 않습니다.
• 공개 재무·보조 실사: 새 문서에 공개 재무 세부 기준이 없어 기존 펀딩·TAM·공개 ARR·성장 조사를 유지합니다. 효율·마진·Exit·회수 계산은 입력이 있을 때만 보조 실사로 다루고 임의 통과선을 추가하지 않습니다.

최종 결과는 통합 원고의 ANS 섹션에 들어갑니다. 가중치·세부 배점이 미정이면 범주형 판정을 완성하고 총점 산출 불가를 표시합니다. 전체 질문과 출처·조사 담당은 ANS 평가 방법론을 따릅니다.

7. 최종 발표용 조사 원고 작성과 검수

메인 에이전트가 ANS 최종 평가를 포함해 최종 통합본을 작성합니다. 결과는 한국어 Markdown 조사 원고이며, 슬라이드 파일 자체를 만드는 단계는 포함하지 않습니다.

최종 원고에는 기업·창업자·사업모델, 경쟁환경과 차별점, AI Level과 실제 AI 활용, ANS 전체 평가, 자금조달과 투자자별 이유, 유사 IPO·M&A·Exit 배수, 핵심 사실 확인표, 다음 실사 항목이 들어갑니다. 핵심 주장 옆 인라인 출처와 마지막 원출처 목록을 함께 제공합니다.

제출 전에는 Level·ANS 항목 누락, 수치의 단위·시점·출처, 출처 충돌, 미확인 사항, 과장된 결론을 검수하고 오류를 수정합니다. 상세 구성은 보고서 양식과 검수표에 있습니다.

생성되는 파일

기본 저장 위치는 outputs/company-analysis/<company-slug>-<YYYY-MM-DD>/입니다. 아래는 상세 분석이 완료됐을 때의 구성입니다.

outputs/company-analysis/<company-slug>-<YYYY-MM-DD>/
├── 00-ai-level-screening.md
├── 01-company-founders.md
├── 02-ai-operations.md
├── 03-investors-ans.md
└── <company-slug>-통합-발표용-조사-<YYYY-MM-DD>.md

사전 선별에서 제외·보류되면 00-ai-level-screening.md만 작성합니다. 상세 조사 도중 재판정되거나 분석 미완료로 멈춘 경우 중간 문서가 남을 수 있지만, 완료된 통합 원고로 제공하지 않습니다.

파일 구성

• SKILL.md: 실행 흐름·환경 차이·중단 규칙
• references/screening.md: AI-native 분류·경계·선별, 사전 판정 양식과 검수
• references/ans-framework.md: 통과 기업의 ANS 네 영역·담당표·미정 배점 및 채점 규칙
• references/agent-prompts.md: 세 조사 에이전트의 업무 계약
• references/evidence-rules.md: 원출처·주장·수치 검증
• references/output-template.md: 메인 원출처 재검증·ANS 최종 평가·통합 보고서 양식과 검수
• agents/openai.yaml: 선택적 Codex 표시 정보와 기본 호출 예시
• LICENSE: MIT 사용·수정·재배포 조건

agents/openai.yaml은 설치본과 동일한 Codex 표시 정보입니다. 특정 모델·도구·API 키를 지정하지 않으며, 이를 사용하지 않는 호스트에서도 본문과 참조문서로 실행할 수 있습니다. 플러그인 매니페스트와 모델 고정 설정은 포함하지 않습니다.

호환성 범위

Agent Skills 문서 구조, 참조 링크와 Codex·Claude Code 설치를 검증했습니다. 모든 호스트의 실제 기업 조사 성공을 보증하지 않습니다. 실행 품질은 모델·웹 접근·서브에이전트 기능·권한에 따라 달라집니다.

설치 규칙 출처: Codex 스킬 문서, Claude Code 스킬 문서.

License

MIT. 사용·수정·재배포할 수 있습니다.