doc-collab-guide
기획서·제안서·보고서 등 긴 문서를 사용자와 공동 작성할 때 사용. 공식 doc-coauthoring 스킬(anthropics/skills) 의존 설치 안내, 아웃라인 승인 게이트를 정의한다. Use when: "문서 같이 쓰자", "제안서/기획서/보고서 초안", "공동 작성", co-authoring documents, proposals, long-form docs. 기술 스펙(구현 전제)은 spec-driven-dev 우선. Defines the co-authoring protocol for long-form documents (plans, proposals, reports) — install guidance for the official doc-coauthoring skill (anthropics/skills) and an outline approval gate. Use when: co-writing or drafting proposals, planning docs, reports, long documents; implementation-bound tech specs go to spec-driven-dev.
- License 许可
- Apache-2.0
- 最近更新
- 2026-10-29
- Stars
- ★ 1
- Forks
- 0
01 前言 Front Matter
- name
- doc-collab-guide
- description
- 기획서·제안서·보고서 등 긴 문서를 사용자와 공동 작성할 때 사용. 공식 doc-coauthoring 스킬(anthropics/skills) 의존 설치 안내, 아웃라인 승인 게이트를 정의한다. Use when: "문서 같이 쓰자", "제안서/기획서/보고서 초안", "공동 작성", co-authoring documents, proposals, long-form docs. 기술 스펙(구현 전제)은 spec-driven-dev 우선. Defines the co-authoring protocol for long-form documents (plans, proposals, reports) — install guidance for the official doc-coauthoring skill (anthropics/skills) and an outline approval gate. Use when: co-writing or drafting proposals, planning docs, reports, long documents; implementation-bound tech specs go to spec-driven-dev.
03 SKILL.md 正文
Doc Collab Guide — 긴 문서 공동 작성 규약
공식 doc-coauthoring 스킬을 얇게 연계해 기획서·제안서·보고서류 장문 문서를 사용자와 단계적으로 공동 작성하기 위한 규약. 도구 설치·진행 게이트만 정의하고, 문서 작성 기법 자체는 공식 스킬에 위임한다.
When to Activate
- 기획서·제안서·보고서·의사결정 문서 등 3섹션 이상의 장문 문서를 사용자와 함께 쓸 때
- 사용자가 초안 전체가 아니라 단계적 협업(아웃라인 → 섹션별 확정)을 원할 때
- 산출물이 .md 또는 .docx 문서 자체일 때 (코드 산출 작업이면 해당 없음)
도메인 경계 — 그쪽 문서는 그쪽 커맨드 우선
| 문서 유형 | 우선 경로 | 이 스킬 |
|---|---|---|
| 기술 스펙(구현 전제) | workflow spec-driven-dev |
사용 안 함 |
| 그 외 일반 기획서·제안서·보고서 | 이 스킬 | 사용 |
도메인 커맨드가 있는 문서는 그쪽 구조·법리·게이트가 우선한다. 이 스킬을 겹쳐 쓰지 않는다.
공식 스킬 의존 설치
anthropics/skills 저장소 웹 확인 기준(2026-07): doc-coauthoring은 example-skills 플러그인 소속, docx 내보내기는 document-skills 소속. 마켓플레이스 이름은 anthropic-agent-skills.
/plugin marketplace add anthropics/skills
/plugin install example-skills@anthropic-agent-skills # doc-coauthoring 포함
/plugin install document-skills@anthropic-agent-skills # docx/pdf/pptx/xlsx 내보내기 (선택)
- 공식 스킬의 3단계(Context Gathering → Refinement & Structure → Reader Testing)는 아래 진행 규약의 1·3·4단계를 보강하는 보조 도구다.
- 미설치 상태여도 아래 규약만으로 진행 가능하다. 설치를 강제하지 말고, 세션에서 스킬이 보이지 않으면 위 구문을 사용자에게 1회 안내한다.
진행 규약
| 단계 | 내용 | 게이트 |
|---|---|---|
| 1. 목적/독자 확정 | 이 문서로 누가 무엇을 결정·행동하게 만들 것인지 1~2문장으로 합의 | 없음 (합의 전 다음 단계 금지) |
| 2. 아웃라인 승인 | 섹션 목록 + 섹션별 핵심 주장 1줄 + 분량 추정 제시 | ★사용자 게이트 |
| 3. 섹션별 작성 | 승인된 아웃라인 순서대로 한 섹션씩 작성·확인 | 섹션당 사용자 확인 1회 |
| 4. 리뷰 (반증 관점) | "이 문서가 독자를 설득하지 못한다면 왜?" — 반론·누락 근거·과장 탐지 | 반증에 구체적 근거 요구 |
| 5. 산출 | 사용자와 합의한 경로로 최종본 산출 | 경로 사용자 확인 |
아웃라인 게이트 (2단계) — 스코프 승인 패턴:
- 승인 전 본문 작성 금지. 자율 통과 금지. "대충 이렇게 갈게요" 후 진행은 위반이다.
- 아웃라인 수정 요청이 오면 반영본을 다시 제시하고 재승인을 받는다.
- 3단계 진행 중 아웃라인 변경이 필요해지면(섹션 추가·삭제·순서 변경) 변경 요지를 1줄 보고하고 승인 후 반영한다 — 게이트 승인 사항이기 때문이다.
리뷰 (4단계): 작성자 시점이 아니라 회의적 독자 시점으로 전환한다. 최소 점검 3가지 — ① 핵심 주장에 근거 없는 섹션 ② 독자의 예상 반론 중 미대응 항목 ③ 결론이 1단계에서 합의한 목적과 어긋나는 지점.
Verification
- [ ] 목적/독자 합의문이 대화에 기록됨 (1단계)
- [ ] 아웃라인 사용자 승인이 명시적으로 존재함 — 승인 전 본문 없음 (2단계)
- [ ] 리뷰에서 반증 3가지 점검 수행 (4단계)
- [ ] 최종 산출 경로가 사용자와 합의됨 (5단계)
Related
- 공식
doc-coauthoring(example-skills@anthropic-agent-skills) — 컨텍스트 수집·리더 테스트 기법 - 공식
docx(document-skills@anthropic-agent-skills) — Word 내보내기 planning-guide— 문서가 아니라 기능 계획을 세울 때
04 同仓库更多 Skills
sync-claude-md
커밋·푸시·PR/MR 직전에 이번 변경이 프로젝트 CLAUDE.md 를 낡게 만드는지 검토하고, 필요할 때만 갱신 diff 를 제안한다 — 아키텍처·디렉터리 구조, 새 통합/MCP, 컨벤션, 빌드·CI·도구, 주요 의존성 변화가 대상. 해당 없으면 한 줄로 끝낸다. Reviews whether pending changes make the project CLAUDE.md stale (architecture, integrations, conventions, build/CI/tooling, major dependencies) and proposes a minimal update diff only when needed. Use when: "CLAUDE.md 갱신 필요해?", "CLAUDE.md 동기화", 커밋/푸시/MR 전에 구조·도구가 바뀐 변경을 정리할 때, sync CLAUDE.md, check CLAUDE.md before commit or PR.
spec-driven-dev
새 기능·프로젝트·큰 변경을 코드보다 스펙 먼저로 진행하는 게이트 워크플로(SPECIFY → PLAN → TASKS → IMPLEMENT) — 가정 명시, 측정 가능한 성공 기준, Always/Ask/Never 경계, 단계별 사람 검토로 범위 이탈과 재작업을 줄인다. Spec-before-code gated workflow for new features or significant changes: explicit assumptions, measurable success criteria, boundaries, and a human review between stages. Use when: "스펙 먼저", "기능 명세", "요구사항 정리", starting a new feature or project, a significant change with vague requirements. 단순 버그 수정·1~2줄 변경엔 불필요.
shipping-guide
프로덕션 배포 전후 가이드 — 배포 전 체크리스트, 피처 플래그 수명주기, 단계적 롤아웃과 진행/보류/롤백 임계값, 롤백 계획 템플릿, 배포 후 모니터링. Production shipping guide: pre-launch checklist, feature-flag lifecycle, staged rollout with go/hold/rollback thresholds, rollback plan template, post-launch monitoring. Use when: "배포 준비", "릴리즈 전 점검", "롤아웃 계획", "롤백 계획", preparing a production deploy, staged rollout, feature flags.
retro
세션 회고·교훈 컴파운딩 — 이번 세션의 교정·실수·발견을 추출해 품질 기준(재현·일반화·판정 가능성)으로 거르고, 컨벤션 변화는 sync-claude-md 위임, 반복 실수는 tasks/lessons.md(#가드-훅-후보 태그), 스킬 지식 갱신은 수정 제안으로 나눈다. 모든 적용은 승인 후. Session retrospective that turns corrections, mistakes, and discoveries into vetted lessons routed to CLAUDE.md sync, tasks/lessons.md, or skill-edit proposals, with user approval before any write. Use when: "회고", "레트로", "교훈 정리", "같은 실수 반복", "재발 방지 규칙", retrospective, lessons learned, wrapping up a task, review, or loop. 여러 실행에 걸친 하네스 개선은 harness:evolve.
project-rules
현재 프로젝트의 스택(빌드 파일 버전, 마이그레이션 도구, ORM 유무, ES 사용, git 호스트)을 감지해 프로젝트 루트 AGENTS.md 의 마커 블록(스택 사실 + 항상 적용되는 스페셜리스트 핵심 ≤15줄 — Claude Code·Codex·Antigravity 공통)과 CLAUDE.md 의 `@AGENTS.md` 연결, Claude 전용 경로 한정 .claude/rules/<stack>-specialist.md(해당 버전에 실제로 맞는 상세 함정)를 diff 로 제안하고, 스택 플러그인을 런타임별로 프로젝트 범위에서 켜는 법을 안내한다. 이전 버전 출력(CLAUDE.md 블록·specialist-core.md)은 AGENTS.md 로 이전을 제안. --check 는 버전 불일치·사라진 ID·크기 한도·연결 누락을 점검. Detects the project's stack and proposes a cross-runtime AGENTS.md block (stack facts + always-on specialist core) linked from CLAUDE.md via @AGENTS.md, plus Claude-only path-scoped specialist rules; migrates the older CLAUDE.md-block layout; --check audits drift. Use when: "이 프로젝트 세팅", "프로젝트 규칙 생성", "AGENTS.md/CLAUDE.md 점검", project setup, generate project rules, audit AGENTS.md or CLAUDE.md drift.
post-merge
MR 머지 완료 후 Plane 이슈 종료와 Outline 문서 업데이트를 자동으로 처리하는 오케스트레이터 스킬입니다. issue-tracker와 document-latest 스킬을 연계 실행하여 머지 후 후속 작업을 일괄 처리합니다. Orchestrates post-merge follow-up after an MR is merged: chains the issue-tracker and document-latest skills to close the Plane issue and update Outline wiki docs in a single batch. Use when: an MR was just merged, closing tickets and syncing documentation after a merge, post-merge cleanup.