From 3b9f8a82061d8ebfbe69938a01018f0d8d4fbc9c Mon Sep 17 00:00:00 2001 From: happybell80 Date: Fri, 3 Apr 2026 07:06:21 +0900 Subject: [PATCH] =?UTF-8?q?docs:=20SKILL.md=20runtime=20frontmatter=20?= =?UTF-8?q?=EC=B6=94=EA=B0=80=20+=20calendar=20=ED=86=B5=ED=95=A9=20+=20?= =?UTF-8?q?=EB=A8=B8=EC=A7=80=EC=B6=A9=EB=8F=8C=20=ED=95=B4=EC=86=8C?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 전 스킬 SKILL.md에 runtime (kind, service_url_env) frontmatter 추가 - calendar-delete/event/query 3분할 → skill-calendar 단일 스킬로 통합 - general_chat 스킬 신규 추가 - goosefarm-query, skill-translate 머지 충돌 마커 제거 - 용어집 정리 Co-Authored-By: Claude Opus 4.6 (1M context) --- book/600_appendix/650_용어집.md | 166 ++--------------------------- skills/SKILL.md | 2 +- skills/approval/SKILL.md | 2 + skills/blogwatcher/SKILL.md | 3 + skills/calendar-delete/SKILL.md | 6 -- skills/calendar-event/SKILL.md | 6 -- skills/calendar-query/SKILL.md | 6 -- skills/companyx-rag/SKILL.md | 2 + skills/general_chat/SKILL.md | 12 +++ skills/gitea/SKILL.md | 3 + skills/github-analyze/SKILL.md | 2 + skills/github-manage/SKILL.md | 2 + skills/goosefarm-query/SKILL.md | 38 +------ skills/himalaya/SKILL.md | 3 + skills/self-inspect/SKILL.md | 2 + skills/session-logs/SKILL.md | 2 + skills/skill-calendar/SKILL.md | 36 +++++++ skills/skill-creator/SKILL.md | 2 + skills/skill-email/SKILL.md | 3 + skills/skill-embedding/SKILL.md | 3 + skills/skill-llm/SKILL.md | 2 + skills/skill-news/SKILL.md | 3 + skills/skill-rag-file/SKILL.md | 3 + skills/skill-slack/SKILL.md | 3 + skills/skill-translate/SKILL.md | 10 +- skills/summarize/SKILL.md | 3 + skills/web-search/SKILL.md | 2 + skills/whisper/SKILL.md | 3 + 28 files changed, 111 insertions(+), 219 deletions(-) delete mode 100644 skills/calendar-delete/SKILL.md delete mode 100644 skills/calendar-event/SKILL.md delete mode 100644 skills/calendar-query/SKILL.md create mode 100644 skills/general_chat/SKILL.md create mode 100644 skills/skill-calendar/SKILL.md diff --git a/book/600_appendix/650_용어집.md b/book/600_appendix/650_용어집.md index c9e2c13..3357473 100644 --- a/book/600_appendix/650_용어집.md +++ b/book/600_appendix/650_용어집.md @@ -1,12 +1,14 @@ -# 650. 용어집 +# 650. 용어집 (로빙 프로젝트 전용) -로빙 문서에서 자주 쓰는 용어를 짧게 정리합니다. +로빙 프로젝트 고유 용어만 정리한다. 시스템 공통 용어는 [시스템 용어집](/home/admin/0_VALUE/20_Governance/glossary.md)을 참조한다. ## 읽는 방법 - 생소한 용어가 나오면 이 문서를 먼저 확인한다. -- 같은 용어가 문서마다 다르게 쓰이면 이 문서 기준으로 통일한다. -- 새로운 핵심 용어를 본문에 쓰기 전, 이 문서에 먼저 등록하고 관련 문서 링크를 함께 남긴다. +- 여기에 없으면 [시스템 용어집](/home/admin/0_VALUE/20_Governance/glossary.md)을 확인한다. +- 같은 용어가 문서마다 다르게 쓰이면 이 문서 → 시스템 용어집 순으로 기준을 따른다. + +--- ## ㄱ @@ -19,33 +21,13 @@ LLM 출력을 후처리하여 로빙의 고유한 성격과 윤리적 기준을 ### 경험치 (Experience Points, XP) 로빙이 작업을 수행하거나 사용자와 상호작용할 때 획득하는 포인트. 일정량 누적 시 레벨업이 발생함. -### 그라운딩 (Grounding) -LLM이 답변할 때 내부 문서에서 근거를 찾아 명시하는 프로세스. 추측이나 외부 지식이 아니라 검색된 문서 내용만을 근거로 답변하고, 어떤 문서가 근거인지 함께 제시한다. 근거가 부족하면 "모른다"고 명시한다. RAG의 출력 원칙. -관련 문서: -- [Company X Grounding 파이프라인](../../workflow/03_rag/companyx_grounding_pipeline.md) -- [companyx-rag SKILL.md](../../skills/companyx-rag/SKILL.md) - -### 공통 계약 (Common Contract) -특정 기능 경로가 따라야 하는 공통 `입력-판단-출력` 약속. 질문별 예외 문장을 계속 추가하는 대신, 질문 유형 분류, 근거 채택 기준, 실패 조건 같은 규칙을 한 번 정의해 코드·프롬프트·테스트가 함께 따르도록 고정한 기준을 뜻한다. -관련 문서: -- [311_backend_coding_principles.md](../300_architecture/311_backend_coding_principles.md) -- [Company X RAG 답변합성 시나리오·트러블 동시종결 리서치](../../journey/research/260315_companyx_rag_답변합성_시나리오동시종결_리서치.md) - ## ㄷ ### 디지털 동료 (Digital Colleague) 로빙의 비즈니스 포지셔닝. 단순한 도구나 어시스턴트를 넘어 함께 성장하고 협업하는 AI 파트너를 지칭. 로빙의 상업적 가치를 표현할 때 사용. -### DID (Decentralized Identifier) -탈중앙화 신원 식별자. 로빙의 정체성을 플랫폼 독립적으로 관리할 수 있게 하는 기술. - ## ㄹ -### 랄프 루프 (Ralph Loop) -AI가 코드 작성 → 테스트 → 실패 시 수정을 반복하여, 완성 기준이 충족될 때까지 자동으로 돌아가는 루프. 심슨스 캐릭터 '랄프 위검'에서 유래. Continue.dev, Cursor, Aider 등으로 실행 가능. -관련 문서: -- [Ralph Loop 참조 및 RAG 적용 리서치](../../journey/research/260316_Ralph_Loop_참조_및_RAG_적용.md) - ### 레벨 (Level) 로빙의 성장 단계를 나타내는 지표. 1레벨부터 20레벨까지 존재하며, 레벨업 시 5개의 스탯 포인트를 획득. @@ -63,57 +45,22 @@ AI가 코드 작성 → 테스트 → 실패 시 수정을 반복하여, 완성 ### 메모리 (Memory) 5대 스탯 중 하나. 정보 저장, 회상, 연결 능력을 나타냄. ChromaDB를 통해 벡터화된 장기 기억을 관리. -### 멀티 에이전트 (Multi-Agent) -여러 로빙이 협업하여 복잡한 작업을 수행하는 시스템. 각 에이전트는 고유한 강점을 가지고 역할을 분담. - -## ㅂ - -### 벡터 메모리 (Vector Memory) -텍스트나 경험을 고차원 벡터로 변환하여 저장하는 방식. 의미적 유사성 기반 검색이 가능함. - -### 베이스 이미지 (Base Image) -Docker 컨테이너의 기본이 되는 이미지. chroma_vector:1.0은 ChromaDB와 ML 라이브러리가 사전 설치된 베이스 이미지. - -### 불변성 (Immutability) -함수형 프로그래밍의 핵심 개념. 한번 생성된 데이터는 변경되지 않고, 변경이 필요할 때는 새로운 데이터를 생성. 로빙의 상태 관리와 스킬 구현에 적용. - -### 부작용 (Side Effect) -함수가 자신의 스코프 밖의 상태를 변경하거나 I/O 작업을 수행하는 것. 로빙에서는 부작용을 오케스트레이터 계층으로 분리하여 관리. - ## ㅅ -### 순수 함수 (Pure Function) -동일한 입력에 항상 동일한 출력을 반환하고 부작용이 없는 함수. 로빙의 스킬 시스템 구현의 기본 원칙. - ### 스카웃 (Scout) 특정 능력이나 경험을 가진 로빙을 다른 팀으로 영입하는 시스템. 축구의 이적 시장과 유사한 개념. -### 스킬 (Skill) -로빙이 수행할 수 있는 특정 작업이나 기능. 함수형으로 구현되며 독립적으로 실행 가능한 모듈. - ### 스탯 (Stats) 로빙의 능력치를 수치화한 것. Memory, Compute, Empathy, Leadership, Ethics의 5가지로 구성. -### 시맨틱 검색 (Semantic Search) -단순 키워드 매칭이 아닌 의미적 유사성을 기반으로 정보를 검색하는 방식. - ## ㅇ -### 오케스트레이터 (Orchestrator) -순수 함수와 부작용을 분리하여 관리하는 계층. I/O 작업과 순수 계산을 조정하는 역할을 담당. - ### 연산력 (Compute) 5대 스탯 중 하나. 처리 속도, 복잡한 계산, 멀티태스킹 능력을 나타냄. ### 윤리성 (Ethics) 5대 스탯 중 하나. 도덕적 판단, 규칙 준수, 신뢰성을 나타냄. 모든 의사결정에 영향을 미치는 핵심 스탯. -### 임베딩 (Embedding) -텍스트나 데이터를 고차원 벡터 공간의 한 점으로 매핑하는 과정. 의미적 유사성을 수치화할 수 있게 함. - -### 정보 엔트로피 (Information Entropy) -정보의 불확실성이나 복잡도를 측정하는 척도. 메모리 시스템에서 정보의 중요도를 판단하는 데 사용. - ### 존재형 에이전트 (Existence-type Agent) 로빙의 철학적 개념. 단순 작업 수행을 넘어 고유한 정체성, 성장, 관계를 가진 AI를 지칭. '로빙'과 같은 의미로 사용되나, 철학적 맥락을 강조할 때 주로 사용. @@ -136,110 +83,15 @@ Docker 컨테이너의 기본이 되는 이미지. chroma_vector:1.0은 ChromaDB - [130_존재형_에이전트란_무엇인가.md](../100_philosophy/130_존재형_에이전트란_무엇인가.md) - [195_철학에서_설계로.md](../100_philosophy/195_철학에서_설계로.md) -### 판단 책임 (Decision Accountability) -결정 결과뿐 아니라 "왜 그렇게 결정했는지"를 근거와 함께 설명하고, 이후 결과를 추적 가능한 형태로 남기는 원칙. - -### 메타평가 (Meta-Evaluation) -산출물 평가와 별도로 평가자/판단 체계 자체를 평가하는 계층. 정확도·일관성·공정성·설명력을 기준으로 신뢰도를 갱신한다. - -### 정책 외부화 (Policy Externalization) -가중치·컷오프·선발 기준을 코드 상수에 고정하지 않고 버전 정책으로 관리하는 방식. 증거 기반 갱신과 롤백을 가능하게 한다. - -## ㅊ - -### 체크포인트 (Checkpoint) -로빙의 상태를 특정 시점에 저장한 것. 문제 발생 시 이전 상태로 복원 가능. - -### 컨텍스트 윈도우 (Context Window) -LLM이 한 번에 처리할 수 있는 토큰의 최대 개수. 효율적인 메모리 관리로 제한된 윈도우 내에서 최대 성능 발휘. - -### 크로마디비 (ChromaDB) -오픈소스 벡터 데이터베이스. 로빙의 장기 기억과 시맨틱 검색을 담당하는 핵심 컴포넌트. - -## ㅍ - -### 프롬프트 엔지니어링 (Prompt Engineering) -LLM에게 최적의 응답을 유도하기 위해 입력을 설계하는 기법. 로빙의 성격과 능력 발현에 중요한 역할. - -### 파인튜닝 (Fine-tuning) -사전 학습된 모델을 특정 도메인이나 작업에 맞게 추가 학습시키는 과정. - ## ㅎ ### 하이브리드 메모리 (Hybrid Memory) 단기 메모리(세션)와 장기 메모리(ChromaDB)를 효율적으로 결합한 메모리 시스템. -### 함수형 스킬 (Functional Skill) -부작용 없이 입력에 대한 출력만 생성하는 순수 함수 형태로 구현된 스킬. 테스트와 조합이 용이함. - -### AI 에이전트 (AI Agent) -일반적인 AI 시스템을 지칭하는 용어. 로빙 문서에서는 가급적 '로빙' 또는 '존재형 에이전트'로 통일하여 사용. 타사 제품이나 일반론을 설명할 때만 사용. - -## 영문 - -### API (Application Programming Interface) -로빙과 외부 시스템이 통신하기 위한 인터페이스. RESTful API와 WebSocket을 지원. - -### CI/CD (Continuous Integration/Continuous Deployment) -코드 변경사항을 자동으로 빌드, 테스트, 배포하는 프로세스. Gitea Actions를 통해 구현. - -### DX (Developer Experience) -개발자가 로빙 플랫폼을 사용하고 확장할 때의 경험. 문서화, API 설계, SDK 품질 등을 포함. - -### GUI (Graphical User Interface) -로빙과 상호작용하기 위한 웹 기반 그래픽 인터페이스. 3열 레이아웃으로 구성. - -### LLM (Large Language Model) -GPT-4 등의 대규모 언어 모델. 로빙의 자연어 이해와 생성을 담당하는 핵심 기술. - -### MVP (Minimum Viable Product) -최소 기능 제품. 로빙 프로젝트의 첫 번째 마일스톤으로 기본 기능만 포함한 버전. - -### MMP (Minimum Marketable Product) -최소 시장 출시 제품. MVP 이후 상업적 가치를 가진 첫 번째 제품 버전. - -### NLP (Natural Language Processing) -자연어 처리. 인간의 언어를 컴퓨터가 이해하고 처리하는 기술. - -### pg_trgm -PostgreSQL 확장. 텍스트를 3글자(trigram) 단위로 쪼개 인덱싱하여 부분 문자열 매칭을 지원한다. 형태소 분석 없이 한국어 조사/복합어 문제를 보완하는 키워드 검색 축. - -### PoC (Proof of Concept) -개념 증명. 아이디어의 실현 가능성을 검증하기 위한 프로토타입. - -### RAG (Retrieval-Augmented Generation) -검색(Retrieval) + 생성(Generation) 결합 구조. 먼저 관련 문서를 검색하고, 검색 결과를 LLM 컨텍스트에 넣어 답변을 생성한다. 로빙의 Company X 내부 문서 답변에 사용. -관련 문서: -- [RAG 검색·Grounding 요청](../../workflow/03_rag/rag_search_grounding_request.md) - -### RRF (Reciprocal Rank Fusion) -여러 검색 결과의 순위를 합산하는 알고리즘. `score = 1/(k + rank)`. 로빙에서는 벡터·키워드·파일명·그래프 결과를 RRF로 합산 후 0~1 정규화. - -### Ralph Loop (랄프 루프) -AI가 완성 기준 충족 시까지 코드 작성·테스트·수정을 자동 반복하는 기법. 2026년 AI 코딩 트렌드로 부상. - -### RBAC (Role-Based Access Control) -역할 기반 접근 제어. 사용자의 역할에 따라 시스템 접근 권한을 관리하는 방식. - -### SaaS (Software as a Service) -서비스형 소프트웨어. 로빙을 클라우드 기반 구독 서비스로 제공하는 비즈니스 모델. - -### SDK (Software Development Kit) -소프트웨어 개발 도구. 개발자가 로빙 스킬을 만들거나 통합할 때 사용하는 라이브러리와 도구 모음. - -### SSL/TLS (Secure Sockets Layer/Transport Layer Security) -데이터 전송 시 암호화를 제공하는 보안 프로토콜. 모든 로빙 통신은 SSL/TLS로 보호됨. - -### UX (User Experience) -사용자 경험. 로빙과 상호작용하는 전체적인 경험을 설계하고 최적화하는 것. - -### WebSocket -실시간 양방향 통신을 위한 프로토콜. Slack 연동 및 실시간 응답에 사용됨. - --- ## 운영 -- 이 용어집은 지속적으로 업데이트된다. -- 용어 추가/수정 시 관련 문서 링크를 반드시 포함한다. -- 용어 변경이 있으면 철학/설계/운영 문서의 표기 정합성을 함께 점검한다. +- 이 용어집은 로빙 프로젝트 고유 용어만 수록한다. +- 시스템 공통 용어(스킬, 툴, 워크플로우, 하네스, 파이프라인 등)는 [시스템 용어집](/home/admin/0_VALUE/20_Governance/glossary.md)에서 관리한다. +- 용어 추가 시 "이것이 로빙 전용인가 시스템 공통인가"를 먼저 판단한다. diff --git a/skills/SKILL.md b/skills/SKILL.md index 9cb8790..000a473 100644 --- a/skills/SKILL.md +++ b/skills/SKILL.md @@ -17,7 +17,7 @@ tags: [robeing, skills, ssot] | **skill-email** | 8501 | Gmail 읽기/쓰기 | [skill-email/SKILL.md](skill-email/SKILL.md) | | **skill-news** | 8505 | 뉴스 수집·AI 요약 | [skill-news/SKILL.md](skill-news/SKILL.md) | | **skill-slack** | 8502 | Slack 대화 요약·액션 추출 | [skill-slack/SKILL.md](skill-slack/SKILL.md) | -| **skill-calendar** | 8512 | Google/Slack/네이버웍스 캘린더 | [skill-calendar/SKILL.md](skill-calendar/SKILL.md) | +| **skill-calendar** | 8512 | 일정 생성/조회/삭제 (Google Calendar) | [skill-calendar/SKILL.md](skill-calendar/SKILL.md) | | **skill-rag-file** | 8508 | PDF/DOCX RAG·문서 검색 | [skill-rag-file/SKILL.md](skill-rag-file/SKILL.md) | | **skill-embedding** | 8515 | 텍스트 임베딩·감정 분류 | [skill-embedding/SKILL.md](skill-embedding/SKILL.md) | | **skill-llm** | (내장) | 일반 대화·생성 | [skill-llm/SKILL.md](skill-llm/SKILL.md) | diff --git a/skills/approval/SKILL.md b/skills/approval/SKILL.md index 21a5632..1a2686f 100644 --- a/skills/approval/SKILL.md +++ b/skills/approval/SKILL.md @@ -1,6 +1,8 @@ --- name: approval description: 직전 대화에서 로빙이 무언가를 제안/확인한 상태에서 사용자가 승인하는 응답. "ㅇㅇ", "응", "그래", "해줘", "네", "yes", "좋아" 등 짧은 긍정 응답이 직전 제안 뒤에 오면 이 intent. 캘린더, 이메일, 어떤 스킬이든 적용. +runtime: + kind: internal_python --- # approval 직전 제안에 대한 범용 승인. 직전 대화의 intent에 따라 해당 스킬 실행. diff --git a/skills/blogwatcher/SKILL.md b/skills/blogwatcher/SKILL.md index 46c7188..c498551 100644 --- a/skills/blogwatcher/SKILL.md +++ b/skills/blogwatcher/SKILL.md @@ -1,6 +1,9 @@ --- name: blogwatcher description: RSS/블로그 피드 구독 및 새 글 모니터링. 사용자가 "블로그 구독해줘", "RSS 추가해", "새 글 있어?" 등 피드 관련 요청을 할 때 사용. +runtime: + kind: external_http + service_url_env: SKILL_NEWS_URL --- # blogwatcher diff --git a/skills/calendar-delete/SKILL.md b/skills/calendar-delete/SKILL.md deleted file mode 100644 index b36d6e5..0000000 --- a/skills/calendar-delete/SKILL.md +++ /dev/null @@ -1,6 +0,0 @@ ---- -name: calendar-delete -description: 캘린더 일정 삭제/취소. "그 일정 취소해줘", "내일 미팅 삭제해줘" 등 기존 일정을 제거하는 요청. ---- -# calendar-delete -일정 삭제 스킬. skill-calendar 서비스의 DELETE /api/events/{event_id} 호출. diff --git a/skills/calendar-event/SKILL.md b/skills/calendar-event/SKILL.md deleted file mode 100644 index f4dbfbb..0000000 --- a/skills/calendar-event/SKILL.md +++ /dev/null @@ -1,6 +0,0 @@ ---- -name: calendar-event -description: 캘린더 일정 등록/추가/생성. "내일 2시에 미팅 잡아줘", "모레 오전 10시 팀 회의 등록해줘", "금요일에 점심 약속 추가해줘" 등 새 일정을 만드는 요청. ---- -# calendar-event -일정 생성 스킬. skill-calendar 서비스의 POST /api/events 호출. diff --git a/skills/calendar-query/SKILL.md b/skills/calendar-query/SKILL.md deleted file mode 100644 index 0fe4713..0000000 --- a/skills/calendar-query/SKILL.md +++ /dev/null @@ -1,6 +0,0 @@ ---- -name: calendar-query -description: 캘린더 일정 조회/확인. "오늘 일정 뭐 있어?", "내일 스케줄 알려줘", "이번 주 일정 보여줘" 등 기존 일정을 확인하는 요청. ---- -# calendar-query -일정 조회 스킬. skill-calendar 서비스의 GET /api/events 호출. diff --git a/skills/companyx-rag/SKILL.md b/skills/companyx-rag/SKILL.md index eaf9e5a..bd87c4d 100644 --- a/skills/companyx-rag/SKILL.md +++ b/skills/companyx-rag/SKILL.md @@ -1,6 +1,8 @@ --- name: companyx-rag description: Use this skill when a Company X user asks for answers grounded in Company X internal documents, especially for evidence checks, internal-material summaries, program explanations, or document-based fact verification. +runtime: + kind: internal_python --- # Company X RAG diff --git a/skills/general_chat/SKILL.md b/skills/general_chat/SKILL.md new file mode 100644 index 0000000..8c64201 --- /dev/null +++ b/skills/general_chat/SKILL.md @@ -0,0 +1,12 @@ +--- +name: general_chat +description: 일반 대화, 잡담, 인사, 질문. 다른 스킬에 해당하지 않는 모든 요청을 처리한다. +runtime: + handler: app.services.skills.handlers.general_chat.handle +--- + +# general_chat + +## 언제 사용하는가 + +사용자가 일반적인 대화, 인사, 잡담, 정보 질문을 할 때 사용한다. 다른 스킬에 해당하지 않으면 이 스킬이 담당한다. diff --git a/skills/gitea/SKILL.md b/skills/gitea/SKILL.md index 966f067..9b8b621 100644 --- a/skills/gitea/SKILL.md +++ b/skills/gitea/SKILL.md @@ -1,6 +1,9 @@ --- name: gitea description: Gitea/GitHub 레포/이슈/PR 관리. "이슈 만들어", "PR 목록", "GitHub 레포" 등 Git 호스팅 관련 요청 시 사용. provider 파라미터로 gitea/github 전환. +runtime: + kind: external_http + service_url_env: SKILL_GITEA_URL --- # gitea diff --git a/skills/github-analyze/SKILL.md b/skills/github-analyze/SKILL.md index 1777024..2d88992 100644 --- a/skills/github-analyze/SKILL.md +++ b/skills/github-analyze/SKILL.md @@ -1,6 +1,8 @@ --- name: github-analyze description: GitHub 리포지토리·코드·커밋 히스토리·PR diff·브랜치 구조를 읽고 분석·요약·코드 리뷰(읽기)한다. 사용자가 레포 구조, 최근 변경, 특정 파일·모듈 설명, PR이 무엇을 바꿨는지, 의존성·보안 이슈를 읽기만으로 점검해 달라고 할 때 사용한다. Company X 내부 문서 근거(companyx-rag)와는 별개이며, 로컬에서 git push/commit을 실행하는 요청은 git-ops, GitHub 이슈·PR UI 조작은 github-manage이다. +runtime: + kind: internal_python --- # GitHub Analyze diff --git a/skills/github-manage/SKILL.md b/skills/github-manage/SKILL.md index c27b25b..75eb01b 100644 --- a/skills/github-manage/SKILL.md +++ b/skills/github-manage/SKILL.md @@ -1,6 +1,8 @@ --- name: github-manage description: GitHub 호스팅 기능으로 이슈·풀 리퀘스트·리뷰 코멘트·라벨·(정책이 허용하면) 머지·이슈 닫기·릴리스 초안 등을 다룬다. 사용자가 이슈를 만들거나, PR에 코멘트·승인·머지를 요청하거나, 이슈 상태를 바꾸라고 할 때 사용한다. 로컬 저장소에서 clone/pull/commit/push를 실행하는 요청은 git-ops, 순수 읽기 분석만이면 github-analyze이다. +runtime: + kind: internal_python --- # GitHub Manage diff --git a/skills/goosefarm-query/SKILL.md b/skills/goosefarm-query/SKILL.md index 7cb0fe8..8c02974 100644 --- a/skills/goosefarm-query/SKILL.md +++ b/skills/goosefarm-query/SKILL.md @@ -1,44 +1,13 @@ --- name: goosefarm-query -<<<<<<< HEAD -description: GooseFarm Investing 백엔드(배당·금·부동산·환율·암호화폐·M2) 데이터 조회. "배당 귀족주", "금 시세 분석", "서울 부동산 워터플로우", "환율", "비트코인 지표", "M2 통화량" 등 GooseFarm 도메인 질의 시 사용. -======= description: 배당주, 아파트, 금, 환율, M2, 암호화폐 등 자산 데이터를 GooseFarm API에서 조회하여 답변 ->>>>>>> 15fe2f3 (docs: 신규 스킬 7개 SKILL.md + 원칙 문서 중복 제거 + 구현 결과 문서) +runtime: + kind: external_http + service_url_env: GOOSEFARM_API_URL --- # goosefarm-query -<<<<<<< HEAD -rb8001 `GooseFarmQueryService`가 `GOOSEFARM_API_URL`(기본 `http://192.168.0.100:8200`)로 HTTP 조회합니다. - -## Trigger - -- `query_dividends`: 배당 귀족주 목록 또는 티커별 배당 이력 -- `query_gold`: 금(GOLD) 종합 분석 -- `query_realestate`: 지역별 부동산 워터플로우(기본 seoul) -- `query_forex`: 주요 환율 목록 -- `query_crypto`: 암호화폐 자산·지표 목록 -- `query_m2`: M2 국가별 목록 또는 국가별 분석 - -## Do - -- 환경변수 `GOOSEFARM_API_URL`로 베이스 URL 오버라이드 -- 타임아웃 30초, 실패 시 로그 후 빈 객체 반환(상위에서 처리) - -## Do Not - -- GooseFarm DB에 직접 접속하지 않음(HTTP API만) - -## API (GooseFarm 측) - -- `GET /api/dividends/aristocrats`, `GET /api/dividends/{ticker}/history` -- `GET /api/gold/GOLD/analysis` -- `GET /api/realestate/{region}/waterflow` -- `GET /api/market/forex/list` -- `GET /api/crypto/assets` -- `GET /api/market/m2/list`, `GET /api/market/m2/{country}/analysis` -======= GooseFarm 공개 API로 자산·시장 데이터를 조회해 수치 기반으로 답하는 스킬. ## Trigger @@ -77,4 +46,3 @@ GooseFarm 공개 API로 자산·시장 데이터를 조회해 수치 기반으 ## 환경변수 - `GOOSEFARM_API_URL=https://goosefarminvesting.com` — 기본 호스트; 실제 요청 경로는 `{GOOSEFARM_API_URL}` + 위 표의 경로(예: `/api/gold/assets`) ->>>>>>> 15fe2f3 (docs: 신규 스킬 7개 SKILL.md + 원칙 문서 중복 제거 + 구현 결과 문서) diff --git a/skills/himalaya/SKILL.md b/skills/himalaya/SKILL.md index f66029a..58c9dee 100644 --- a/skills/himalaya/SKILL.md +++ b/skills/himalaya/SKILL.md @@ -1,6 +1,9 @@ --- name: himalaya description: IMAP/SMTP 범용 메일 (Gmail 외). 회사·네이버웍스 등 일반 메일함 조회·전송 시 skill-email 확장 경로로 사용. +runtime: + kind: external_http + service_url_env: SKILL_EMAIL_URL --- # himalaya diff --git a/skills/self-inspect/SKILL.md b/skills/self-inspect/SKILL.md index 90225e3..e5c7cc3 100644 --- a/skills/self-inspect/SKILL.md +++ b/skills/self-inspect/SKILL.md @@ -1,6 +1,8 @@ --- name: self-inspect description: 로빙 자기 인식. 사용자 정보(이름/호칭/프로필) 답변, 시간/날짜 답변, 자기 코드/파일/컨테이너 탐색, NAS 드래프트 읽기/쓰기/기록/메모, 과거 대화 이력 검색, bash 명령 실행. 사용자가 자기 이름이나 정보를 물어볼 때, 로빙에게 무언가를 파일로 저장/기록/메모/NAS에 남기라고 할 때, 과거 대화를 물어볼 때, 시간/날짜를 물어볼 때 사용. +runtime: + handler: app.services.skills.handlers.self_inspect.handle --- # Self Inspect diff --git a/skills/session-logs/SKILL.md b/skills/session-logs/SKILL.md index c2a0b21..d706b16 100644 --- a/skills/session-logs/SKILL.md +++ b/skills/session-logs/SKILL.md @@ -1,6 +1,8 @@ --- name: session-logs description: 세션 로그 검색과 비용 조회. 사용자가 이전에 한 말이나 대화 이력을 찾고 싶을 때, 세션 비용이나 토큰 사용량을 확인하고 싶을 때 사용. +runtime: + kind: internal_python --- # Session Logs diff --git a/skills/skill-calendar/SKILL.md b/skills/skill-calendar/SKILL.md new file mode 100644 index 0000000..417fb73 --- /dev/null +++ b/skills/skill-calendar/SKILL.md @@ -0,0 +1,36 @@ +--- +name: skill-calendar +description: 캘린더 일정 생성, 조회, 삭제. 사용자가 "내일 2시에 미팅 잡아줘", "이번 주 일정 보여줘", "그 일정 취소해줘" 등 일정 관련 요청을 할 때 사용. +runtime: + kind: external_http + service_url_env: SKILL_CALENDAR_URL +--- + +# skill-calendar + +Google Calendar 통합 스킬. + +## 언제 사용하는가 + +사용자가 일정을 등록, 확인, 삭제하려 할 때 사용한다. + +## 일정 생성 + +POST /api/events + +| 파라미터 | 타입 | 필수 | 설명 | +|---------|------|------|------| +| title | string | 필수 | 일정 제목 | +| start | string | 필수 | 시작 일시. ISO 8601 형식 (예: 2026-04-04T14:00:00+09:00) | +| end | string | 필수 | 종료 일시. ISO 8601 형식. 미지정 시 start + 1시간 | +| location | string | 선택 | 장소 | +| description | string | 선택 | 설명, 메모 | +| is_all_day | boolean | 선택 | 종일 이벤트 여부. 기본 false | + +## 일정 조회 + +GET /api/events + +## 일정 삭제 + +DELETE /api/events/{event_id} diff --git a/skills/skill-creator/SKILL.md b/skills/skill-creator/SKILL.md index 20b6be5..be449e2 100644 --- a/skills/skill-creator/SKILL.md +++ b/skills/skill-creator/SKILL.md @@ -1,6 +1,8 @@ --- name: skill-creator description: 새 스킬 서비스 디렉터리·FastAPI 스캐폴드 생성. 개발자 전용 CLI 스크립트(create_skill.sh). +runtime: + kind: internal_python --- # skill-creator diff --git a/skills/skill-email/SKILL.md b/skills/skill-email/SKILL.md index 8fa76b2..737a155 100644 --- a/skills/skill-email/SKILL.md +++ b/skills/skill-email/SKILL.md @@ -1,6 +1,9 @@ --- name: skill-email description: Gmail API를 통한 이메일 읽기·쓰기·요약. 사용자가 "메일 확인해줘", "이메일 보내줘", "메일함 정리해줘" 등 이메일 관련 요청을 할 때 사용. +runtime: + kind: external_http + service_url_env: SKILL_EMAIL_URL --- # skill-email diff --git a/skills/skill-embedding/SKILL.md b/skills/skill-embedding/SKILL.md index 124b5fa..6670ce2 100644 --- a/skills/skill-embedding/SKILL.md +++ b/skills/skill-embedding/SKILL.md @@ -1,6 +1,9 @@ --- name: skill-embedding description: 텍스트를 벡터로 변환하는 임베딩 생성. 의도 분류, 감정 분석, RAG 검색 등에서 내부적으로 사용. 사용자가 직접 호출하는 스킬이 아님. +runtime: + kind: external_http + service_url_env: SKILL_EMBEDDING_URL --- # skill-embedding diff --git a/skills/skill-llm/SKILL.md b/skills/skill-llm/SKILL.md index 1c04b03..38664f1 100644 --- a/skills/skill-llm/SKILL.md +++ b/skills/skill-llm/SKILL.md @@ -1,6 +1,8 @@ --- name: skill-llm description: 로빙 내장 LLM. 일반 대화, 정보 질의, 문서 분석, 메모리 검색 등 다른 스킬에 해당하지 않는 요청을 처리. "안녕", "1+1은?", "Python 특징 알려줘" 등. +runtime: + handler: app.services.skills.handlers.internal_llm.handle --- # skill-llm diff --git a/skills/skill-news/SKILL.md b/skills/skill-news/SKILL.md index 8c11e70..937adbc 100644 --- a/skills/skill-news/SKILL.md +++ b/skills/skill-news/SKILL.md @@ -1,6 +1,9 @@ --- name: skill-news description: 뉴스 검색·스크래핑·AI 요약. 사용자가 "요즘 뉴스 있어?", "테크 업계 소식 찾아봐", "기사 요약해줘" 등 뉴스 관련 요청을 할 때 사용. +runtime: + kind: external_http + service_url_env: SKILL_NEWS_URL --- # skill-news diff --git a/skills/skill-rag-file/SKILL.md b/skills/skill-rag-file/SKILL.md index bc05981..34ff194 100644 --- a/skills/skill-rag-file/SKILL.md +++ b/skills/skill-rag-file/SKILL.md @@ -1,6 +1,9 @@ --- name: skill-rag-file description: PDF·DOCX·스프레드시트·텍스트 등 문서 파일을 RAG로 처리·검색한다. 사용자가 문서 파일을 첨부했거나 "이 문서 분석해줘", "계약서 위험 조항 찾아줘", "IR 자료 요약해줘" 등 문서 기반 요청을 할 때 사용한다. 텍스트가 거의 없어도 첨부 메타가 문서면 이 스킬이 1차 후보다. +runtime: + kind: external_http + service_url_env: SKILL_RAG_FILE_URL --- # skill-rag-file diff --git a/skills/skill-slack/SKILL.md b/skills/skill-slack/SKILL.md index 205c275..c7ce7d6 100644 --- a/skills/skill-slack/SKILL.md +++ b/skills/skill-slack/SKILL.md @@ -1,6 +1,9 @@ --- name: skill-slack description: Slack 대화 요약, 스레드 다이제스트, 액션 아이템 추출. 사용자가 "스레드 요약해줘", "대화 정리해줘", "할 일만 뽑아줘" 등 Slack 관련 요청을 할 때 사용. +runtime: + kind: external_http + service_url_env: SKILL_SLACK_URL --- # skill-slack diff --git a/skills/skill-translate/SKILL.md b/skills/skill-translate/SKILL.md index de07881..8d7a62f 100644 --- a/skills/skill-translate/SKILL.md +++ b/skills/skill-translate/SKILL.md @@ -1,10 +1,8 @@ --- name: skill-translate -<<<<<<< HEAD -description: Translate text between languages. Triggers on 번역해줘, translate this, 영어로 바꿔줘, ~를 한국어로. -======= description: Translate text between languages. Triggers on requests like 번역해줘, translate this, 영어로 바꿔줘, ~를 한국어로, etc. ->>>>>>> 15fe2f3 (docs: 신규 스킬 7개 SKILL.md + 원칙 문서 중복 제거 + 구현 결과 문서) +runtime: + kind: internal_python --- # skill-translate ## Trigger @@ -13,11 +11,7 @@ description: Translate text between languages. Triggers on requests like 번역 ## Do - Translate the given text to the target language - Preserve formatting and tone -<<<<<<< HEAD -- Support: Korean, English, Japanese, Chinese -======= - Support: Korean, English, Japanese, Chinese at minimum ->>>>>>> 15fe2f3 (docs: 신규 스킬 7개 SKILL.md + 원칙 문서 중복 제거 + 구현 결과 문서) ## Do Not - Do not add explanations unless asked - Do not modify the original meaning diff --git a/skills/summarize/SKILL.md b/skills/summarize/SKILL.md index 5cde92e..cef8c9e 100644 --- a/skills/summarize/SKILL.md +++ b/skills/summarize/SKILL.md @@ -1,6 +1,9 @@ --- name: summarize description: URL/유튜브/텍스트 요약. 사용자가 "이 링크 요약해줘", "유튜브 요약", "텍스트 요약해" 등 요약 관련 요청을 할 때 사용. +runtime: + kind: external_http + service_url_env: SKILL_SUMMARIZE_URL --- # summarize diff --git a/skills/web-search/SKILL.md b/skills/web-search/SKILL.md index 5447b86..74390eb 100644 --- a/skills/web-search/SKILL.md +++ b/skills/web-search/SKILL.md @@ -1,6 +1,8 @@ --- name: web-search description: 실시간 웹 검색. 지역별 날씨·기온·강수·기상 예보·미세먼지·초미세먼지·황사·대기 질 등 공개 기상 정보, 주가, 환율, 시세, 뉴스, 회사/기술/제품 정보 등 인터넷에서 찾아야 하는 실시간 정보 요청에 사용합니다. Company X 내부 문서 근거(companyx-rag)가 아닌 일반 기상·환경 질의는 항상 여기에 해당합니다. 검색 전에는 사용자 의미를 보존한 검색 주제와 실제 검색 엔진용 최적화 쿼리를 구분하고, 정정 신호와 보호 표현을 반영해야 합니다. +runtime: + handler: app.services.skills.handlers.web_search.handle --- # Web Search diff --git a/skills/whisper/SKILL.md b/skills/whisper/SKILL.md index 862969e..015dfe2 100644 --- a/skills/whisper/SKILL.md +++ b/skills/whisper/SKILL.md @@ -1,6 +1,9 @@ --- name: whisper description: 음성 파일을 텍스트로 변환한다. 사용자가 오디오 파일을 첨부했거나 "이 파일 전사해줘", "회의록 작성해줘", "전사해줘" 등 음성 인식 요청을 할 때 사용한다. 텍스트가 거의 없어도 첨부 메타가 오디오면 이 스킬이 1차 후보다. +runtime: + kind: external_http + service_url_env: SKILL_WHISPER_URL --- # whisper