菜单
기술 문서(튜토리얼, How-to 가이드, 트러블슈팅, API 참조, 개념·도메인 설명 등)를 새로 작성하거나 기존 문서를 개선·리뷰할 때 이 스킬을 사용하세요. 토스 테크니컬 라이팅 가이드 기반의 3단계 워크플로우(문서 유형 → 정보 구조 → 문장 다듬기)로 전문 에이전트를 호출해 문서 품질을 끌어올립니다. apps/docs 등 .md 문서 작성·검토 시 활성화하세요.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | technical-writing |
| description | 기술 문서(튜토리얼, How-to 가이드, 트러블슈팅, API 참조, 개념·도메인 설명 등)를 새로 작성하거나 기존 문서를 개선·리뷰할 때 이 스킬을 사용하세요. 토스 테크니컬 라이팅 가이드 기반의 3단계 워크플로우(문서 유형 → 정보 구조 → 문장 다듬기)로 전문 에이전트를 호출해 문서 품질을 끌어올립니다. apps/docs 등 .md 문서 작성·검토 시 활성화하세요. |
이 스킬은 토스 테크니컬 라이팅 가이드(context/technical-writing/)를 기반으로, 기술 문서를 작성·개선하는 3단계 파이프라인을 오케스트레이션합니다. 각 단계는 전용 서브 에이전트가 담당합니다.
apps/docs/**)를 개선·리뷰할 때| 단계 | 목적 | 담당 에이전트 | 참조 문서 |
|---|---|---|---|
| Step 1. 문서 유형 정하기 | 독자 목적에 맞는 유형(학습/문제해결/참조/설명) 결정, 템플릿·구조 제안 | tw-type-classifier | context/technical-writing/type/**, tutorial/structure.md |
| Step 2. 정보 구조 만들기 | 제목·개요·섹션 배치·일관성 등 정보 구조 진단·개선 | tw-structure-reviewer | context/technical-writing/architecture/** |
| Step 3. 문장 다듬기 | 주체·간결성·구체성·자연스러운 한국어·일관성으로 문장 교정 | tw-sentence-polisher | context/technical-writing/sentence/** |
각 에이전트는 작업 시작 시 자신의 참조 문서를 직접 읽어 최신 기준에 근거합니다. 원본이 항상 우선이며, 에이전트 내부 요약은 보조용입니다.
요청 성격에 따라 필요한 단계만 골라 Agent 도구로 호출하세요. 독립적이지 않고 앞 단계 결과가 뒤 단계 입력이 되므로 순차 실행합니다.
tw-type-classifier 호출 → 문서 유형 확정 + 템플릿/구조 확보tw-structure-reviewer 호출 → 초안의 정보 구조 점검·개선tw-sentence-polisher 호출 → 문장 다듬기tw-structure-reviewer 호출 → 구조 진단·개선tw-sentence-polisher 호출 → 문장 교정tw-sentence-polisher 호출tw-type-classifier 호출 (필요 시 tw-structure-reviewer 병행)tw-type-classifier 호출 → 디렉터리 트리·유형 배치·크로스링크 설계Agent 도구에 subagent_type으로 위 에이전트 이름을 지정하고, prompt에 대상 텍스트(또는 파일 경로)와 맥락(문서 목표·독자 수준·제약)을 함께 전달하세요. 파일을 수정해야 하면 대상 파일 경로를 명시해 에이전트가 직접 Edit 하도록 합니다.
예시:
Agent(subagent_type: "tw-structure-reviewer",
prompt: "apps/docs/developers/quick-start.md 의 정보 구조를 진단하고 개선안을 제시해줘. 독자는 처음 연동하는 외부 개발자야.")
apps/docs/를 다룰 때는 docs-knowledge 규칙을 따릅니다. 코드와 문서가 충돌하면 코드를 따릅니다.context/technical-writing/tutorial/review-prompt.md의 단계별 프롬프트·체크리스트를 참고하세요.