doc-coauthoring: 세 단계로 구조화 문서를 함께 쓰기

누구에게 맞나

doc-coauthoring은 구조화 텍스트를 쓰려는 사람용이다. 문서, 제안, 기술 사양, 의사결정 메모 또는 비슷한 내용. 자동 제출 도구가 아니라 세 단계를 능동적으로 안내한다: Context Gathering(맥락 모으기), Refinement & Structure(다듬기와 구조), Reader Testing(독자 테스트).

트리거는 분명히 적혀 있다. 문서 쓰기, 제안하기, 사양 초안 또는 비슷한 작업을 말할 때 사용한다. 그냥 잡담만 하고 단계 안내를 받아들이지 않으면 설명은 이 구조를 거절하고 자유 서술로 바꿔도 된다고 한다. 한 번 받아들이면 완성고로 건너뛰지 말고 단계별로 진행한다.

설치기로는 맞지 않는다. 설명은 어떤 설치 명령도 주지 않으며 어떤 디렉터리에 두면 쓸 수 있다고도 쓰지 않는다. 현재 도우미가 아직 이 세 단계로 일하지 못하면 기존 설명은 여기까지다. 페이지 주소에서 설치 경로를 역추산하지 말 것. 독자 테스트 없이 초고를 남에게 보내는 용도에도 맞지 않는다.

3분 안에 첫 시도 끝내기

공식 첫 경로는 함께 쓰기를 시작하는 것이며 설치가 아니다. 설명 페이지는

https://raw.githubusercontent.com/anthropics/skills/main/skills/doc-coauthoring/SKILL.md

그 페이지의 단계만 따른다. 나타나지 않은 설치 문구를 쓰지 말 것.

전제: 현재 도우미가 이미 doc-coauthoring 단계로 안내할 수 있고, 손에 저위험 주제가 있다. 예를 들어 내부용 한 페이지 의사결정 메모 초안. 설치 명령이 없으므로 「위치」는 이번 대화이며 추측한 스킬 디렉터리가 아니다.

저위험 첫 작업: 「의사결정 메모를 쓰겠다」고 분명히 말하고 세 단계 안내를 받아들이되 Context Gathering만 끝낸다. 먼저 독자, 목적, 알려진 자료에 대한 질문에 답하고 전문 생성을 서두르지 말며 밖으로도 보내지 말 것. 도우미가 Slack, Teams, Google Drive, SharePoint 또는 다른 MCP로 맥락을 바로 가져올 수 있다고 하면 먼저 그 연동이 이쪽에서 정말 되는지 확인한다. 안 되면 붙여넣기나 말로 바꾸고 이미 연결됐다고 가장하지 말 것.

성공 신호는 도우미가 세 단계로 안내하겠다고 말하고 맥락을 모으기 시작하는 것이며, 완성 문서를 바로 뱉는 것이 아니다. 모으기 단계가 끝나기 전에 큰 파일 쓰기를 승인하지 말 것. 설명은 어떤 편집기를 써야 하는지도, 파일 형식도 쓰지 않는다.

사용 사례

사례 1: 세 단계로 사양 또는 제안을 함께 쓴다. 문서 쓰기, 제안하기, 사양 초안을 말할 때 시작한다. 도우미는 능동적 안내자다. 먼저 맥락을 모으고 다음으로 구조와 표현을 다듬는다. 이미 소재가 있고 단계별로 빈칸을 물어주길 원할 때 맞다. 설명은 단계별 질문 목록을 주지 않으므로 「안내를 받아들이고 구간마다 확인」까지만 할 수 있다. 도우미가 모으기를 건너뛰고 완성고로 가면 Context Gathering로 돌아가라고 요청한다. 설명 페이지는 여전히

https://raw.githubusercontent.com/anthropics/skills/main/skills/doc-coauthoring/SKILL.md

사례 2: 완성 전에 독자 테스트를 한다. 3단계는 맥락 없는 새 Claude가 이 문서를 읽고 맹점을 잡은 뒤 다른 사람이 읽게 하는 것이다. 자기 글이 너무 매끄러워 바깥 사람이 못 따라갈까 걱정될 때 맞다. 설명은 새 세션을 한 번에 여는 방법도, 테스트 질문 템플릿도 쓰지 않는다. 따라서 「맥락 없는 다른 세션을 열고 문서를 붙여 상대가 요점을 되말할 수 있는지 본다」까지만 할 수 있다. 테스트가 끝나기 전에 문서를 준비 완료로 취급하지 말 것. 연동이 되면 맥락을 가져올 수 있지만 독자 테스트를 대신하지 않는다.

사용 경계

설치 명령 없음: 설명은 스킬 정체와 세 단계 흐름만 정의한다. 페이지 경로를 설치기로 쓰지 말 것. 트리거 경계: 문서, 제안, 사양 또는 비슷한 구조화 내용을 쓸 때. 다른 쓰기 작업은 지목되지 않았다. 흐름 경계: 세 단계는 맥락 모으기, 다듬기와 구조, 독자 테스트. 독자 테스트는 맥락 없는 새 Claude를 써야 한다. 연동 경계: Slack, Teams, Google Drive, SharePoint 또는 다른 MCP는 「사용 가능」할 때만 맥락을 가져온다. 설명은 그 연동이 반드시 있다고 보장하지 않으며 활성화 단계도 쓰지 않는다. 안내를 거절하면 자유 서술로 바꿔도 되지만 자유 서술을 독자 테스트 완료로 착각하지 말 것.