yuanbao

스킬명: yuanbao
분류: yuanbao
공식 설명: Yuanbao (元宝) groups: @mention users, query info/members.
작성 기준: Hermes Agent 공식 Bundled Skills Catalog, 2026-06-24 확인

한 줄 요약

yuanbao는 Hermes Agent가 Yuanbao 그룹에서 특정 사용자를 찾고, 정확한 닉네임으로 @멘션하거나, 그룹 정보·멤버 목록·DM 전송을 처리하도록 안내하는 플랫폼 전용 스킬입니다.

공식 설명 번역

공식 문서의 요지는 다음과 같습니다.

Yuanbao(元宝) 그룹에서 사용자를 @멘션하고, 그룹 정보와 멤버 정보를 조회한다.

공식 SKILL.md의 핵심 지시는 더 구체적입니다.

에이전트의 텍스트 답변 자체가 그룹 또는 사용자에게 전송되는 메시지입니다.
Yuanbao 게이트웨이는 답변 안의 @nickname을 실제 멘션으로 변환합니다.
사용자를 멘션해야 할 때는 먼저 yb_query_group_members로 정확한 닉네임을 조회해야 합니다.
Yuanbao DM은 일반 send_message가 아니라 yb_send_dm 도구를 사용해야 합니다.
그룹 정보는 yb_query_group_info, 멤버 조회는 yb_query_group_members, DM 전송은 yb_send_dm이 담당합니다.

이 스킬은 단순한 “Yuanbao 사용법”이 아니라, Hermes가 Yuanbao 안에서 말하고 행동하는 방식을 오해하지 않도록 강제하는 운영 지침에 가깝습니다.

이 스킬이 해결하는 문제

메시징 플랫폼 연동에서 에이전트가 자주 저지르는 실수는 “플랫폼별 전송 방식”을 일반화하는 것입니다. Slack, Discord, Telegram, Yuanbao는 모두 채팅 플랫폼이지만, 멘션과 DM 처리 방식은 다릅니다.

yuanbao 스킬은 특히 다음 문제를 줄여줍니다.

Yuanbao 그룹에서 @멘션을 해야 하는데 “제가 직접 멘션할 수 없습니다”라고 잘못 답하는 문제
사용자의 표시 이름을 추측해서 잘못된 닉네임으로 멘션하는 문제
그룹 코드를 현재 chat_id에서 추출해야 하는데 이를 놓치는 문제
Yuanbao DM 요청에 일반 메시지 전송 도구를 사용하려는 문제
그룹 멤버와 Yuanbao AI assistant, bot, 일반 사용자를 구분하지 못하는 문제

핵심 동작 구조

flowchart TD
  A[사용자 요청 수신] --> B{요청 유형 판단}
  B -->|특정 사용자 멘션| C[yb_query_group_members: find + mention=true]
  C --> D[정확한 nickname 확보]
  D --> E[최종 답변에 @nickname 포함]
  E --> F[게이트웨이가 실제 멘션으로 변환]

  B -->|그룹 정보 확인| G[yb_query_group_info]
  G --> H[그룹명·소유자·멤버 수 보고]

  B -->|멤버 검색/목록| I[yb_query_group_members]
  I --> J[find/list_bots/list_all 결과 보고]

  B -->|DM/私信 전송| K[yb_send_dm]
  K --> L[전송 결과 보고]

이 흐름에서 중요한 점은 마지막 단계입니다. Yuanbao 그룹에 보내는 일반 답변은 별도 전송 도구를 호출하는 것이 아니라, Hermes의 최종 답변 텍스트가 그대로 전송 메시지가 된다는 전제를 갖습니다.

적합한 사용 상황

이 스킬은 다음 상황에 적합합니다.

Yuanbao 그룹에서 특정 사용자를 찾아 @멘션해야 할 때
Yuanbao 그룹의 이름, 소유자, 멤버 수 같은 기본 정보를 확인해야 할 때
그룹 멤버 중 특정 이름을 가진 사람을 찾아야 할 때
Yuanbao AI assistant 또는 bot 계정을 구분해서 확인해야 할 때
Yuanbao 안에서 특정 사용자에게 DM 또는 私信을 보내야 할 때
중국어권 그룹 운영 환경에서 Hermes를 보조 운영자로 활용할 때

예를 들어 사용자가 “元宝를 불러줘”, “某某에게 DM 보내줘”, “이 그룹에 봇이 누구누구 있어?”라고 요청하는 상황에 맞습니다.

부적합하거나 주의해야 할 상황

다음 상황에서는 이 스킬만으로 충분하지 않거나, 다른 플랫폼 스킬과 구분해야 합니다.

Slack, Discord, Telegram, Matrix 같은 다른 메시징 플랫폼의 멘션 처리
Yuanbao가 아닌 일반 웹 UI 자동화
그룹 바깥의 임의 사용자에게 무단으로 메시지를 보내는 요청
멤버 이름이 여러 명에게 부분 일치하여 후보가 여러 개 나오는 경우
사용자가 민감한 개인정보나 비공개 파일을 DM으로 보내라고 요청하는 경우
현재 대화의 chat_id에서 group_code를 추출할 수 없는 경우

특히 멘션은 추측하면 안 됩니다. 공식 스킬은 yb_query_group_members로 먼저 정확한 닉네임을 얻으라고 지시합니다. 같은 표시 이름을 가진 사람이 있거나, 유사한 닉네임이 여러 개 있을 수 있기 때문입니다.

실무 관점의 해석

yuanbao 스킬은 기능 수가 많은 스킬은 아닙니다. 하지만 메시징 게이트웨이와 플랫폼 문맥을 정확히 이해해야 하므로, 운영상 중요도는 낮지 않습니다.

핵심은 다음 세 가지입니다.

답변이 곧 전송 메시지다
Yuanbao 그룹 응답에서는 “메시지를 보내는 도구”를 따로 찾는 사고방식을 버려야 합니다. 최종 답변이 곧 전송 본문입니다.
멘션은 닉네임 정확도가 생명이다
@nickname이 실제 멘션으로 변환되려면 플랫폼이 인식하는 정확한 닉네임이 필요합니다. 그래서 먼저 멤버 조회가 필요합니다.
DM은 별도 도구를 쓴다
일반 그룹 응답과 달리 개인 메시지는 yb_send_dm이 담당합니다. DM 요청을 그룹 답변으로 대체하면 요구를 충족하지 못합니다.

사용 흐름 마인드맵

# yuanbao 사용 판단

## 멘션 요청
- 대상 이름 확인
- `yb_query_group_members`
  - `action="find"`
  - `mention=true`
- 정확한 nickname 확보
- 최종 답변에 `@nickname` 포함

## 그룹 정보 요청
- `yb_query_group_info`
- 그룹명
- owner
- member count

## 멤버 조회 요청
- `yb_query_group_members`
- `find`
- `list_bots`
- `list_all`

## DM 요청
- `yb_send_dm`
- `group_code`
- 대상 `name` 또는 `user_id`
- message
- optional media_files

## 주의
- 닉네임 추측 금지
- 다른 플랫폼 멘션 방식과 혼동 금지
- 민감정보 전송 주의

실제 사용 예시

예시 1. Yuanbao 그룹에서 특정 사용자를 멘션하기

사용자가 이렇게 요청할 수 있습니다.

元宝 좀 불러줘.

이때 Hermes는 곧바로 @元宝라고 추측해서 답하지 않고, 먼저 그룹 멤버에서 정확한 닉네임을 찾습니다.

{
  "group_code": "328306697",
  "action": "find",
  "name": "元宝",
  "mention": true
}

도구 결과에서 정확한 닉네임이 元宝로 확인되면 최종 답변은 짧고 자연스럽게 작성합니다.

@元宝 민항님이 찾고 계십니다.

이 답변은 단순 텍스트처럼 보이지만, Yuanbao 게이트웨이가 @元宝 부분을 실제 멘션으로 변환합니다.

예시 2. Yuanbao 그룹의 봇 목록 확인

이 Yuanbao 그룹에 봇이나 AI assistant가 누가 있는지 확인해줘.

예상 처리 흐름:

현재 대화의 chat_id에서 group_code를 추출합니다.
yb_query_group_members를 action="list_bots"로 호출합니다.
결과를 일반 사용자, Yuanbao AI assistant, bot 기준으로 정리해서 답합니다.

답변 예시는 다음과 같은 형태가 적절합니다.

현재 그룹에서 확인된 bot/AI assistant는 다음과 같습니다.

- 元宝: yuanbao_ai
- 배포도우미: bot

단, 실제 이름과 역할은 반드시 도구 결과에 근거해야 합니다.

예시 3. 특정 사용자에게 DM 보내기

사용자 aea3에게 "회의 자료 확인 부탁드립니다"라고 DM 보내줘.

이 경우 그룹에 @사용자 aea3를 남기는 것이 아니라 yb_send_dm을 사용합니다.

{
  "group_code": "535168412",
  "name": "사용자 aea3",
  "message": "회의 자료 확인 부탁드립니다."
}

전송이 끝나면 결과를 간단히 보고합니다.

사용자 aea3에게 DM을 보냈습니다.

함께 쓰기 좋은 스킬

관련 스킬	함께 쓰는 이유
`external-platform-automation`	외부 플랫폼을 공식 도구와 게이트웨이 규칙에 맞춰 자동화하는 관점이 유사합니다.
`productivity-platform-workflows`	Yuanbao에서 받은 요청을 문서, 회의, 업무 플랫폼 처리로 이어갈 때 유용합니다.
`hermes-agent`	Hermes의 게이트웨이, 플랫폼 연동, 도구 호출 구조를 이해하는 데 필요합니다.
`webhook-subscriptions`	Yuanbao 외부 이벤트를 Hermes 실행으로 연결하는 구조를 설계할 때 함께 검토할 수 있습니다.

운영 체크리스트

Yuanbao 그룹에서 이 스킬을 사용할 때는 다음을 확인합니다.

현재 대화가 Yuanbao 그룹 문맥인지 확인했다.
group_code를 현재 chat_id `group_code`를 현재 `chat_id`에서 정확히 추출했다.
멘션 대상은 yb_query_group_members 멘션 대상은 `yb_query_group_members`로 먼저 조회했다.
최종 답변에 들어가는 @nickname 최종 답변에 들어가는 `@nickname`은 도구 결과에 근거한다.
DM 요청에는 yb_send_dm DM 요청에는 `yb_send_dm`을 사용했다.
후보가 여러 명이면 임의로 고르지 않고 사용자에게 확인한다.
민감한 정보나 파일을 DM으로 보낼 때는 요청의 정당성과 범위를 확인한다.
Slack/Discord/Telegram 방식과 Yuanbao 방식을 혼동하지 않는다.

이 스킬의 한계

yuanbao는 Yuanbao 플랫폼 안에서의 그룹 상호작용을 돕는 스킬입니다. 따라서 다음을 대신해주지는 않습니다.

Yuanbao 계정 권한 자체의 생성 또는 승인
플랫폼 정책을 우회한 메시지 전송
모든 그룹 멤버의 개인정보 수집
Yuanbao 외부 시스템의 업무 처리
다른 메시징 플랫폼의 멘션 규칙 처리

또한 에이전트가 멤버 목록을 조회할 수 있더라도, 그 결과를 과도하게 노출하는 것은 별개의 운영 판단 문제입니다. “가능하다”와 “공유해도 된다”는 다릅니다.

문서 작성 체크리스트

공식 문서와 SKILL.md 원문 요지를 확인했다.
공식 설명과 실무 해설을 분리했다.
사용 예시를 최소 2개 이상 넣었다.
추천 대상과 주의 상황을 모두 적었다.
관련 스킬을 연결했다.
published `published` 값에 시분초가 포함되어 있다.
백그라운드 이미지가 hermes_bg.png 백그라운드 이미지가 `hermes_bg.png`로 지정되어 있다.
mdweb2에서 해석 가능한 Mermaid와 Markmap 문법을 필요한 범위에서 사용했다.