b3os-slack-format

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(있으면)

• 단계는 번호/불릿으로 끊어 한 줄씩. 코드·명령은 코드블록.
• 짧은 메시지는 골격 강요하지 말고 mrkdwn(볼드·불릿)만 입혀도 됨.

사용법 (다듬기 → 변환 → 게시)

1. 한국어 윤문 패스(선택): 길거나 공유·게시용 본문은 게시 전에 번역투·기계적 병렬·영어 라벨 남발을 줄인다. 단 긴급·짧은 ack·기계 출력·로그 원문은 예외. 산문을 다듬는 단계이므로 아래 mrkdwn 변환 전에 한다. ★humanize-korean 스킬은 이 저장소에 포함되어 있지 않고 install.sh가 설치하지도 않는다★(외부 스킬 — MIT, 원저자 epoko77-ai). 이미 설치해 둔 사람만 그 스킬로 돌리고, 없으면 이 단계는 직접 읽어보며 다듬는 것으로 갈음한다. 이 단계가 없다고 게시가 막히지는 않는다.
2. 마크다운/평문으로 내용 작성(+0의 윤문 결과) → 변환:

python3 skills/b3os-slack-format/scripts/md-to-slack.py <input.md>     # 또는 stdin

(**볼드**→*볼드*, ##헤더→*헤더*, -불릿→•, [텍스트](url)→<url|텍스트>, 코드/코드블록 보존) 2) 변환 결과를 슬랙에 게시:

curl -s -X POST http://127.0.0.1:7878/team/api/slack/post \
  -H "Content-Type: application/json" \
  -d "$(python3 -c 'import json,sys;print(json.dumps({"agent_id":"<나>","channel":"<채널>","text":sys.stdin.read()}))' < slack.txt)"

(스레드 댓글이면 body 에 "thread_ts":"<부모 ts>" 추가)