메뉴
문서 콘텐츠(포스팅, 깃헙 위키, 리드미 등)를 작성하거나 수정할 때 사용한다. "글 써줘", "문서 작성", "포스팅 작성", "위키 작성", "리드미 작성", "본문 수정" 등의 요청 시 반드시 호출한다.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | writing |
| description | 문서 콘텐츠(포스팅, 깃헙 위키, 리드미 등)를 작성하거나 수정할 때 사용한다. "글 써줘", "문서 작성", "포스팅 작성", "위키 작성", "리드미 작성", "본문 수정" 등의 요청 시 반드시 호출한다. |
문서 콘텐츠를 작성하거나 수정할 때 이 스킬을 따른다.
작성 컨벤션은 .claude/skills/_shared/conventions/writing.md에 정의되어 있다.
작성 전 반드시 .claude/skills/_shared/conventions/writing.md를 읽고 전체 규칙을 숙지한다.
핵심 규칙만 요약하면 아래와 같다.
~다. 또는 명사형으로 종결한다.~입니다, ~합니다, ~요, ~습니다 금지.-) 리스트로 전환하고, 리스트 항목은 명사형으로 끝낸다.# 헤더 기준으로 의미 단위를 나눈다.:---:)을 원칙으로 한다.X.foo()) 패턴을 노출하지 않는다.process() → "복구 사이클 실행").FCG(격리 전 최종 확인)).사용자 요청에서 문서 유형과 목적을 파악한다.
| 문서 유형 | 특징 |
|---|---|
| 포스팅 | 경험·사례·트러블슈팅, 내러티브 형식 |
| 깃헙 위키 | 프로젝트 설명·가이드, 레퍼런스 형식 |
| 리드미 | 프로젝트 소개·설치·사용법, 간결한 안내 |
헤더 단위로 문서 구조를 잡고 사용자에게 확인한다. 서머리나 아웃라인이 제공되면 참고만 하고 그대로 따르지 않는다.
컨벤션을 준수하며 본문을 작성한다. 작성 중 다음을 점검한다.
~다. 또는 명사형인가작성이 완료되면 doc-review 스킬로 검수를 진행한다.
검수에서 FAIL 항목이 나오면 수정 후 재검수한다.
수정 범위가 일부라도 해당 문서 전체가 컨벤션에 맞는지 함께 확인한다.
코드 변경(diff, 브랜치, 커밋 범위, PR)을 배경–직관–코드–퀴즈 4섹션의 자기완결 인터랙티브 HTML 페이지로 풀어 설명한다. "diff 설명해줘", "이 PR 설명 페이지 만들어줘", "변경 내용 인터랙티브로 정리", "이 브랜치에서 뭘 바꿨는지 학습용으로 설명" 등 변경 사항의 리치 설명을 요청하면 HTML을 직접 언급하지 않아도 반드시 이 스킬을 사용한다. workflow ship 단계의 리뷰 통과 직후(A5)에도 자동 호출된다. 문제점을 찾는 검토 요청은 review 스킬, 대화 내 짧은 텍스트 요약은 일반 응답으로 처리한다.
payment-platform 워크플로우의 discuss 단계를 실행한다. 사용자가 새 기능/버그/개선의 설계를 논의하거나, "discuss 시작", "설계 논의", "어떻게 구현할지 얘기해보자", "방법 고민" 등을 말할 때 이 스킬을 사용한다. 구현 전에 결정해야 할 사항을 명확히 하는 것이 목적이다.
payment-platform 워크플로우의 execute 단계를 실행한다. docs/<TOPIC>-PLAN.md가 존재하고 사용자가 "execute 시작", "구현 시작", "코딩 시작", "태스크 실행", "다음 태스크" 등을 말할 때 이 스킬을 사용한다. TDD로 태스크를 하나씩 구현하고 커밋하는 것이 목적이다.
payment-platform 워크플로우의 ship 단계(코드 리뷰 + 마무리)를 실행한다. execute 완료 후 "ship 시작", "리뷰 시작", "코드 리뷰", "리뷰하고 마무리", "검증하고 마무리", "아카이브", "PR 만들어줘" 등을 말할 때 이 스킬을 사용한다. 리뷰 → 수정 → 최종 검증 → 문서 동기화 → 아카이브 → PR 흐름이다.
payment-platform의 discuss → plan → execute → ship 워크플로우 오케스트레이터. docs/STATE.md에 활성 토픽이 있거나, 사용자가 "discuss 시작", "plan 작성", "execute 시작", "워크플로우로", "다음 단계", "세션 재개", "이어서 진행", "어디까지 했지" 등을 말할 때 반드시 이 스킬을 사용한다. 단순 질문, 빠른 수정, 일회성 코드 변경에는 사용하지 않는다.
사용자가 "포트폴리오 수정", "포트폴리오 사이트", "payment-flows", "포트폴리오 페이지", "포트폴리오 배포", "index.html 고쳐", "포트폴리오 확인" 같은 표현으로 결제 플랫폼 포트폴리오 페이지를 참조·수정하라는 신호를 줄 때 반드시 사용한다. 이 포트폴리오(구 `docs/site/payment-flows.html`)는 payment-platform이 아니라 **별도 blog 저장소**(`notes/blog`, Astro)에서 관리되며 payment-platform 트리 안엔 존재하지 않으므로, 이 스킬이 정본 페이지(`src/pages/payment-platform-portfolio/index.astro` — CSS·데이터·로직은 각각 `src/styles/`·`src/data/paymentPortfolio/`·`src/scripts/portfolio/` 모듈로 분리)와 dev 툴 위치를 자동으로 찾아 Read / Grep / Edit 으로 접근하게 해준다. "포트폴리오" 단어가 없어도 결제 플랫폼 소개 페이지·시스템 아키텍처 다이어그램·시나리오 극장·섹션 밴드/모션 같은 그 페이지의 콘텐츠를 손봐야 하는 맥락이면 사용을 고려한다.