본문으로 건너뛰기

Slack 답변을 Team Library 문서로 전환하는 운영 흐름

목적​

Slack에서 반복적으로 오가는 설명, 운영 기준, 장애 대응 내용을 문서 자산으로 전환해 재사용하기 위한 운영 절차입니다.

이 흐름이 필요한 이유​

Slack 답변은 빠르지만, 그대로는 문서 품질이 일정하지 않은 경우가 많습니다.

예를 들어 Slack 답변은 보통 아래 특징이 있습니다.

  • 맥락이 생략되어 있음
  • 제목과 분류가 없음
  • 검색하기 어려움
  • 해결 절차가 문서 구조로 정리되어 있지 않음

그래서 Team Library에는 Slack 원문이 아니라, 검토 가능한 문서 초안 형태로 전환한 뒤 반영하는 것이 좋습니다.

기본 원칙​

  • Slack 답변을 그대로 게시하지 않습니다.
  • OpenClaw가 초안을 다듬고 구조화합니다.
  • 게시 전 사람의 확인을 거칩니다.
  • 확정된 내용만 Team Library에 반영합니다.

권장 운영 흐름​

1. Slack에서 문서화 대상 수집​

문서화 대상이 되는 예시는 아래와 같습니다.

  • 반복적으로 같은 설명이 나오는 운영 이슈
  • 배포/설정/권한/도메인 관련 해결 방법
  • 요청 양식이나 체크리스트가 필요한 업무
  • 팀 내에서 합의된 운영 기준

2. OpenClaw에 문서화 요청​

문서화 요청 시 최소한 아래 정보가 있으면 좋습니다.

[문서화 요청]
- 원문: Slack 답변 또는 대화 내용
- 문서 유형: 가이드 / 체크리스트 / FAQ / 트러블슈팅 / 정책
- 대상 서비스:
- 목적:
- 포함할 핵심 포인트:

짧게는 아래처럼 요청해도 됩니다.

  • 이 슬랙 답변 문서화해줘
  • 이 이슈 해결 과정 Team Library용으로 정리해줘
  • 이 내용을 운영 가이드로 바꿔줘

3. OpenClaw가 문서 초안 작성​

OpenClaw는 아래 역할을 수행합니다.

  • 제목 정리
  • 문서 유형 판단
  • 경로 제안
  • markdown 초안 작성
  • 누락된 확인 포인트 제안

문서 유형 판단 기준​

docs로 넣는 경우​

  • 운영 가이드
  • 체크리스트
  • 프로세스 문서
  • FAQ
  • 트러블슈팅 문서
  • 정책 또는 기준 문서

blog로 넣는 경우​

  • 회고
  • 개선 사례
  • 작업 과정 공유
  • 팀 경험 정리
  • 운영 인사이트

권장 문서 템플릿​

트러블슈팅 문서​

# 제목

## 배경
## 증상
## 원인
## 해결 방법
## 확인 방법
## 참고

운영 가이드 문서​

# 제목

## 목적
## 적용 대상
## 절차
## 주의사항
## 운영 팁

4. 컨펌 단계​

문서 초안이 만들어지면 바로 게시하지 않고 확인합니다.

컨펌 시 보는 항목:

  • 내부 공유 가능한 정보만 들어있는지
  • 민감한 값이나 접근 정보가 없는지
  • 표현이 너무 대화체로 남아 있지 않은지
  • 실제 운영 방식과 일치하는지
  • 중복 문서가 아닌지

5. Team Library에 반영​

컨펌 완료 후 적절한 경로에 md 파일로 저장합니다.

예시 경로:

  • docs/ops/
  • docs/workflows/
  • docs/homepage/
  • docs/troubleshooting/
  • blog/

반영 후에는 빌드와 배포를 수행합니다.

cd /root/.openclaw/workspace/docusaurus-team-library
npm run build && sudo rsync -av --delete build/ /var/www/team-library/

추천 역할 분담​

Slack​

  • 질문/요청/운영 이슈의 출발점

OpenClaw​

  • 문서 초안 생성
  • 구조화
  • 제목/카테고리 정리
  • md 형식 변환

영빈님​

  • 내용 검토
  • 공개 범위 판단
  • 최종 반영 승인

실제 적용 예시​

이번 team-library.biny.cloud 연결 작업은 아래처럼 문서 자산으로 바꿀 수 있습니다.

  • 트러블슈팅/운영 가이드: docs/ops/team-library-domain-and-https-deploy-guide.md
  • 프로세스 문서: docs/workflows/slack-to-team-library-publishing-workflow.md

운영 팁​

  • 처음에는 완전 자동화보다 반자동 방식이 품질 관리에 유리합니다.
  • 문서화 대상 채널을 따로 두면 누락이 줄어듭니다.
  • 반복 질문은 문서화 후 링크로 대응하면 팀 커뮤니케이션 비용이 줄어듭니다.

한 줄 정리​

Slack는 빠른 대화 채널이고, Team Library는 검토된 지식을 쌓는 저장소입니다. OpenClaw는 그 사이에서 대화를 문서로 바꾸는 편집자 역할을 합니다.