Back to Details

analyst-common

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

분석 에이전트 공통 규칙

分析Agent通用规则

Overview

概述

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

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

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

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

올바른 사용법

正确用法

1. web-search-verifier 스킬에서 검색 쿼리 패턴 확인
2. mcp_websearch_web_search_exa 직접 호출
   - 예: mcp_websearch_web_search_exa(query="S&P 500 price today")
   - 예: mcp_websearch_web_search_exa(query="한국은행 기준금리")
3. 검색 결과에서 숫자가 포함된 원문을 그대로 복사
4. 최소 3개 출처에서 값 확인 및 교차 검증
5. 출처 간 ±1% 이내 일치 시 사용, 불일치 시 FAIL
1. 在web-search-verifier Skill中确认搜索查询模式
2. 直接调用mcp_websearch_web_search_exa
   - 示例：mcp_websearch_web_search_exa(query="S&P 500 price today")
   - 示例：mcp_websearch_web_search_exa(query="한국은행 기준금리")
3. 从搜索结果中直接复制包含数字的原文
4. 至少从3个来源确认数值并进行交叉验证
5. 来源间数值差异在±1%以内时可使用，不一致则标记为FAIL

필수 사항 (MUST)

必须遵守事项（MUST）

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

금지 사항 (NEVER)

禁止事项（绝对不能做）

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

2. 원문 인용 규칙 (CRITICAL)

2. 原文引用规则（重要）

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

숫자 추출 방법

数字提取方法

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

출력 형식 (필수)

输出格式（必须遵守）

모든 수치 데이터는 다음 형식으로 보고해야 합니다:
json
{
  "value": 6936,
  "original_text": "The US500 fell to 6936 points on January 12, 2026",
  "source": "Trading Economics",
  "url": "https://tradingeconomics.com/united-states/stock-market"
}
所有数值数据必须以以下格式报告：
json
{
  "value": 6936,
  "original_text": "The US500 fell to 6936 points on January 12, 2026",
  "source": "Trading Economics",
  "url": "https://tradingeconomics.com/united-states/stock-market"
}

검증 규칙

验证规则

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

예시

示例

올바른 예시:
json
{
  "index": "S&P 500",
  "value": 6936,
  "original_text": "The main stock market index of United States, the US500, fell to 6936 points on January 12, 2026",
  "source_url": "https://tradingeconomics.com/united-states/stock-market"
}
잘못된 예시 (환각):
json
{
  "index": "S&P 500",
  "value": 5906,
  "original_text": null,
  "source_url": "https://tradingeconomics.com/united-states/stock-market"
}
→ 원문 없이 숫자만 보고하면 검증 불가능 = 환각
正确示例:
json
{
  "index": "S&P 500",
  "value": 6936,
  "original_text": "The main stock market index of United States, the US500, fell to 6936 points on January 12, 2026",
  "source_url": "https://tradingeconomics.com/united-states/stock-market"
}
错误示例（幻觉）:
json
{
  "index": "S&P 500",
  "value": 5906,
  "original_text": null,
  "source_url": "https://tradingeconomics.com/united-states/stock-market"
}
→ 仅展示数字而不提供原文则无法验证 = 幻觉内容

3. 교차 검증 프로토콜

3. 交叉验证协议

검증 요구사항

验证要求

항목기준
최소 출처 수3개 이상
값 일치 허용 범위±1%
1차 출처공식 출처(Fed, BOK, KRX 등) 1개 이상 권장
날짜 일치동일 거래일 데이터
项目标准
最少来源数量3个以上
数值一致允许范围±1%
首选来源推荐至少1个官方来源（Fed、BOK、KRX等）
日期一致同一交易日的数据

검증 절차

验证流程

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

검증 실패 시 처리

验证失败时的处理

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

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

4. 验证检查清单（必须完成）

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

웹검색 직접 호출 확인

网页搜索直接调用确认

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

원문 인용 확인

原文引用确认

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

교차 검증 확인

交叉验证确认

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

실패 처리 확인

失败处理确认

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

5. 허용 출처 (Allowlist)

5. 允许来源（白名单）

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

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

데이터출처URL
미국 주식/경제FREDfred.stlouisfed.org
미국 금리Federal Reservefederalreserve.gov
한국 주식한국거래소krx.co.kr
한국 금리한국은행bok.or.kr
글로벌Bloombergbloomberg.com
数据类型来源URL
美国股票/经济FREDfred.stlouisfed.org
美国利率Federal Reservefederalreserve.gov
韩国股票韩国交易所（KRX）krx.co.kr
韩国利率韩国银行（BOK）bok.or.kr
全球数据Bloombergbloomberg.com

Tier 2: 교차검증 출처

Tier 2: 交叉验证来源

출처URL커버리지
Trading Economicstradingeconomics.com글로벌
Investing.cominvesting.com글로벌
Yahoo Financefinance.yahoo.com글로벌
MarketWatchmarketwatch.com미국 중심
来源URL覆盖范围
Trading Economicstradingeconomics.com全球
Investing.cominvesting.com全球
Yahoo Financefinance.yahoo.com全球
MarketWatchmarketwatch.com以美国为主

Tier 3: 보조 출처

Tier 3: 辅助来源

출처URL용도
한국경제hankyung.com한국 시장
연합뉴스yna.co.kr한국 경제
Reutersreuters.com글로벌 뉴스
FTft.com글로벌 금융
来源URL用途
韩国经济hankyung.com韩国市场
联合通讯社yna.co.kr韩国经济
Reutersreuters.com全球新闻
FTft.com全球金融

Blocklist (금지)

禁止来源（黑名单）

  • 개인 블로그
  • 위키피디아 (실시간 데이터용)
  • 커뮤니티 사이트
  • 신뢰도 미검증 사이트
  • 个人博客
  • 维基百科（不适用于实时数据）
  • 社区网站
  • 未验证可信度的网站

메타 정보

元信息

yaml
version: "1.0"
created: "2026-01-14"
purpose: "분석 에이전트 공통 규칙 통합 - 코드 중복 제거"
consumers:
  - index-fetcher
  - rate-analyst
  - sector-analyst
  - risk-analyst
  - leadership-analyst
  - macro-critic
extracted_from:
  - "웹검색 도구 직접 호출 필수 섹션"
  - "원문 인용 규칙 섹션"
  - "교차 검증 프로토콜"
  - "Verification Checklist"
dependencies:
  - mcp_websearch_web_search_exa
  - mcp_websearch_web_search_exa
  - WebFetch
yaml
version: "1.0"
created: "2026-01-14"
purpose: "整合分析Agent通用规则 - 消除代码重复"
consumers:
  - index-fetcher
  - rate-analyst
  - sector-analyst
  - risk-analyst
  - leadership-analyst
  - macro-critic
extracted_from:
  - "「必须直接调用网页搜索工具」章节"
  - "「原文引用规则」章节"
  - "「交叉验证协议」"
  - "验证检查清单"
dependencies:
  - mcp_websearch_web_search_exa
  - mcp_websearch_web_search_exa
  - WebFetch