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

442 lines
8.6 KiB
Markdown
Raw Permalink Blame History

This file contains invisible Unicode characters
This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Discord 가독성 향상 전략
> Telegram보다 풍부한 Discord 포맷팅 기능을 최대한 활용
---
## 1⃣ 대화 시작 시 헤더 적용
### Before (평범)
```
안녕하세요. 자비스입니다.
```
### After (임팩트)
```
# 🤖 Jarvis Online
-# v2.0 | Claude Sonnet 4-5 | 2026.02.04
```
**적용 대상:**
- 모닝 브리핑
- 저녁 Wrap-up
- 주간 요약
- 시스템 알림
**효과:** 섹션 구분 명확, 전문성 향상
---
## 2⃣ ANSI 컬러 블록 (상태 표시)
### 컬러 매핑
```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 모니터링 개선](https://github.com/openclaw/openclaw/issues/123)
```
**적용:** 뉴스 링크, GitHub 이슈, 참고 자료
---
## 6⃣ 구조화된 리스트
### Unordered (작업 목록)
```
**오늘 할 일:**
- [ ] 조식비 챙기기
- [x] 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 명령어
````
```bash
~/openclaw/skills/yahoo-finance/yf TQQQ
```
````
### JSON 데이터
````
```json
{
"symbol": "TQQQ",
"price": 68.42,
"change": 2.4
}
```
````
### Python 스크립트
````
```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 컬러 + 테이블 적용
- [ ] 자기평가 섹션에 블록 인용 적용
- [ ] 모닝/저녁 브리핑에 서브텍스트 추가
- [ ] 뉴스 브리핑에 마스크 링크 적용
- [ ] 자기평가에 "가독성" 항목 추가