Back to Details

analyst-common-stock

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

주식/ETF 분석 에이전트 공통 규칙

股票/ETF分析Agent通用规则

Overview

概述

이 스킬은 모든 주식/ETF 분석 에이전트(stock-screener, stock-valuation, bear-case-critic)가 공통으로 따라야 하는 규칙을 정의합니다.
핵심 목표: 환각(Hallucination) 방지
本Skill定义了所有股票/ETF分析Agent（stock-screener、stock-valuation、bear-case-critic）必须共同遵守的规则。
核心目标：防止幻觉（Hallucination）

1. 웹검색 도구 직접 호출 필수

1. 必须直接调用网页搜索工具

CRITICAL: 스킬은 "지침 문서"이지 "함수"가 아닙니다. 에이전트가 웹검색 도구를 직접 호출해야 합니다.
CRITICAL：本Skill是「指南文档」而非「函数」。 Agent必须直接调用网页搜索工具。

올바른 사용법

正确用法

1. stock-data-verifier 스킬에서 검색 쿼리 패턴 확인
2. exa_web_search_exa 또는 websearch_web_search_exa 직접 호출
   - 예: exa_web_search_exa(query="삼성전자 PER PBR site:finance.naver.com")
   - 예: websearch_web_search_exa(query="AAPL P/E ratio site:yahoo.com")
3. 검색 결과에서 숫자가 포함된 원문을 그대로 복사
4. 최소 2개 출처에서 값 확인 및 교차 검증
5. 출처 간 ±5% 이내 일치 시 사용, 불일치 시 FAIL
1. 在stock-data-verifier Skill中确认搜索查询模式
2. 直接调用exa_web_search_exa或websearch_web_search_exa
   - 示例：exa_web_search_exa(query="삼성전자 PER PBR site:finance.naver.com")
   - 示例：websearch_web_search_exa(query="AAPL P/E ratio site:yahoo.com")
3. 从搜索结果中直接复制包含数字的原文
4. 至少从2个来源确认数值并进行交叉验证
5. 来源间数值差异在±5%以内时可使用，不一致则标记为FAIL

필수 사항 (MUST)

必选要求（MUST）

  • exa_web_search_exa
    또는 
    websearch_web_search_exa
    직접 호출
  • 원문 인용 필수 - 숫자가 포함된 검색 결과 문장을 그대로 복사
  • 최소 2개 이상 독립 출처에서 교차 검증
  • 검색 결과의 URL과 날짜 명시
  • 출처 간 값이 일치하는지 확인 (±5% 이내)
  • 直接调用
    exa_web_search_exa
    或
    websearch_web_search_exa
  • 必须引用原文 - 直接复制搜索结果中包含数字的句子
  • 至少从2个以上独立来源进行交叉验证
  • 明确标注搜索结果的URL和日期
  • 确认来源间数值一致（±5%以内）

금지 사항 (NEVER)

禁止事项（NEVER）

금지이유
search_stock()
, 
search_metric()
같은 함수 호출		존재하지 않는 가짜 함수
스킬 문서의 예시 데이터 그대로 사용하드코딩된 오래된 값
웹검색 없이 데이터 사용검증 불가능한 환각
기억이나 추정에 의한 값 작성LLM 학습 데이터는 outdated
원문 없이 숫자만 보고환각 위험 극대화
禁止行为原因
调用
search_stock()
、
search_metric()
等函数		这些是不存在的虚假函数
直接使用Skill文档中的示例数据属于硬编码的陈旧数值
不进行网页搜索就使用数据数据无法验证，易产生幻觉
根据记忆或估算填写数值LLM的训练数据已过时
仅展示数字而不提供原文极大提升幻觉风险

2. 원문 인용 규칙 (CRITICAL)

2. 原文引用规则（CRITICAL）

환각 방지의 핵심: 검색 결과에서 숫자를 추출할 때 반드시 원문을 그대로 인용해야 합니다.
防止幻觉的核心：从搜索结果提取数字时，必须直接引用原文。

숫자 추출 방법

数字提取方法

1. 웹검색 결과에서 숫자가 포함된 문장 찾기
2. 해당 문장을 **그대로 복사** (original_text 필드에)
3. 원문에서 숫자 추출하여 value 필드에 기록
4. value와 original_text 내 숫자가 일치하는지 확인
1. 在网页搜索结果中找到包含数字的句子
2. **直接复制**该句子（存入original_text字段）
3. 从原文中提取数字并记录到value字段
4. 确认value与original_text中的数字一致

출력 형식 (필수)

输出格式（必选）

모든 수치 데이터는 다음 형식으로 보고해야 합니다:
json
{
  "value": 12.5,
  "original_text": "삼성전자 PER 12.5배 (2026.01.14 기준)",
  "source": "네이버 금융",
  "url": "https://finance.naver.com/item/main.naver?code=005930"
}
所有数值数据必须以以下格式报告：
json
{
  "value": 12.5,
  "original_text": "삼성전자 PER 12.5배 (2026.01.14 기준)",
  "source": "네이버 금융",
  "url": "https://finance.naver.com/item/main.naver?code=005930"
}

검증 규칙

验证规则

규칙설명위반 시
원문 필수
original_text
필드 없으면 무효		FAIL
숫자 일치
value
가 
original_text
내 숫자와 일치해야 함		FAIL
복사 금지이전 결과나 예시 값을 복사하면 안 됨FAIL
规则说明违规处理
必须包含原文无
original_text
字段则无效		FAIL
数字一致
value
必须与
original_text
中的数字一致		FAIL
禁止复制不得复制之前的结果或示例数值FAIL

예시

示例

올바른 예시:
json
{
  "metric": "PER",
  "value": 12.5,
  "original_text": "삼성전자의 PER은 12.5배로 업종 평균 대비 저평가 구간에 있습니다.",
  "source_url": "https://finance.naver.com/item/main.naver?code=005930"
}
잘못된 예시 (환각):
json
{
  "metric": "PER",
  "value": 15.0,
  "original_text": null,
  "source_url": "https://finance.naver.com/item/main.naver?code=005930"
}
-> 원문 없이 숫자만 보고하면 검증 불가능 = 환각
正确示例:
json
{
  "metric": "PER",
  "value": 12.5,
  "original_text": "삼성전자의 PER은 12.5배로 업종 평균 대비 저평가 구간에 있습니다.",
  "source_url": "https://finance.naver.com/item/main.naver?code=005930"
}
错误示例（幻觉）:
json
{
  "metric": "PER",
  "value": 15.0,
  "original_text": null,
  "source_url": "https://finance.naver.com/item/main.naver?code=005930"
}
-> 仅展示数字而不提供原文，数据无法验证 = 幻觉

3. 교차 검증 프로토콜

3. 交叉验证协议

검증 요구사항

验证要求

항목기준
최소 출처 수2개 이상
값 일치 허용 범위±5%
1차 출처공식 출처(네이버 금융, Yahoo Finance, 운용사 등) 1개 이상 권장
날짜 일치동일 거래일 데이터
项目标准
最少来源数量2个以上
数值一致允许范围±5%
一级来源推荐至少1个官方来源（如Naver Finance、Yahoo Finance、资产管理公司等）
日期一致同一交易日的数据

검증 절차

验证流程

Step 1: 첫 번째 출처에서 값 수집
        └─ exa_web_search_exa(query="...")
        
Step 2: 두 번째 출처에서 값 수집
        └─ exa_web_search_exa(query="... site:다른출처")
        
Step 3: 값 비교
        └─ 차이 = |값1 - 값2| / 평균값 * 100
        
Step 4: 판정
        └─ 차이 ≤ 5%: 검증 성공 (verified: true)
        └─ 차이 > 5%: 검증 실패, 추가 출처 검색 또는 FAIL
Step 1: 从第一个来源收集数值
        └─ exa_web_search_exa(query="...")
        
Step 2: 从第二个来源收集数值
        └─ exa_web_search_exa(query="... site:其他来源")
        
Step 3: 数值比较
        └─ 差异 = |数值1 - 数值2| / 平均值 * 100
        
Step 4: 判定
        └─ 差异 ≤5%: 验证通过（verified: true）
        └─ 差异 >5%: 验证失败，需搜索额外来源或标记为FAIL

검증 실패 시 처리

验证失败时的处理

검증 실패 시 절대 임의 수치를 생성하지 않습니다:
json
{
  "status": "FAIL",
  "failed_items": ["PER"],
  "reason": "교차 검증 실패 - 출처 간 값 불일치",
  "detail": {
    "source1": {"name": "네이버 금융", "value": 12.5},
    "source2": {"name": "Yahoo Finance", "value": 14.8},
    "variance": "18.4%"
  }
}
验证失败时绝对不能随意生成数值:
json
{
  "status": "FAIL",
  "failed_items": ["PER"],
  "reason": "交叉验证失败 - 来源间数值不一致",
  "detail": {
    "source1": {"name": "네이버 금융", "value": 12.5},
    "source2": {"name": "Yahoo Finance", "value": 14.8},
    "variance": "18.4%"
  }
}

4. 검증 체크리스트 (MANDATORY)

4. 验证检查表（MANDATORY）

모든 분석 에이전트는 결과 제출 전 아래 체크리스트를 확인해야 합니다.
所有分析Agent在提交结果前必须确认以下检查表。

웹검색 직접 호출 확인

网页搜索直接调用确认

  • exa_web_search_exa
    또는 
    websearch_web_search_exa
    를 직접 호출했는가?
  • search_stock()
    , 
    search_metric()
    같은 가짜 함수를 호출하지 않았는가?
  • 스킬 예시 데이터를 그대로 사용하지 않았는가?
  • 是否直接调用了
    exa_web_search_exa
    或
    websearch_web_search_exa
    ？
  • 是否未调用
    search_stock()
    、
    search_metric()
    等虚假函数？
  • 是否未直接使用Skill示例数据？

원문 인용 확인

原文引用确认

  • 모든 수치에 
    original_text
    필드가 있는가?
  • value
    가 
    original_text
    내 숫자와 일치하는가?
  • 이전 결과나 예시 값을 복사하지 않았는가?
  • 所有数值是否都包含
    original_text
    字段？
  • value
    是否与
    original_text
    中的数字一致？
  • 是否未复制之前的结果或示例数值？

교차 검증 확인

交叉验证确认

  • 모든 수치에 최소 2개 출처가 있는가?
  • 출처 간 값이 ±5% 이내로 일치하는가?
  • 모든 값에 출처 URL이 포함되어 있는가?
  • 所有数值是否都有至少2个来源？
  • 来源间数值差异是否在±5%以内？
  • 所有数值是否都包含来源URL？

실패 처리 확인

失败处理确认

  • 교차 검증 실패 시 FAIL 목록에 추가했는가?
  • 추정값을 생성하지 않았는가?
  • 交叉验证失败时是否已添加到FAIL列表？
  • 是否未生成估算数值？

5. 허용 출처 (Allowlist)

5. 允许来源（Allowlist）

Tier 1: 공식 출처 (1개 이상 권장)

Tier 1: 官方来源（推荐至少1个）

한국 주식/ETF

韩国股票/ETF

데이터출처URL
주식 시세/지표네이버 금융finance.naver.com
주식 시세KRXdata.krx.co.kr, kind.krx.co.kr
공시 정보DARTdart.fss.or.kr
ETF 정보삼성자산운용samsungfund.com
ETF 정보미래에셋자산운용miraeassetfund.co.kr
数据来源URL
股票行情/指标Naver Financefinance.naver.com
股票行情KRXdata.krx.co.kr, kind.krx.co.kr
公示信息DARTdart.fss.or.kr
ETF信息三星资产管理samsungfund.com
ETF信息未来资产资产管理miraeassetfund.co.kr

미국 주식/ETF

美国股票/ETF

데이터출처URL
주식 시세/지표Yahoo Financefinance.yahoo.com
주식 시세Bloombergbloomberg.com
주식 분석MarketWatchmarketwatch.com
ETF 정보ETF.cometf.com
ETF 정보BlackRock (iShares)ishares.com
ETF 정보Vanguardvanguard.com
数据来源URL
股票行情/指标Yahoo Financefinance.yahoo.com
股票行情Bloombergbloomberg.com
股票分析MarketWatchmarketwatch.com
ETF信息ETF.cometf.com
ETF信息BlackRock (iShares)ishares.com
ETF信息Vanguardvanguard.com

Tier 2: 교차검증 출처

Tier 2: 交叉验证来源

출처URL커버리지
Seeking Alphaseekingalpha.com미국 주식 분석
Morningstarmorningstar.com펀드/ETF 분석
삼성증권securities.samsung.com한국 주식
미래에셋증권securities.miraeasset.com한국 주식
来源URL覆盖范围
Seeking Alphaseekingalpha.com美国股票分析
Morningstarmorningstar.com基金/ETF分析
三星证券securities.samsung.com韩国股票
未来资产证券securities.miraeasset.com韩国股票

Tier 3: 보조 출처

Tier 3: 辅助来源

출처URL용도
한국경제hankyung.com한국 주식 뉴스
매일경제mk.co.kr한국 주식 뉴스
Reutersreuters.com글로벌 주식 뉴스
Financial Timesft.com글로벌 금융 분석
来源URL用途
韩国经济hankyung.com韩国股票新闻
每日经济mk.co.kr韩国股票新闻
Reutersreuters.com全球股票新闻
Financial Timesft.com全球金融分析

Blocklist (금지)

Blocklist（禁止）

  • 개인 블로그
  • 위키피디아 (실시간 데이터용)
  • 커뮤니티 사이트 (네이버 카페, 디시인사이드, Reddit 등)
  • YouTube
  • 신뢰도 미검증 사이트
  • 个人博客
  • 维基百科（实时数据用途）
  • 社区网站（如Naver Cafe、DC Inside、Reddit等）
  • YouTube
  • 未验证可信度的网站

메타 정보

元信息

yaml
version: "1.0"
created: "2026-01-20"
purpose: "주식/ETF 분석 에이전트 공통 규칙 통합 - 코드 중복 제거"
based_on: "investments-portfolio/skills/analyst-common (±1% → ±5% 조정)"
consumers:
  - stock-screener
  - stock-valuation
  - bear-case-critic
extracted_from:
  - "웹검색 도구 직접 호출 필수 섹션"
  - "원문 인용 규칙 섹션"
  - "교차 검증 프로토콜"
  - "Verification Checklist"
dependencies:
  - exa_web_search_exa
  - websearch_web_search_exa
  - WebFetch
key_difference:
  - "investments-portfolio: ±1% 교차검증 (거시경제 지표용)"
  - "stock-consultation: ±5% 교차검증 (주식 데이터는 변동성 높음)"
yaml
version: "1.0"
created: "2026-01-20"
purpose: "주식/ETF 분석 에이전트 공통 규칙 통합 - 코드 중복 제거"
based_on: "investments-portfolio/skills/analyst-common (±1% → ±5% 조정)"
consumers:
  - stock-screener
  - stock-valuation
  - bear-case-critic
extracted_from:
  - "웹검색 도구 직접 호출 필수 섹션"
  - "원문 인용 규칙 섹션"
  - "교차 검증 프로토콜"
  - "Verification Checklist"
dependencies:
  - exa_web_search_exa
  - websearch_web_search_exa
  - WebFetch
key_difference:
  - "investments-portfolio: ±1% 교차검증 (거시경제 지표용)"
  - "stock-consultation: ±5% 교차검증 (주식 데이터는 변동성 높음)"