b3os-slack-formatlisted

# b3os-slack-format — 슬랙 메시지 포맷 ## 언제 작동? (트리거 규율) - 슬랙에 **길거나 단계가 있는** 메시지(실행 절차·검증·인수인계·보고·체크리스트)를 올리기 직전. - "슬랙 포맷 해줘 / 정리해서 슬랙에 / slack 메시지 다듬어". - 단발 한 줄 채팅·텔레그램은 대상 아님(슬랙 게시물 전용). 보고서는 `b3os-report`, 슬라이드는 `b3rys-make-ppt`. ## 왜? (the team lead 2026-06-25) 팀원이 슬랙에 평문(plain text)으로 길게 올리면 읽기 나쁘다. 슬랙은 마크다운과 문법이 달라서 `**볼드**`·`## 헤더`가 그대로 노출된다. 이 스킬로 **Slack mrkdwn + 운영 보고 구조**를 입혀 일관되게 읽히게 한다. ## Slack mrkdwn 핵심 (마크다운과 다름 — 꼭 기억) - **볼드** = `*text*` (별 1개. `**text**` 아님) - 이탤릭 = `_text_` · 취소선 = `~text~` - **헤더(`#`,`##`) 없음** → `*볼드 줄*` 로 섹션 제목 - 불릿 = `•` (`-`/`*` 를 `•` 로) - 링크 = `<url|텍스트>` (`[텍스트](url)` 아님) - 코드 `` `x` `` / 코드블록 ```` ```x``` ```` 은 그대로 - 줄바꿈은 실제 개행(`\n`). 섹션 사이 빈 줄로 숨 쉬게. ## 일반 메시지 포맷 (briefing agent 스타일 — 읽기 좋은 기본) briefing-agent 스타일처럼 가볍고 읽히는 일반 메시지 패턴. Block Kit 컬러바 없이 mrkdwn만으로 충분히 깔끔: - `*제목*` (또는 `*01. 섹션*`) — 볼드 헤더로 구분 - `> 핵심 한 줄` — 인용 블록(슬랙이 왼쪽 세로 바로 강조 — briefing agent의 그 바 느낌) - `• 불릿` — 핵심만 짧게 - `*라벨:* 내용` — 'the team lead 관점:' 같은 볼드 라벨 + 설명 - `` `용어`/`명령` `` — 인라인 코드(주황 하이라이트) - 섹션 사이 빈 줄로 숨 쉬게 → md-to-slack.py 가 `##`→`*볼드*`, `>` 유지, `-`→`•`, `**`→`*`, 코드 보존을 전부 처리하므로 마크다운으로 쓰고 변환만 하면 이 모양이 나온다. (briefing agent의 섹션별 컬러 세로바·"자세히 표시" 접기는 Slack **Block Kit/attachment(color)** 가 필요 — 리치 버전은 별도 옵션. 일반 메시지엔 위 mrkdwn `>`·볼드로 충분.) ## 운영 보고 구조 (길거나 단계 있는 메시지) 단순 "예쁘게"가 아니라 **검증 가능한 형태**로. 권장 골격: ``` *[제목]* — 무엇을 하는지 1줄 *목적:* 왜 하는지 1~2줄 *절차:* • 1단계 … • 2단계 … *통과 기준:* 무엇이면 OK *실패 시:* 단계·증상·다음 액션 *owner:* 담당자 · *ETA:* 예상 완료 · *근거:* evidence(있으면