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
미국 주식/경제	FRED	fred.stlouisfed.org
미국 금리	Federal Reserve	federalreserve.gov
한국 주식	한국거래소	krx.co.kr
한국 금리	한국은행	bok.or.kr
글로벌	Bloomberg	bloomberg.com

数据类型	来源	URL
美国股票/经济	FRED	fred.stlouisfed.org
美国利率	Federal Reserve	federalreserve.gov
韩国股票	韩国交易所（KRX）	krx.co.kr
韩国利率	韩国银行（BOK）	bok.or.kr
全球数据	Bloomberg	bloomberg.com

Tier 2: 교차검증 출처

Tier 2: 交叉验证来源

출처	URL	커버리지
Trading Economics	tradingeconomics.com	글로벌
Investing.com	investing.com	글로벌
Yahoo Finance	finance.yahoo.com	글로벌
MarketWatch	marketwatch.com	미국 중심

来源	URL	覆盖范围
Trading Economics	tradingeconomics.com	全球
Investing.com	investing.com	全球
Yahoo Finance	finance.yahoo.com	全球
MarketWatch	marketwatch.com	以美国为主

Tier 3: 보조 출처

Tier 3: 辅助来源

출처	URL	용도
한국경제	hankyung.com	한국 시장
연합뉴스	yna.co.kr	한국 경제
Reuters	reuters.com	글로벌 뉴스
FT	ft.com	글로벌 금융

来源	URL	用途
韩国经济	hankyung.com	韩国市场
联合通讯社	yna.co.kr	韩国经济
Reuters	reuters.com	全球新闻
FT	ft.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