--- name: internal-comms description: "팀 내부 커뮤니케이션 문서 자동 생성. 3P 주간보고, 인시던트 보고서, 회의록, 팀 소식지, 공지사항, FAQ, 핸드오프 문서 7종 지원. 한국어 비즈니스 문어체 특화." triggers: - "internal-comms" - "내부 커뮤니케이션" - "3p 주간보고" - "3p 업데이트" - "주간 보고" - "인시던트 보고서" - "장애 보고서" - "회의록" - "팀 소식지" - "뉴스레터" - "공지사항" - "faq 문서" - "핸드오프" - "작업 인계" - "상태 업데이트" - "팀 업데이트" - "주간 업데이트" usage: "/internal-comms [문서유형] — 예: /internal-comms 3p, /internal-comms incident, /internal-comms meeting" --- # /internal-comms — 내부 커뮤니케이션 문서 자동 생성 > 출처: ComposioHQ/awesome-claude-skills (MIT 라이선스) > 우리 시스템에 맞게 커스텀 (한국어/한국 비즈니스 문화 특화, 보험/금융 도메인 예시, 7종 문서 유형) 팀 일상 커뮤니케이션에 필요한 문서를 빠르게 작성한다. 3P 주간보고부터 인시던트 보고서, 회의록, 핸드오프 문서까지 7가지 유형을 지원한다. **프레이야(개발2팀 프론트엔드 전문가)** 가 이 스킬을 주도한다. > SCQA 보고서와의 차이: SCQA는 작업 완료 보고서(제이회장님 보고), internal-comms는 팀 간/팀 내 일상 커뮤니케이션 문서다. --- ## User-invocable 사용자가 `/internal-comms`를 입력하거나, 주간보고, 회의록, 공지사항 등 내부 문서 작성을 요청할 때 이 스킬을 실행한다. --- ## Arguments ``` /internal-comms 3p — 3P 주간보고 작성 /internal-comms incident — 인시던트 보고서 (장애/이슈 발생 시) /internal-comms meeting — 회의록 작성 /internal-comms newsletter — 팀 소식지 작성 /internal-comms announcement — 공지사항 작성 /internal-comms faq — FAQ 문서 작성 /internal-comms handoff — 작업 핸드오프 문서 작성 ``` 문서 유형 없이 `/internal-comms`만 입력하면 요청 내용에서 유형을 자동 판별한다. 판별이 불가능하면 유형 선택을 요청한다. --- ## 문서 유형 판별 기준 | 키워드 | 판별 유형 | |--------|-----------| | 주간보고, 3P, 진행/계획/문제 | 3P 주간보고 | | 장애, 인시던트, 이슈, RCA, 다운 | 인시던트 보고서 | | 회의록, 미팅, 결정사항, 액션 아이템 | 회의록 | | 소식지, 뉴스레터, 이번 주 팀 | 팀 소식지 | | 공지, 안내, 정책 변경, 새 프로세스 | 공지사항 | | FAQ, 자주 묻는 질문, Q&A | FAQ 문서 | | 인계, 핸드오프, 담당자 변경, 인수인계 | 핸드오프 문서 | --- ## 워크플로우 ``` Step 1: 문서 유형 식별 ↓ Step 2: 필요 정보 수집 (팀명, 기간, 대상 독자 등) ↓ Step 3: 템플릿 기반 문서 작성 ↓ Step 4: 저장 및 출력 ``` --- ## Step 2: 필요 정보 수집 각 문서 유형별로 수집이 필요한 최소 정보: | 유형 | 필수 정보 | 선택 정보 | |------|-----------|-----------| | 3P 주간보고 | 팀명, 기간 | 정량 데이터, 블로커 | | 인시던트 보고서 | 발생/해결 시각, 영향 범위 | 심각도, 타임라인 | | 회의록 | 일시, 참석자, 안건 | 결정사항, 액션 아이템 | | 팀 소식지 | 팀명, 기간 | 주요 성과, 팀 소식 | | 공지사항 | 제목, 대상, 내용 | 시행일, 담당자 | | FAQ 문서 | 주제, Q&A 내용 | 관련 링크 | | 핸드오프 문서 | 작업명, 인계자, 인수자 | 진행 상황, 주의사항 | 필수 정보가 없으면 해당 항목만 질문한다. 한 번에 여러 질문을 던지지 않는다. --- ## 문서 유형 1: 3P 주간보고 팀 주간 활동을 Progress(진행) / Plans(계획) / Problems(문제) 3개 섹션으로 요약한다. 대상 독자: 팀장, 개발실장(아누), 유관 팀. 30~60초 내에 읽을 수 있는 분량. ### 템플릿 ``` [팀명] 주간 보고 (YYYY-MM-DD ~ YYYY-MM-DD) ## 진행 (Progress) [완료/배포/달성한 항목 1~3개. 정량 데이터 포함 권장] 예: 보험 청구 API v2.1 배포 완료 (응답 속도 340ms → 210ms, 38% 개선) ## 계획 (Plans) [다음 주 우선순위 1~3개. 핵심 업무 중심] 예: 설계사 포털 로그인 개선 (2FA 적용) — 목요일 스테이징 배포 목표 ## 문제 (Problems) [블로커, 리스크, 도움이 필요한 항목 1~3개. 해결 방안 또는 요청 사항 포함] 예: 외부 본인인증 API 응답 지연 (평균 4초 초과) — 벤더사 협의 중, 이번 주 내 해결 불확실 ``` ### 작성 지침 - 항목당 1~2문장. 산문체보다 간결한 나열 방식 권장 - 수치/데이터가 있으면 반드시 포함 (완료율, 건수, 속도 등) - Problems는 불만이 아닌 사실 기반으로 작성. 해결 방향도 함께 제시 - 팀 규모가 클수록 세부 태스크보다 마일스톤 단위로 기술 - 팀명이 지정되지 않으면 반드시 확인 후 작성 --- ## 문서 유형 2: 인시던트 보고서 장애/이슈 발생 시 원인 분석(RCA)과 재발 방지 대책을 포함한 공식 기록. ### 심각도 기준 | 심각도 | 정의 | |--------|------| | CRITICAL | 핵심 서비스 전체 중단, 고객 영향 대규모 | | HIGH | 주요 기능 장애, 고객 영향 있음 | | MEDIUM | 일부 기능 저하, 우회 방법 존재 | | LOW | 경미한 이슈, 즉각적 고객 영향 없음 | ### 템플릿 ``` ## 인시던트 보고서 **제목**: [인시던트 한 줄 요약] **발생 시각**: YYYY-MM-DD HH:MM **해결 시각**: YYYY-MM-DD HH:MM **총 영향 시간**: X시간 Y분 **영향 범위**: [영향받은 시스템, 서비스, 사용자 수] **심각도**: CRITICAL / HIGH / MEDIUM / LOW **작성자**: [이름] **작성일**: YYYY-MM-DD --- ### 타임라인 | 시각 | 이벤트 | |------|--------| | HH:MM | [최초 감지/보고] | | HH:MM | [대응 시작] | | HH:MM | [원인 파악] | | HH:MM | [임시 조치 적용] | | HH:MM | [서비스 정상화 확인] | --- ### 근본 원인 분석 (RCA) **직접 원인**: [즉각적인 기술적 원인] **근본 원인**: [이 문제가 발생하게 된 구조적 원인] **기여 요인**: - [요인 1] - [요인 2] --- ### 해결 방법 [적용한 조치 내역. 임시 조치와 영구 조치를 구분] 임시 조치: [즉각 적용한 내용] 영구 조치: [근본 해결을 위한 내용 및 일정] --- ### 재발 방지 대책 - [ ] [액션 아이템 1] — 담당: [이름] — 기한: YYYY-MM-DD - [ ] [액션 아이템 2] — 담당: [이름] — 기한: YYYY-MM-DD - [ ] [액션 아이템 3] — 담당: [이름] — 기한: YYYY-MM-DD ``` ### 보험/금융 도메인 예시 ``` ## 인시던트 보고서 **제목**: 보험 청구 조회 API 응답 불가 (DB 커넥션 풀 고갈) **발생 시각**: 2026-04-10 14:23 **해결 시각**: 2026-04-10 15:47 **총 영향 시간**: 1시간 24분 **영향 범위**: 보험금 청구 조회 기능 전체 (일 평균 약 3,200건 처리 불가) **심각도**: HIGH ``` --- ## 문서 유형 3: 회의록 회의에서 논의된 내용, 결정사항, 액션 아이템을 기록한다. ### 템플릿 ``` ## 회의록 **일시**: YYYY-MM-DD HH:MM ~ HH:MM **장소/채널**: [오프라인 장소 또는 화상회의 채널] **참석자**: [이름1, 이름2, 이름3] **기록자**: [이름] **안건**: [회의 목적 한 줄 요약] --- ### 논의 사항 **[안건 1 제목]** [내용 요약. 제기된 의견, 데이터, 쟁점 포함] **[안건 2 제목]** [내용 요약] --- ### 결정 사항 - [결정 1]: [내용] - [결정 2]: [내용] --- ### 액션 아이템 - [ ] [담당자] — [할 일] — 기한: YYYY-MM-DD - [ ] [담당자] — [할 일] — 기한: YYYY-MM-DD --- ### 다음 회의 **일시**: YYYY-MM-DD HH:MM (미정인 경우 "미정"으로 표기) **안건 (예정)**: [내용] ``` --- ## 문서 유형 4: 팀 소식지 팀의 주간/월간 활동, 성과, 팀원 소식을 정리한다. 대상 독자: 팀 전체, 유관 부서. ### 템플릿 ``` ## [팀명] [주간/월간] 소식지 **기간**: YYYY-MM-DD ~ YYYY-MM-DD **발행일**: YYYY-MM-DD **작성자**: [이름] --- ### 이번 기간 주요 성과 - [성과 1 — 가능하면 수치 포함] - [성과 2] - [성과 3] --- ### 팀 소식 - [새 합류 팀원, 이동, 외부 활동 등] --- ### 다음 기간 집중 사항 - [우선순위 항목 1~3개] --- ### 공유 자료 / 읽어볼 내용 - [관련 문서, 링크, 블로그 포스트 등 (해당 시)] ``` --- ## 문서 유형 5: 공지사항 정책 변경, 새 프로세스 도입, 도구 변경 등을 팀 또는 전체에 전달한다. ### 템플릿 ``` ## 공지사항 **제목**: [공지 제목] **대상**: [전체 / 개발팀 / 특정 팀] **시행일**: YYYY-MM-DD **작성자**: [이름] **작성일**: YYYY-MM-DD --- ### 내용 [변경/도입/공지 사항을 간결하게 기술. 배경, 변경 내용, 기대 효과 순서 권장] --- ### 대상자 행동 요청 - [대상자가 취해야 할 구체적인 행동] - [기한이 있으면 명시] --- ### 문의 [담당자 이름 또는 채널] ``` --- ## 문서 유형 6: FAQ 문서 특정 주제에 대해 자주 묻는 질문과 답변을 정리한다. ### 템플릿 ``` ## FAQ: [주제명] **작성일**: YYYY-MM-DD **최종 업데이트**: YYYY-MM-DD **담당**: [팀명 또는 담당자] --- ### Q1. [질문] **A.** [답변. 간결하고 실용적으로. 필요하면 단계별 설명] --- ### Q2. [질문] **A.** [답변] --- ### Q3. [질문] **A.** [답변] --- ### 추가 문의 [담당자 또는 채널 안내] ``` --- ## 문서 유형 7: 작업 핸드오프 문서 작업을 다른 팀원 또는 팀에 인계할 때 작성한다. ### 템플릿 ``` ## 작업 핸드오프 문서 **작업명**: [작업/프로젝트 이름] **인계자**: [이름, 팀] **인수자**: [이름, 팀] **인계일**: YYYY-MM-DD --- ### 작업 개요 [작업의 목적, 배경, 현재 상태를 3~5문장으로 요약] --- ### 현재 진행 상황 - 완료된 항목: [목록] - 진행 중인 항목: [목록 + 진행률] - 미착수 항목: [목록] --- ### 주요 결정사항 및 배경 [왜 이런 방식으로 설계/구현했는지. 인수자가 맥락을 이해하는 데 필요한 정보] --- ### 주의사항 및 알려진 이슈 - [주의사항 1] - [알려진 버그 또는 기술 부채] --- ### 관련 자료 및 링크 - 기획서: [경로/링크] - 코드 저장소: [경로/링크] - 이슈 트래커: [경로/링크] - 기타: [경로/링크] --- ### 인수자 확인 - [ ] 인수자가 내용을 검토했습니다 - [ ] 불명확한 항목에 대해 인계자와 확인했습니다 - [ ] 작업을 이어받을 준비가 되었습니다 **인수자 확인일**: YYYY-MM-DD ``` --- ## 저장 위치 작성된 문서는 아래 경로에 저장한다: ``` /home/jay/workspace/memory/comms/ ├── 3p/ — 3P 주간보고 ├── incident/ — 인시던트 보고서 ├── meeting/ — 회의록 ├── newsletter/ — 팀 소식지 ├── announcement/ — 공지사항 ├── faq/ — FAQ 문서 └── handoff/ — 핸드오프 문서 ``` 파일명 형식: `YYYYMMDD_[팀명 또는 주제-슬러그].md` --- ## 우리 시스템 맥락 ### 조직 구조 - 팀 구성: 개발1~8팀, 마케팅팀, 컨설팅팀, 디자인팀 등 - 보고 체계: 팀원 → 팀장 → 아누(개발실장) → 제이회장님 ### 문서 유형별 주요 독자 | 문서 유형 | 주요 독자 | |-----------|-----------| | 3P 주간보고 | 팀장, 아누(개발실장), 유관 팀 | | 인시던트 보고서 | 아누(개발실장), 제이회장님, 유관 팀 전체 | | 회의록 | 회의 참석자, 결정사항 영향을 받는 팀 | | 팀 소식지 | 팀 전체 | | 공지사항 | 명시된 대상 | | FAQ 문서 | 해당 주제 관련 팀원 전체 | | 핸드오프 문서 | 인수자, 관련 팀장 | --- ## 톤/스타일 가이드 - 한국어 비즈니스 문어체 (존댓말 기본) - 간결하고 데이터 중심. 수치가 있으면 반드시 포함 - 30~60초 내 읽을 수 있는 분량 유지 - 의견과 사실 구분. 사실은 데이터로 뒷받침, 의견은 "검토 필요", "판단 요청" 등으로 명시 - 불필요한 수식어 제거. "굉장히", "매우", "아주" 등 과장 표현 지양 - 이모지 사용 금지 --- ## 제약사항 - 원본(영어) 3P 업데이트 포맷의 이모지 사용 방식은 적용하지 않음 - 존댓말 기본. 반말 사용 금지 - 팀명 또는 담당자가 명확하지 않으면 반드시 확인 후 작성 - 저장 경로: `/home/jay/workspace/memory/comms/` 하위 - 이모지 사용 금지 --- ## 빠른 참조 - **문서 저장 위치**: `/home/jay/workspace/memory/comms/` - **조직도**: `/home/jay/workspace/memory/organization-structure.json` - **연계 스킬**: SCQA 보고서 (작업 완료 보고서, 제이회장님 보고용) - **3P 원형**: Progress / Plans / Problems — 우리 시스템에서 "진행 / 계획 / 문제"로 번안 --- **스킬 버전**: v1.0 **작성일**: 2026-04-12 **작성자**: 프레이야 (개발2팀 프론트엔드 전문가) **출처**: ComposioHQ/awesome-claude-skills (MIT 라이선스) 참조 후 커스텀