Files
openclaw-backups/skills/openclaw-self-healing/docs/DISCORD-FORMATTING-STRATEGY.md

8.6 KiB
Raw Blame History

Discord 가독성 향상 전략

Telegram보다 풍부한 Discord 포맷팅 기능을 최대한 활용


1 대화 시작 시 헤더 적용

Before (평범)

안녕하세요. 자비스입니다.

After (임팩트)

# 🤖 Jarvis Online

-# v2.0 | Claude Sonnet 4-5 | 2026.02.04

적용 대상:

  • 모닝 브리핑
  • 저녁 Wrap-up
  • 주간 요약
  • 시스템 알림

효과: 섹션 구분 명확, 전문성 향상


2 ANSI 컬러 블록 (상태 표시)

컬러 매핑

\u001b[1;32m✅ SUCCESS\u001b[0m      (녹색 볼드)
\u001b[1;33m⚠ WARNING\u001b[0m      (노란색 볼드)
\u001b[1;31m❌ ERROR\u001b[0m        (빨간색 볼드)
\u001b[1;34m INFO\u001b[0m         (파란색 볼드)
\u001b[1;35m🔮 INSIGHT\u001b[0m      (핑크 볼드)
\u001b[1;36m💡 TIP\u001b[0m          (시안 볼드)

적용 예시:

TQQQ 모니터링 결과:

```ansi
\u001b[1;32m✅ +2.4% 상승\u001b[0m
\u001b[1;34m 전략: HOLD\u001b[0m

**주의:** 모바일 미지원 (Desktop only)

---

## 3⃣ 서브텍스트 활용 (메타 정보)

### 용도
- 데이터 출처
- 마지막 업데이트 시각
- 면책 조항

**예시:**

📈 TQQQ 실시간 모니터링

현재가: $68.42 (₩99,421) 변동: +1.2%

-# Yahoo Finance 15분 지연 | 업데이트: 16:00 KST


---

## 4⃣ 블록 인용 (중요 메시지 강조)

### 단일 라인 인용 (>)

⚠️ 손절가 근접: $48.60 (현재가 대비 -29%)


### 멀티라인 인용 (>>>)

📊 자기평가 완성도: 5/5 정확성: OK 톤: Jarvis 개선: 환율 설명 간결화


**적용:** 크론 자기평가 섹션

---

## 5⃣ 마스크 링크 (가독성)

### Before

https://github.com/openclaw/openclaw/issues/123


### After

Issue #123 - TQQQ 모니터링 개선


**적용:** 뉴스 링크, GitHub 이슈, 참고 자료

---

## 6⃣ 구조화된 리스트

### Unordered (작업 목록)

오늘 할 일:

  • 조식비 챙기기
  • TQQQ 매수
  • 블로그 포스팅

### Ordered (순서 중요)

배포 절차:

  1. 테스트 실행
  2. 코드 리뷰
  3. 프로덕션 배포

---

## 7⃣ 테이블 (비교/통계)

Discord는 테이블 완벽 지원!

포트폴리오 요약

종목 현재가 변동 평가액
TQQQ $68.42 +2.4% ₩3,214,587
SOXL $42.10 -1.2% ₩1,987,320
NVDA $134.5 +0.8% ₩5,023,450

**주의:** 테이블 앞뒤 빈 줄 1개 필수 (MEMORY.md 규칙)

---

## 8⃣ 코드 블록 (Syntax Highlighting)

### Bash 명령어
~/openclaw/skills/yahoo-finance/yf TQQQ

### JSON 데이터
{
  "symbol": "TQQQ",
  "price": 68.42,
  "change": 2.4
}

### Python 스크립트
def get_stock_price(symbol):
    return yfinance.Ticker(symbol).info['regularMarketPrice']

---

## 9⃣ 스포일러 (장문 숨기기)

**사용처:** 에러 로그, 디버그 정보, 상세 데이터

```
**에러 발생**
||
Traceback (most recent call last):
  File "main.py", line 42
    print(undefined_var)
NameError: name 'undefined_var' is not defined
||
```

클릭 전까지 숨김 → 가독성 향상

---

## 🔟 타임스탬프 (시간 표시)

**유닉스 타임스탬프 → 사용자 로컬 시간**

```
다음 크론 실행: <t:1770192000:R>
```

→ "2시간 후" (사용자 타임존 자동 적용)

**형식:**
- `:t` - 시간만 (16:00)
- `:T` - 시간 (초 포함) (16:00:00)
- `:d` - 날짜 (02/04/2026)
- `:D` - 날짜 (February 4, 2026)
- `:f` - 날짜+시간 (February 4, 2026 4:00 PM)
- `:F` - 긴 형식 (Tuesday, February 4, 2026 4:00 PM)
- `:R` - 상대 시간 (2 hours ago / in 2 hours)

---

## 📋 크론별 적용 전략

### TQQQ 15분 모니터링
```
# 📊 TQQQ Live Monitor

**현재 시각:** <t:1770187500:f>

| 항목       | 달러       | 원화           |
|-----------|-----------|----------------|
| 현재가     | $68.42    | ₩99,421        |
| 매수가     | $52.26    | ₩76,033        |
| 손익       | +$16.16   | +₩1,099,256    |

```ansi
\u001b[1;32m✅ 전략: HOLD\u001b[0m
\u001b[1;34m 근거: 상승 추세 지속\u001b[0m
```

>>> **📊 자기평가**
✅ 완성도: 5/5
✅ 정확성: OK
✅ 톤: Jarvis
✅ 간결성: 2 emojis
💡 개선: 환율 설명 1줄로 압축

-# Yahoo Finance 15분 지연 | 환율: 실시간 API
```

---

### 모닝 브리핑
```
# ☀️ Good Morning, Sir.

-# 2026.02.04 Tuesday | Seoul, South Korea

## 💱 환율
USD/KRW: ₩1,449.36 (+0.12%)

## 📈 포트폴리오

| 종목  | 현재가  | 변동   |
|-------|---------|--------|
| TQQQ  | $68.42  | +2.4%  |
| SOXL  | $42.10  | -1.2%  |
| NVDA  | $134.5  | +0.8%  |

## 🔥 Hot Scanner
1. NVDA - AI 칩 수요 급증
2. TSLA - 실적 서프라이즈
3. AAPL - iPhone 16 판매 호조

## 🔮 Rumor Scanner

```ansi
\u001b[1;35m🔮 High Impact (8.5/10)\u001b[0m
```

> NVDA-ARM 인수설 (WSJ 보도)

## 💡 오늘의 전략
TQQQ HOLD, NVDA 추가 매수 검토

>>> **📊 자기평가**
✅ 완성도: 5/5
✅ 정확성: OK
✅ 톤: Jarvis
✅ 간결성: 4 emojis
💡 개선: Hot Scanner 3개→2개로 압축
```

---

### IT/AI 뉴스 브리핑
```
# 📰 IT/AI 뉴스 브리핑

-# 12:00 점심 브리핑 | 2026.02.04

## Top Headlines

1. **Claude Opus 4.5 출시**
   [Anthropic 공식 발표](https://anthropic.com/news/opus-4-5)
   - 성능 30% 향상
   - 코딩 능력 GPT-5 수준

2. **OpenAI GPT-5 연기설**
   출처: The Information
   - 2027년 Q1로 연기 가능성

3. **삼성 GAA 3nm 양산 돌입**
   반도체 업계 지각 변동

## 🤖 AI 트렌드

> 온디바이스 AI가 2026년 주류로

**Key Insight:**
Apple, Google 모두 로컬 AI 모델 강화 중

>>> **📊 자기평가**
✅ 완성도: 3/3
⚠️ 정확성: OK (출처 명시 필요했음)
✅ 톤: Jarvis
✅ 간결성: 2 emojis
💡 개선: 헤드라인 3개→2개, 한 줄 설명 추가
```

---

## 🚫 금지 사항 (MEMORY.md 기준)

### 절대 금지
1. **소제목 앞뒤 빈 줄 없음**
   ```
   ## 헤더
   내용
   ```
   → 잘못됨 (빈 줄 필요)

2. **테이블 앞뒤 빈 줄 없음**
   ```
   설명
   | A | B |
   다음 내용
   ```
   → 잘못됨

3. **이모지 4개 이상**
   → 3개 이하 유지

4. **구분선(---) 남발**
   → 최대 2개 (대주제 전환만)

### 권장 금지
1. **링크 여러 개 embed**
   ```
   https://link1.com
   https://link2.com
   ```
   → `<https://link1.com>` 형태로

2. **불릿 포인트 (-, *)**
   → Discord는 지원하지만 텔레그램과 일관성 위해 번호 리스트 권장

---

## 📊 적용 우선순위

### High Priority (즉시 적용)
1. **헤더 (#, ##, ###)** - 모든 크론
2. **서브텍스트 (-#)** - 메타 정보
3. **ANSI 컬러** - 상태 표시 (TQQQ, 시스템 상태)
4. **블록 인용 (>>>)** - 자기평가 섹션
5. **테이블** - 포트폴리오, 비교 데이터

### Medium Priority (이번 주)
6. **마스크 링크** - 뉴스, GitHub
7. **타임스탬프** - 크론 실행 시각
8. **코드 블록 syntax** - 명령어, 로그

### Low Priority (장기)
9. **스포일러** - 에러 로그
10. **Ordered 리스트** - 절차, 순서

---

## 🎯 성공 지표

**Before (평범한 답변):**
- 텍스트만
- 이모지 과다
- 가독성 낮음

**After (Discord 최적화):**
- 헤더로 섹션 구분
- ANSI 컬러로 상태 강조
- 테이블로 데이터 정리
- 서브텍스트로 메타 정보
- 블록 인용으로 중요 내용 강조

**측정:**
- 정우님 "읽기 편하다" 피드백
- 크론 자기평가에서 "가독성" 항목 추가
- Discord 전용 기능 활용률 (주간 리포트)

---

## 📝 Next Steps

1. **MEMORY.md 업데이트**
   - Discord 전용 섹션 추가
   - 예시 템플릿 포함

2. **크론 프롬프트 수정**
   - 헤더, 서브텍스트 기본 적용
   - ANSI 컬러 가이드라인 추가

3. **자기평가 항목 추가**
   - 기존: 완성도/정확성/톤/간결성/개선
   - 추가: **가독성** (Discord 포맷 활용도)

4. **주간 리포트에 통계 추가**
   - Discord 고급 기능 활용 횟수
   - 가독성 향상 사례

---

**최종 체크리스트:**

- [ ] MEMORY.md에 Discord 포맷팅 규칙 추가
- [ ] 14개 크론에 헤더 적용
- [ ] TQQQ 크론에 ANSI 컬러 + 테이블 적용
- [ ] 자기평가 섹션에 블록 인용 적용
- [ ] 모닝/저녁 브리핑에 서브텍스트 추가
- [ ] 뉴스 브리핑에 마스크 링크 적용
- [ ] 자기평가에 "가독성" 항목 추가