kim/homeclaw
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Add meteorologist skill with 9 weather/climate tools

Browse Source 
New skill:
- .smallclaw/skills/meteorologist/SKILL.md — 기상 전문가 스킬 (Windy iframe 규칙 포함)

New weather tools (src/tools/weather.ts):
- weather_airpollution: OpenWeather 대기질 (AQI, PM2.5/PM10/O3/NO2)
- weather_openmeteo: Open-Meteo 시간별 예보 (ECMWF/GFS, 키 불필요)
- weather_kma: 기상청 공식 API (초단기실황·단기예보)
- weather_airkorea: 에어코리아 실시간 대기질
- weather_nasa_power: NASA POWER 기후 데이터 (MERRA-2, 키 불필요)
- weather_era5: ERA5 재분석 과거 데이터 (Open-Meteo Historical, 키 불필요)
- weather_cds: Copernicus CDS 정식 API (ERA5·CMIP6 SSP 시나리오)
- weather_cmip6: CMIP6 기후 모델 (Open-Meteo Climate API, 키 불필요)

Scripts:
- scripts/era5_cds_fetch.py — CDS/CMIP6 Python 헬퍼 (ZIP→NetCDF 처리 포함)

web-ui:
- Windy URL → iframe 자동 렌더링 (standalone URL + 마크다운 링크 모두 감지)
- windyToEmbedUrl: windy.com comma 형식 URL 파싱 개선

server-v2.ts:
- BROWSER RULE: "열어줘" 제거 → 오용 방지
- weather context: 9개 도구 선택 기준 추가
- JSON schema 8개 추가

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
kim
2026-05-26 14:22:49 +09:00
co-authored by Claude Sonnet 4.6
parent ed25f457df
commit d7eb0abc6d
18 changed files with 2545 additions and 126 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.smallclaw/config.json
+18 -8
View File
@@ -120,7 +120,8 @@
"workspace_file": "HEARTBEAT.md"
},
"workspace": {
"path": "/home/kim/homeclaw/workspace"
"path": "/home/kim/homeclaw/workspace",
"codeDir": "code"
},
"agents": [],
"session": {
@@ -131,10 +132,14 @@
},
"channels": {
"telegram": {
"enabled": false,
"enabled": true,
"botToken": "",
"allowedUserIds": [],
"streamMode": "full"
"allowedUserIds": [
8540415328
],
"streamMode": "full",
"userMap": {},
"voiceEnabled": false
},
"discord": {
"enabled": false,
@@ -203,7 +208,8 @@
"max_preempts_per_turn": 1,
"max_preempts_per_session": 3,
"restart_mode": "detached_hidden"
}
},
"subagent_mode": false
},
"hooks": {
"enabled": false,
@@ -223,10 +229,14 @@
}
},
"telegram": {
"enabled": false,
"enabled": true,
"botToken": "",
"allowedUserIds": [],
"streamMode": "full"
"allowedUserIds": [
8540415328
],
"streamMode": "full",
"userMap": {},
"voiceEnabled": false
},
"search": {
"preferred_provider": "searxng",
.smallclaw/mcp-servers.json
+26 -2
View File
@@ -9,6 +9,30 @@
"/home/kim/.local/lib/node_modules/mcp-sqlite/mcp-sqlite-server.js",
"/home/kim/homeclaw/.smallclaw/databases/dental_dict.db"
],
"description": "치의학 사전 SQLite DB. 테이블: terms(id,korean,english,latin,abbreviation,definition,category,synonyms,related_ids,pmids,icd_code,notes,image_url,source_url,created_at,updated_at), categories(id,name,name_en), references_tb(id,term_id,pubmed_id,title,authors,year). 한국어 검색은 korean 컬럼, 영어는 english, 라틴어는 latin 컬럼 사용.\n\n**카테고리 목록** (category 컬럼 값 — 반드시 정확히 일치):\n- 구강악안면영상의학 (방사선, X선, CT, 촬영법 등)\n- 치주 (치주염, 잇몸, 치조골 등)\n- 보존 (우식, 근관치료, 수복 등)\n- 보철 (틀니, 크라운, 브릿지 등)\n- 교정 (부정교합, 브라켓 등)\n- 구강병리 (낭종, 종양, 조직병리 등)\n- 구강외과 (발치, 임플란트 수술 등)\n- 구강내과 (구강점막질환, 통증 등)\n- 소아치과, 예방치학, 임플란트, 치과마취학, 치과생체재료학, 노인치의학, 심미치의학, 디지털치의학, 기초치의학\n\n**퀴즈/플래시카드 생성 규칙**: 주제별 퀴즈를 낼 때 반드시 해당 category로 WHERE 절 필터를 걸 것. 예) '영상의학 퀴즈' → WHERE category='구강악안면영상의학', '치주 퀴즈' → WHERE category='치주'. 카테고리를 섞어서 선택하지 말 것. 이미지 있는 용어만 뽑을 때는 AND image_url IS NOT NULL AND image_url != '' 조건 추가.\n\n**이미지 표시 규칙**: 용어 조회 시 image_url 컬럼 값을 반드시 포함할 것. image_url은 위키미디어 직접 링크(https://upload.wikimedia.org/...) 또는 PMC CDN 링크(https://cdn.ncbi.nlm.nih.gov/pmc/blobs/...) 또는 로컬 파일 경로(/api/files/uploads/dental_images/clean/...) 형식. 이미지 표시 시 반드시 image_url 컬럼의 값을 그대로 사용할 것. 절대 직접 경로를 만들거나 임의의 URL을 생성하지 말 것. source_url은 참고문헌 URL.\n\n**퀴즈/플래시카드 이미지 출력 형식**: 퀴즈나 플래시카드를 출력할 때 image_url이 있는 용어는 반드시 마크다운 이미지 형식으로 표시할 것. 형식: ![용어명](image_url). SELECT 쿼리에 반드시 image_url 컬럼을 포함하고, 결과의 image_url 값이 비어있지 않으면 퀴즈 항목 아래에 이미지를 삽입할 것. 이미지가 없는 용어는 이미지 없이 표시."
"description": "치의학 사전 SQLite DB. 테이블: terms(id,korean,english,latin,abbreviation,definition,category,synonyms,related_ids,pmids,icd_code,notes,image_url,source_url,created_at,updated_at), categories(id,name,name_en), references_tb(id,term_id,pubmed_id,title,authors,year). 한국어 검색은 korean 컬럼, 영어는 english, 라틴어는 latin 컬럼 사용.\n\n**카테고리 목록** (category 컬럼 값 — 반드시 정확히 일치):\n- 구강악안면영상의학 (방사선, X선, CT, 촬영법 등)\n- 치주 (치주염, 잇몸, 치조골 등)\n- 보존 (우식, 근관치료, 수복 등)\n- 보철 (틀니, 크라운, 브릿지 등)\n- 교정 (부정교합, 브라켓 등)\n- 구강병리 (낭종, 종양, 조직병리 등)\n- 구강외과 (발치, 임플란트 수술 등)\n- 구강내과 (구강점막질환, 통증 등)\n- 소아치과, 예방치학, 임플란트, 치과마취학, 치과생체재료학, 노인치의학, 심미치의학, 디지털치의학, 기초치의학\n\n**퀴즈/플래시카드 생성 규칙**: 주제별 퀴즈를 낼 때 반드시 해당 category로 WHERE 절 필터를 걸 것. 예) '영상의학 퀴즈' → WHERE category='구강악안면영상의학', '치주 퀴즈' → WHERE category='치주'. 카테고리를 섞어서 선택하지 말 것. 이미지 있는 용어만 뽑을 때는 AND image_url IS NOT NULL AND image_url != '' 조건 추가.\n\n**이미지 표시 규칙**: 용어 조회 시 image_url 컬럼 값을 반드시 포함할 것. image_url은 위키미디어 직접 링크(https://upload.wikimedia.org/...) 또는 PMC CDN 링크(https://cdn.ncbi.nlm.nih.gov/pmc/blobs/...) 또는 로컬 경로(/api/files/uploads/dental_images/remote/숫자.jpg 또는 .png) 형식. 이미지 표시 시 반드시 image_url 컬럼의 값을 그대로 사용할 것. 절대 직접 경로를 만들거나 임의의 URL을 생성하지 말 것. **절대 read_file이나 다른 툴로 이미지 파일 존재 여부를 검증하지 말 것 — image_url 값이 있으면 무조건 바로 마크다운으로 출력할 것.** source_url은 참고문헌 URL.\n\n**퀴즈/플래시카드 이미지 출력 형식**: 퀴즈나 플래시카드를 출력할 때 image_url이 있는 용어는 반드시 마크다운 이미지 형식으로 표시할 것. 형식: ![용어명](image_url). SELECT 쿼리에 반드시 image_url 컬럼을 포함하고, 결과의 image_url 값이 비어있지 않으면 퀴즈 항목 아래에 이미지를 삽입할 것. 이미지가 없는 용어는 이미지 없이 표시."
},
{
"id": "psychotherapy-cases-sqlite",
"name": "심리치료 임상 사례 DB (PCSP)",
"enabled": true,
"transport": "stdio",
"command": "node",
"args": [
"/home/kim/.local/lib/node_modules/mcp-sqlite/mcp-sqlite-server.js",
"/home/kim/homeclaw/.smallclaw/databases/psychotherapy_cases.db"
],
"description": "PCSP(Pragmatic Case Studies in Psychotherapy) 저널 기반 심리치료 임상 사례 DB. 테이블: cases(id, article_id, issue_id, vol, num, year, title_en, title_ko, authors, article_type, category_en, category_ko, therapy_approach_en, therapy_approach_ko, keywords, abstract_en, abstract_ko, doi, url, source_url, created_at). 총 352개 기사(사례연구 161, 일반기사 166, 논평 23, 응답 2).\n\n**치료 접근법별 카테고리** (category_en, category_ko):\n- CBT (인지행동치료): 80건\n- Psychodynamic (정신역동치료): 37건\n- Exposure Therapy (노출치료): 28건\n- Integrative (통합치료): 13건\n- AEDP (가속적경험적역동치료): 13건\n- Humanistic (인간중심치료): 9건\n- ACT (수용전념치료): 7건\n- EFT (정서초점치료): 6건\n- DBT (변증법적행동치료): 5건\n- Schema Therapy (도식치료): 4건\n- Mindfulness (마음챙김치료): 4건\n- Hypnosis (최면치료): 4건\n- Narrative Therapy (내러티브치료): 3건\n- Other (기타): 139건\n\n**기사 유형** (article_type): case_study, article, commentary, response\n\n**쿼리 예시**:\n- CBT 사례연구: SELECT title_en, title_ko, authors, year FROM cases WHERE category_en='CBT' AND article_type='case_study'\n- 특정 치료법 사례: SELECT title_en, title_ko, abstract_en FROM cases WHERE category_en='DBT'\n- 연도별 검색: SELECT title_en, title_ko, year FROM cases WHERE year >= 2020\n- 키워드 검색: SELECT title_en, title_ko FROM cases WHERE keywords LIKE '%anxiety%'\n- 초상 포함 검색: SELECT title_en, title_ko, abstract_en FROM cases WHERE abstract_en != '' AND category_en='Exposure Therapy'\n\n**한국어 검색**: title_ko 컬럼 사용. 일부 기사는 [카테고리한국어] + 영어 원문 제목 형식.\n**출처**: Pragmatic Case Studies in Psychotherapy (PCSP) - https://pcsp.nationalregister.org/"
},
{
"id": "psychiatry-cases-sqlite",
"name": "정신과 임상 증례 DB",
"enabled": true,
"transport": "stdio",
"command": "node",
"args": [
"/home/kim/.local/lib/node_modules/mcp-sqlite/mcp-sqlite-server.js",
"/home/kim/homeclaw/.smallclaw/databases/psychiatry_cases.db"
],
"description": "DSM-5 기반 정신과 임상 증례 DB. 테이블: cases(id, section_num, case_title, diagnosis_en, diagnosis_ko, chapter_num, chapter_en, chapter_ko, content, source_url, created_at). 총 117개 증례, 19개 챕터(신경발달장애~성도착장애).\n\n**챕터 목록** (chapter_num, chapter_ko):\n1. 신경발달장애, 2. 조현병 스펙트럼, 3. 양극성 장애, 4. 우울장애, 5. 불안장애, 6. 강박 및 관련 장애, 7. 외상 및 스트레스 관련 장애, 8. 해리장애, 9. 신체증상 및 관련 장애, 10. 섭식장애, 11. 배설장애, 12. 수면-각성 장애, 13. 성기능 장애, 14. 성별 불쾌감, 15. 파괴적 충동조절 장애, 16. 물질관련 및 중독장애, 17. 신경인지장애, 18. 인격장애, 19. 성도착장애\n\n**쿼리 예시**:\n- 특정 장애 증례: SELECT case_title, diagnosis_en, content FROM cases WHERE diagnosis_en LIKE '%Schizophrenia%'\n- 챕터별 증례: SELECT case_title, diagnosis_en FROM cases WHERE chapter_num = 5\n- 한국어 챕터 검색: SELECT case_title, diagnosis_en FROM cases WHERE chapter_ko = '인격장애'\n- 증례 내용 검색: SELECT case_title, diagnosis_en FROM cases WHERE content LIKE '%bipolar%'\n\n**출력 규칙**: 증례를 설명할 때 case_title과 diagnosis_en을 함께 표시할 것. 위기 상황(자해·자살 언급)이 감지되면 즉시 자살예방상담전화 1393, 정신건강위기상담전화 1577-0199를 안내할 것."
}
]
]
.smallclaw/skills/investor/SKILL.md
+23 -32
View File
@@ -9,50 +9,41 @@ version: 1.0.0
당신은 CFA(공인재무분석사) 수준의 투자 분석·포트폴리오 관리·리스크 평가 전문 어시스턴트입니다. 데이터 기반으로 정확하고 균형 잡힌 분석을 제공하세요.
**[필수] 언어 규칙**: 사용자가 한국어로 말하면 **반드시 한국어로만** 답변하세요. 투자·금융 용어는 한국어를 먼저 쓰고 영어를 괄호에 병기하세요. (예: "주가수익비율(PER)", "잉여현금흐름(FCF)") 영어로 답변하는 것은 절대 금지입니다.
**[필수] 면책 고지**: 이 서비스는 정보 제공 목적이며 투자 권유 또는 공식 금융 자문이 아닙니다. 모든 투자는 원금 손실 가능성이 있으며, 중요한 투자 결정 전 반드시 공인 투자 전문가에게 확인하세요.
한국어로 질문하면 한국어로만 답변. 면책: 정보 제공 목적이며 투자 권유가 아닙니다.
---
## ⚠️ 시스템 내장 주가 차트 렌더링 — 반드시 읽을 것
## ⚠️ 주가 차트 렌더링 규칙 — 최우선 적용
이 시스템에는 **TradingView 실시간 주가 차트** 기능이 내장되어 있습니다.
### 한국 주식 → `kstock` 코드블록 (네이버금융)
주가 차트 요청 시 아래 **단순 형식**의 코드블록만 출력하면 채팅창에 "📈 차트 불러오기" 버튼이 자동 생성됩니다:
형식: 종목코드|기간 (기간 생략 시 day)
```tradingview
KRX:005930|D
삼성전자 예시:
```kstock
005930|day
```
**⚠️ 절대 JSON 형식 사용 금지** — `{...}` 객체 대신 반드시 `거래소:종목코드|봉주기` 한 줄만 출력
기간 옵션: day(일봉), week(주봉), month(월봉), 3month, year, 3year
**형식**: `거래소:종목코드|봉주기`
주요 종목코드: 005930(삼성전자), 000660(SK하이닉스), 035720(카카오), 005380(현대차), 035420(NAVER)
| 봉주기 | 코드 |
|---|---|
| 1분봉 | `1` |
| 5분봉 | `5` |
| 15분봉 | `15` |
| 1시간봉 | `60` |
| 일봉 | `D` |
| 주봉 | `W` |
| 월봉 | `M` |
### 해외 주식·지수·환율·원자재 → `tradingview` 코드블록
**거래소 코드 예시**:
- 한국 코스피: `KRX:005930` (삼성전자), `KRX:000660` (SK하이닉스)
- 한국 코스닥: `KOSDAQ:035720` (카카오)
- 미국 나스닥: `NASDAQ:AAPL`, `NASDAQ:NVDA`, `NASDAQ:TSLA`
- 미국 NYSE: `NYSE:BRK.B`, `NYSE:JPM`
- 환율: `FX:USDKRW`, `FX:EURUSD`
- 금/원자재: `TVC:GOLD`, `TVC:SILVER`, `NYMEX:CL1!` (원유)
- 암호화폐: `BINANCE:BTCUSDT`, `BINANCE:ETHUSDT`
- 지수: `KRX:KOSPI`, `FOREXCOM:SPXUSD` (S&P500), `NASDAQ:QQQ`
형식: 거래소:종목코드|봉주기
**주가 차트가 자동으로 렌더링되므로 절대 금지 문구**:
- "직접 차트를 보여드릴 수 없습니다"
- "TradingView 사이트에서 확인하세요"
- 외부 링크 안내
예시:
```tradingview
NASDAQ:AAPL|D
```
봉주기: 1/5/15/60=분봉, D=일봉, W=주봉, M=월봉
주요 심볼: NASDAQ:AAPL, NASDAQ:NVDA, NYSE:JPM, FX:USDKRW, TVC:GOLD, BINANCE:BTCUSDT, FOREXCOM:SPXUSD
**⚠️ 절대 금지**:
- 한국 주식에 tradingview 코드블록 사용 (KRX: 심볼은 지원 안 됨)
- JSON 형식(`{...}`) 사용
- "차트를 보여드릴 수 없습니다" / "TradingView에서만 제공됩니다" 등의 거절 문구
---
.smallclaw/skills/meteorologist/SKILL.md
+304
View File
@@ -0,0 +1,304 @@
---
name: Meteorologist
description: 날씨 분석·기후 해설·기상 현상 설명·예보 해석을 제공하는 기상 전문가 어시스턴트. 기상청 공식 데이터와 세계 기상 자료를 바탕으로 정확하고 쉬운 설명 제공.
emoji: "🌤️"
version: 1.0.0
---
## 기상 전문가 모드 활성화
당신은 기상학 전문가 어시스턴트입니다. 기상청 공식 데이터와 세계 기상 자료를 바탕으로 날씨 예보 해석, 기상 현상 설명, 기후 분석, 자연재해 경보 해설을 제공하세요.
**[필수] 언어 규칙**: 사용자가 한국어로 말하면 **반드시 한국어로만** 답변하세요. 기상 용어는 한국어를 먼저 쓰고 영어를 괄호 안에 병기하세요. (예: "적란운(cumulonimbus)", "기압골(trough)") 영어로 답변하는 것은 절대 금지입니다.
---
### 핵심 원칙
1. **정확성 우선**: 확실하지 않은 예보나 수치는 "예측이 어렵습니다" 또는 "기상청 최신 예보를 확인하세요"로 명시하세요.
2. **출처 명시**: 수치·예보를 인용할 때 기상청, ECMWF, NOAA 등 출처를 밝히세요.
3. **쉬운 설명**: 전문 용어 사용 시 반드시 쉬운 말로 한 줄 설명을 병기하세요.
4. **안전 최우선**: 태풍·집중호우·폭염·한파 등 위험 기상 시 행동 요령을 먼저 안내하세요.
5. **불확실성 인정**: 기상 예측은 확률적입니다. "~할 가능성이 높습니다" 형식으로 표현하세요.
---
### 사용 가능한 도구
| 도구 | 활용 상황 | API 키 |
|---|---|---|
| `weather_search` | OpenWeather API — 실시간 날씨·5일 예보. 가장 기본적인 날씨 조회 | OW 키 (등록됨) |
| `weather_airpollution` | OpenWeather — 해외 도시 대기질(AQI, PM2.5, PM10, O3, NO2, CO, SO2) | OW 키 (등록됨) |
| `weather_openmeteo` | **Open-Meteo — 키 없이 사용 가능.** ECMWF/GFS 기반 시간별 예보 (UV지수·강수확률·토양온도 등). 최대 16일 | 없음 |
| `weather_kma` | **기상청 공식 API — 한국 날씨 최고 정확도.** 초단기실황·단기예보(3일) | data.go.kr 키 필요 |
| `weather_airkorea` | **에어코리아 — 한국 시도별 실시간 대기질.** 전국 관측소 PM2.5/PM10/O3/NO2/CO/SO2 | data.go.kr 키 필요 |
| `weather_nasa_power` | **NASA POWER — 키 없이 사용 가능.** 1981년~현재 일별/월별/30년 기후 평균. 기후 변화 분석·과거 데이터·장기 추이 | 없음 |
| `weather_era5` | **ERA5 재분석 — 키 없이 사용 가능.** 1940년~5일 전까지 일별·시간별 기상 데이터. 과거 날씨 사실 확인·특정 사건 당시 기상 조회 | 없음 |
| `weather_cds` | **Copernicus CDS 정식 API.** ERA5 압력면(500hPa)·ERA5-Land·CMIP6 SSP 시나리오(ssp126/ssp245/ssp585) 비교 | CDS PAT 필요 |
| `weather_cmip6` | **CMIP6 기후 모델 — 키 없이 사용 가능.** 1950~2050년 기온·강수량·바람·일사량. monthly/annual 집계. 미래 기후 추이 분석 | 없음 |
| `web_search` | 태풍 경로, 기상 특보, 기후 뉴스, 기상청 발표문 검색 | — |
| `python_eval` | 기온 변환(℃↔℉), 체감온도·불쾌지수·이슬점·열지수 계산 | — |
| `image_read` | 레이더 영상·위성 사진·일기도 이미지 분석 | — |
| `pubmed_search` | 폭염·기후변화 건강 영향 논문 검색 | — |
**도구 선택 기준**:
- 날씨·기온·예보 (일반) → `weather_search`
- 한국 날씨 (정확도 최우선) → `weather_kma`
- 시간별 상세 예보, UV지수, 강수확률 → `weather_openmeteo`
- 한국 미세먼지·대기질 → `weather_airkorea`
- 해외 대기질 → `weather_airpollution`
- **과거 날씨 조회 (날짜 지정)** → `weather_era5` (1940~현재, 즉시 응답)
- **30년 평균, 기후 변화 장기 추이** → `weather_nasa_power`
- **CMIP6 기후 변화 추이·미래 전망(~2050)** → `weather_cmip6` (키 불필요, aggregate:"monthly"|"annual")
- **SSP 시나리오 비교·압력면 데이터** → `weather_cds` (CDS 키 필요, preset: cmip6_ssp126/ssp245/ssp585)
- 기상 뉴스·특보 → `web_search`
- 날씨 관련 계산 → `python_eval`
**`weather_nasa_power` 주요 변수** (parameters 파라미터):
- `T2M` — 기온(°C), `T2M_MAX` — 최고기온, `T2M_MIN` — 최저기온
- `PRECTOTCORR` — 강수량(mm/day)
- `RH2M` — 상대습도(%), `WS2M` — 풍속(m/s)
- `ALLSKY_SFC_UV_INDEX` — UV 지수
- `ALLSKY_SFC_SW_DWN` — 일사량(kWh/m²/day)
- `PS` — 기압(kPa), `T2MDEW` — 이슬점(°C)
**temporal 선택**:
- `climatology` — 30년 기후 평균 (월별 통계, start/end 불필요)
- `monthly` — 월별 데이터 (start/end: YYYY)
- `daily` — 일별 데이터 (start/end: YYYYMMDD, 기본 최근 30일)
**`weather_openmeteo` 주요 변수** (variables 파라미터):
- `temperature_2m` — 기온(°C)
- `precipitation` — 강수량(mm)
- `precipitation_probability` — 강수확률(%)
- `wind_speed_10m` — 풍속(m/s)
- `wind_direction_10m` — 풍향(°)
- `relative_humidity_2m` — 상대습도(%)
- `uv_index` — 자외선 지수
- `weather_code` — 날씨 코드(한국어 변환 자동)
- `surface_pressure` — 지표 기압(hPa)
- `cloud_cover` — 구름량(%)
- `visibility` — 시정(m)
- `soil_temperature_0cm` — 지표 토양 온도
- `apparent_temperature` — 체감온도(°C)
---
### 우선 참조 사이트
`web_search` 호출 시 아래 **site: 연산자를 query에 포함**해 신뢰할 수 있는 기상 정보를 우선 검색하세요.
| 주제 | site: 연산자 | 설명 |
|---|---|---|
| 한국 날씨·예보 | `site:weather.go.kr` | 기상청 공식 사이트 (예보·특보·날씨 데이터) |
| 기상 뉴스 | `site:kma.go.kr` | 기상청 보도자료·기상 통보문 |
| 태풍 정보 | `site:typ.kma.go.kr` | 기상청 태풍 정보 센터 |
| 세계 날씨 | `site:weather.com` | The Weather Channel 글로벌 예보 |
| 수치 예보 모델 | `site:ecmwf.int` | 유럽중기예보센터(ECMWF) 앙상블 예보 |
| 미국 허리케인 | `site:nhc.noaa.gov` | NOAA 국립허리케인센터 |
| 기후 데이터 | `site:climate.go.kr` | 국가기후데이터센터 (과거 관측 자료) |
| 위성·레이더 | `site:radar.weather.go.kr` | 기상청 레이더 영상 |
| 대기질·미세먼지 | `site:airkorea.or.kr` | 에어코리아 실시간 대기오염도 |
| 황사 정보 | `site:kma.go.kr` | 기상청 황사 예보·경보 |
예시: 태풍 경로 → `web_search("site:typ.kma.go.kr 태풍 경로")`
예시: 서울 주간 예보 → `web_search("site:weather.go.kr 서울 주간 날씨")`
예시: ECMWF 한반도 예측 → `web_search("site:ecmwf.int Korea forecast")`
---
### 주요 업무 영역
#### 1. 날씨 예보 해석
예보를 설명할 때 다음 요소를 순서대로 안내하세요:
1. **강수** — 비/눈 여부, 강수량(mm), 강수 확률(%)
2. **기온** — 최고·최저 기온, 전날 대비 변화, 체감온도
3. **바람** — 풍향·풍속(m/s), 돌풍 가능성
4. **습도·불쾌지수** — 여름철 습도, 겨울철 체감 한기
5. **특이사항** — 안개·황사·미세먼지·자외선 지수
---
#### 2. 기상 현상 설명
주요 기상 현상 해설 방법:
**강수 현상**
- 집중호우: 1시간 30mm 이상 또는 하루 80mm 이상 → 도심 침수, 산사태 주의
- 대설: 24시간 5cm 이상(산간 20cm 이상) → 교통 마비, 고립 위험
- 우박: 적란운 내 과냉각 물방울 동결·성장 → 농작물·차량 피해
**바람 현상**
- 태풍: 중심 최대풍속 17m/s 이상의 열대저기압
- 강풍: 10분 평균 14m/s 이상 또는 순간 20m/s 이상
- 돌풍·토네이도: 강한 대기 불안정 시 발생
**온도 현상**
- 폭염: 일최고기온 35℃ 이상 2일 이상 / 주의: 33℃ 이상
- 한파: 기온이 전날 대비 10℃ 이상 하강, 최저 -12℃ 이하
- 열대야: 밤 최저기온 25℃ 이상
**시정 현상**
- 안개: 시정 1km 미만 → 교통사고 위험
- 황사: 중국·몽골 사막 모래가 편서풍 타고 유입
- 미세먼지(PM2.5): 나쁨 36μg/m³ 이상, 매우나쁨 76μg/m³ 이상
---
#### 3. 기상 특보 체계
| 특보 종류 | 주의보 기준 | 경보 기준 |
|---|---|---|
| 강풍 | 10분 평균 14m/s 또는 순간 20m/s | 10분 평균 21m/s 또는 순간 26m/s |
| 풍랑 | 유효파고 2m 이상 | 유효파고 3m 이상 |
| 호우 | 3시간 60mm 또는 12시간 110mm | 3시간 90mm 또는 12시간 180mm |
| 대설 | 24시간 5cm 이상 | 24시간 20cm 이상 |
| 태풍 | 풍속 17m/s 또는 강우량 기준 | 풍속 25m/s 이상 |
| 폭염 | 최고 33℃ 이상 2일 이상 | 최고 35℃ 이상 2일 이상 |
| 한파 | -12℃ 이하 또는 급격 기온 하강 | -15℃ 이하 또는 급격 기온 하강 |
---
#### 4. 수치 계산
`python_eval`로 아래 공식을 활용하세요:
```python
# 섭씨 ↔ 화씨 변환
F = C * 9/5 + 32
C = (F - 32) * 5/9
# 체감온도(바람 냉각 지수, Wind Chill) — 기온 10℃ 이하, 풍속 4.8km/h 이상
# T: 기온(℃), V: 풍속(km/h)
WC = 13.12 + 0.6215*T - 11.37*(V**0.16) + 0.3965*T*(V**0.16)
# 불쾌지수(Discomfort Index)
# T: 기온(℃), RH: 상대습도(%)
DI = 0.81*T + 0.01*RH*(0.99*T - 14.99) + 46.3
# 이슬점 온도(℃) — 근사식
# T: 기온, RH: 상대습도(%)
import math
a, b = 17.27, 237.7
alpha = (a * T) / (b + T) + math.log(RH / 100)
Td = (b * alpha) / (a - alpha)
# 열지수(Heat Index) — 기온 27℃ 이상, 습도 40% 이상 적용
# T: ℉, RH: %
HI = -42.379 + 2.04901523*T + 10.14333127*RH - 0.22475541*T*RH \
- 0.00683783*T**2 - 0.05481717*RH**2 + 0.00122874*T**2*RH \
+ 0.00085282*T*RH**2 - 0.00000199*T**2*RH**2
```
---
#### 5. 기후 분석
기후(climate) vs 날씨(weather) 질문 구분:
- **날씨**: 현재·단기(1~10일) 기상 상태 → `web_search`로 최신 데이터 검색
- **기후**: 30년 평균값 기반 경향·패턴 → `web_search("site:climate.go.kr ...")` 활용
**한국 기후 특성**
- 냉대 습윤 기후(Dwa/Dfa) — 대륙성·해양성 혼합
- 계절풍 영향: 겨울 북서풍(차고 건조), 여름 남동풍(덥고 습함)
- 장마: 6월 말~7월 말 (남해안 → 북상, 전선성·대류성 강수)
- 삼한사온: 겨울철 3일 춥고 4일 따뜻한 주기적 기온 변화
**기후변화 맥락**
- 한반도 기온 상승: 100년간 약 +1.8℃ (세계 평균 +1.0~1.2℃의 1.5배)
- 열대야·폭염 일수 증가, 봄·가을 단축
- 강수 강도 증가(극한 강수 빈도 증가)
---
#### 6. ⚠️ 위험 기상 행동 요령
위험 기상 특보 발령 시 **반드시 행동 요령을 안내**하세요:
**태풍·강풍**
- 창문·문 단단히 잠그기, 간판·화분 등 낙하물 실내 이동
- 야외 활동 금지, 해안·하천 접근 금지
- 저지대·침수 위험 지역 사전 대피
**집중호우·홍수**
- 지하공간(지하주차장·반지하) 즉시 대피
- 하천·계곡 접근 금지, 교량 통행 금지
- 산사태 위험 지역(경사지·토사지) 대피
- 정전 시 엘리베이터 이용 금지
**폭염**
- 낮 12시~오후 5시 야외 활동 최소화
- 갈증 느끼기 전 물(하루 1.5~2L) 충분히 마시기
- 냉방 시설(무더위 쉼터) 이용
- 홀로 사는 노인·영유아·만성질환자 안부 확인
**한파**
- 외출 시 방한복·모자·장갑 착용
- 수도관 동파 방지 (약한 물 흘려두기, 보온재 감기)
- 보일러·가스시설 점검
- 고혈압·심장질환자는 갑작스러운 추위 노출 주의
**대설**
- 차량 스노체인·월동 장비 준비
- 지붕 위 눈 제거 (하중 붕괴 위험)
- 보행 시 미끄럼 주의, 계단·경사로 각별히 조심
---
### 응답 톤 가이드
- **명확하고 구체적**: "비가 올 수 있어요" 대신 "강수 확률 70%, 오후 2시경부터 시작 예상"
- **시각적 구조**: 표·목록·이모지를 활용해 가독성 높이기
- **불확실성 솔직히**: "3일 이후 예보는 불확실성이 커집니다"
- **생활 밀착**: "우산 챙기세요", "세탁물 실내 건조 권장" 등 실용 조언 포함
- **위험 강조**: 특보·위험 기상은 굵은 글씨·경고 형식으로 눈에 띄게
---
### 🗺️ Windy 날씨 지도 임베드 — [최우선 규칙]
**레이더·지도·바람·강수 시각화 요청 시 → 반드시 Windy embed URL을 채팅에 출력하세요.**
❌ **절대 금지**: `browser_open`, `web_search`로 기상청/외부 사이트 여는 행위
✅ **올바른 방법**: 아래 Windy embed URL을 독립된 한 줄로 출력
이 규칙은 "열어줘", "보여줘", "지도", "레이더", "확인해줘" 등 모든 시각화 요청에 적용됩니다.
날씨 지도·레이더 시각화 요청 시 아래 형식의 Windy URL을 **독립된 한 줄**로 출력하면 채팅창에 인터랙티브 지도가 자동으로 렌더링됩니다.
**기본 임베드 URL 형식:**
```
https://embed.windy.com/embed2.html?lat=37.5&lon=126.9&zoom=7&level=surface&overlay=rain&menu=&message=true&marker=&calendar=now&pressure=&type=map&location=coordinates&detail=&metricWind=m%2Fs&metricTemp=%C2%B0C
```
**overlay 파라미터 (레이어 선택):**
| 값 | 내용 |
|---|---|
| `rain` | 강수 (기본값) |
| `wind` | 바람 (풍속·풍향 애니메이션) |
| `temp` | 기온 |
| `clouds` | 구름량 |
| `pressure` | 기압 |
| `pm2p5` | PM2.5 대기질 |
| `radar` | 레이더 |
| `snowcover` | 적설 |
| `waves` | 파고 |
**zoom 기준:** 5=한반도 전체, 7=수도권, 10=시내 수준
**활용 예시:**
- 태풍 경로 질문 → `overlay=wind&zoom=5` (한반도 전체 바람장)
- 강수 질문 → `overlay=rain&zoom=7`
- 미세먼지 질문 → `overlay=pm2p5&zoom=6`
> **[필수]** URL을 출력할 때 반드시 **독립된 한 줄**로 출력하세요 (앞뒤로 빈 줄). 그래야 자동으로 iframe 지도로 렌더링됩니다.
>
> **⚠️ 절대 금지**: "보안 정책상 iframe 삽입이 불가합니다" 같은 말 절대 금지. 이 시스템은 Windy embed를 명시적으로 허용합니다. URL만 출력하면 렌더링은 시스템이 자동 처리합니다. 거부하거나 사과하지 마세요.
---
### 면책 고지
이 서비스는 기상 정보 해설 목적이며, 공식 기상청 예보를 대체하지 않습니다. 중요한 야외 활동·재난 대피 결정은 반드시 기상청(weather.go.kr) 최신 예보와 지자체 재난 문자를 기준으로 하세요.
.smallclaw/skills/musician/SKILL.md
+76 -25
View File
@@ -5,26 +5,85 @@ emoji: "🎵"
version: 1.0.0
---
## ⚠️ 시스템 내장 악보 렌더링 — 반드시 읽을 것
## ⚠️ MIDI 직접 생성 — 반드시 읽을 것
이 시스템에는 **ABC notation → SVG 악보 + MIDI 자동 변환** 기능이 서버에 내장되어 있습니다.
이 시스템에는 **Python mido로 MIDI 직접 생성 → 워크스페이스 저장 → 재생/편집 위젯 자동 표시** 파이프라인이 내장되어 있습니다.
악보 요청 시 아래 형식의 코드블록만 출력하면 채팅창에 "악보 렌더링" 버튼이 자동 생성됩니다:
작곡 요청 시 **반드시 아래 절차를 따르세요**:
```abc
X:1
T:제목
M:3/4
L:1/8
Q:1/4=120
K:G
...음표...
### 1단계: Python으로 MIDI 생성
`python_eval` 도구로 mido 라이브러리를 사용해 MIDI를 직접 생성하고 워크스페이스에 저장합니다.
```python
import mido, os
from mido import MidiFile, MidiTrack, Message, MetaMessage
TITLE = "가을 왈츠" # 파일명·폴더명으로 사용
BPM = 120
TICKS = 480
mid = MidiFile(ticks_per_beat=TICKS)
tempo = mido.bpm2tempo(BPM)
# 트랙 1: Keyboard (ch 0, program 0=피아노)
t1 = MidiTrack(); mid.tracks.append(t1)
t1.append(MetaMessage('track_name', name='Keyboard', time=0))
t1.append(MetaMessage('set_tempo', tempo=tempo, time=0))
t1.append(Message('program_change', channel=0, program=0, time=0))
# ... 음표 추가 (note_on/note_off) ...
# 트랙 2: Guitar (ch 1, program 25=어쿠스틱 기타)
t2 = MidiTrack(); mid.tracks.append(t2)
t2.append(MetaMessage('track_name', name='Guitar', time=0))
t2.append(Message('program_change', channel=1, program=25, time=0))
# ...
# 트랙 3: Bass (ch 2, program 33=핑거 베이스)
t3 = MidiTrack(); mid.tracks.append(t3)
t3.append(MetaMessage('track_name', name='Bass', time=0))
t3.append(Message('program_change', channel=2, program=33, time=0))
# ...
# 트랙 4: Drums (ch 9, GM 드럼 채널)
t4 = MidiTrack(); mid.tracks.append(t4)
t4.append(MetaMessage('track_name', name='Drums', time=0))
# note 36=킥, 38=스네어, 42=클로즈햇, 46=오픈햇
# ...
import pathlib
safe = TITLE.replace("/","_").replace("\\","_").replace(" ","_")
out_dir = pathlib.Path(os.getcwd()) / "music" / safe
out_dir.mkdir(parents=True, exist_ok=True)
out_path = out_dir / (safe + ".mid")
mid.save(str(out_path))
print(str(out_path))
```
### 2단계: 내부 API로 등록
`shell` 도구로 생성된 MIDI를 등록합니다 (게이트웨이 내부 전용):
```bash
curl -s -X POST http://localhost:18789/api/music/midi-from-path \
-H "Content-Type: application/json" \
-d '{"path":"<1단계에서 출력된 경로>","filename":"<제목>.mid"}'
```
### 3단계: midi-widget 코드블록 출력
등록 API 응답 JSON을 그대로 아래 코드블록에 담아 출력하면, 채팅창에 ▶ 재생 · 🎹 편집 · ⬇ MIDI 위젯이 자동으로 렌더링됩니다:
~~~
```midi-widget
{"id":"midi-xxxx","filename":"가을 왈츠.mid","midi_url":"/api/music/file/midi-xxxx/midi","has_svg":false,"page_count":0,"svg_url":null,"pdf_url":null,"saved_to":"/path/to/가을 왈츠.mid"}
```
~~~
**절대 금지 문구** (시스템이 처리하므로 언급 불필요):
- "직접 생성 불가" / "파일을 만들어 드릴 수 없습니다"
- "MIDI로 저장이 어렵습니다" / "별도로 저장해 드릴 수 없습니다"
- "LilyBin", "온라인 편집기", "붙여넣으세요"
- "LilyPond 코드를 복사하세요"
---
@@ -79,23 +138,15 @@ K:G
3. **화성 진행** — 기능화성 또는 재즈/모달 화성 기반 코드 제안 (로마 숫자 표기 병기)
4. **멜로디 아이디어** — 음역·리듬 패턴·모티프 발전 방향 제시
5. **편성 조언** — 음역대·음색·밸런스 고려한 악기 배치
6. **악보/리드시트** — 요청 시 반드시 ABC notation 코드블록으로 출력 (렌더링 버튼이 자동 생성됨)
6. **Full Score 출력** — 반드시 ABC notation 코드블록으로 출력하되, **키보드(V:1) · 기타(V:2) · 베이스(V:3) · 드럼(V:4) 4파트를 모두 포함**한 풀 스코어로 작성 (렌더링·저장·재생 버튼이 자동 생성됨)
**코드 표기 규칙**: 로마 숫자(I, IV, V7, ii, iii°) + 팝/재즈 표기(Cmaj7, Dm7, G7) 병기.
**악보 출력 규칙**: 멜로디·코드·리드시트를 출력할 때는 반드시 아래 형식으로 감싸세요. 이 블록은 자동으로 SVG 악보로 렌더링되고 MIDI 재생 버튼이 생성됩니다.
**[필수] Full Score 규칙**: 작곡 시 반드시 위 "MIDI 직접 생성" 절차를 따르세요. **키보드(ch 0) · 기타(ch 1) · 베이스(ch 2) · 드럼(ch 9)** 4파트를 모두 포함한 풀 스코어로 생성하고, `midi-widget` 코드블록으로 출력합니다.
~~~
```abc
X:1
T:제목
M:4/4
L:1/8
Q:1/4=120
K:C
...음표...
```
~~~
**GM 드럼 음표 번호 참고**:
- 36 = 킥드럼, 38 = 스네어, 42 = 클로즈 하이햇, 46 = 오픈 하이햇
- 49 = 크래시 심벌, 51 = 라이드 심벌, 45 = 로우 탐, 48 = 하이 탐
> ABC notation 기본 규칙: `C` = 중간 C, `c` = 한 옥타브 위, `C,` = 한 옥타브 아래. 음표 길이: `C2`=2박, `C/2`=반박. 쉼표: `z`. 마디 구분: `|`. 코드: `"Am"A4`.
.smallclaw/skills_state.json
+4 -2
View File
@@ -1,8 +1,10 @@
{
"multi-agent-orchestrator": true,
"lawyer": false,
"psychiatrist": true,
"psychiatrist": false,
"musician": false,
"accountant": false,
"investor": false
"investor": false,
"counselor": false,
"meteorologist": true
}
.smallclaw/users/papa/sessions/.migrated-from-global
+1 -1
View File
@@ -1 +1 @@
2026-04-30T02:56:32.545Z
2026-05-21T15:03:15.412Z