book-writer: Skill for Claude Code

Book Writing Orchestrator

주제·주요 내용·대상 독자를 받아 완성된 EPUB을 산출한다. 각 Phase에서 전문 에이전트를 호출하고, 중간 산출물을 {slug}/에 쌓은 뒤 최종 EPUB과 책 소개 markdown을 프로젝트 루트에 만든다.

흐름 한눈에

독립 검수는 두 곳에만 둔다 — 챕터 묶음마다 한 번의 사실/연속성 패스, 그리고 통권 수락 게이트 한 번. 저술가는 활성 프로필의 체크리스트를 자기 품질 기준으로 삼아 쓰므로 별도의 스타일 왕복 검수는 기본 흐름에 없다(요청 시 style-guardian을 쓴다).

서브에이전트 운용

• 에이전트는 Agent 도구로 호출하고, 서로 독립인 호출(리서처들, 저술가들)은 한 메시지에 모아 병렬로 띄운다. 팀 도구(TeamCreate·SendMessage)에 의존하지 않는다 — 모든 조율은 {slug}/의 파일과 반환값으로 한다.
• 첫 브리프에 필요한 것을 다 담는다: genre, 슬러그, 담당 범위(챕터 번호 등), 읽을 파일 경로, 쓸 파일 경로, 저자·라이선스처럼 이 Phase에 필요한 사용자 지정값. 파일 내용을 프롬프트에 붙여넣지 말고 경로를 준다.
• 각 에이전트에게 반환값은 짧게 요청한다 — 쓴 파일 경로, 미해소 항목, 사용자 판단이 필요한 것. 반환된 결과를 오케스트레이터가 다시 검증하거나 다시 쓰지 않는다.
• 모델은 지정하지 않는다. 모든 에이전트가 현재 세션의 모델 설정을 그대로 상속한다 (frontmatter에도 model을 두지 않는다).
• 에이전트가 중단되면 이미 쓴 파일(로그는 챕터마다 즉시 append된다)을 확인하고, 남은 범위만 담아 다시 호출한다.

Phase 0: 컨텍스트 확인

1. 사용자 입력에서 주제·주요 내용·대상 독자를 뽑는다. 하나라도 불명확하면 AskUserQuestion으로 짧게 묻는다. 저자: {이름}이 있으면 그 값, 없으면 Toby-AI. 라이선스: {값}이 있으면 그 값, 없으면 매니페스트 license를 비워 빌드 스크립트 기본값(CC BY-NC-SA 4.0)을 쓴다.
2. 장르를 정한다. 장르: {값}이 있으면 그대로 쓴다. 없으면 profiles/_registry.md의 감지 규칙으로 추정하고, 신호가 분명하면 알리고 진행하며, 애매하면 AskUserQuestion으로 추정값을 첫 옵션으로 제시해 확인받는다.
3. 위임 모드를 정한다. 모드: 학습이나 "이 주제를 공부하려고" 같은 명확한 학습 신호가 있으면 learning, 없으면 묻지 않고 production. 어차피 질문할 일이 있으면 거기에 함께 묻는다 (docs/learning-loop.md).
4. 같은 genre의 교훈이 book-lessons.md(없으면 .omc/book-lessons.md)에 있으면 최근 몇 건을 읽어 planner·writer 브리프에 참고 메모로 넣는다. 파일이 없으면 건너뛴다.
5. 제목 후보와 슬러그를 만든다 (예: AI 시대의 개발자 철학 → ai-developer-philosophy). {slug}/가 없으면 새 실행, 있고 부분 수정 요청이면 재실행 매트릭스를 따르고, 있는데 완전히 새 입력이면 기존 폴더를 {slug}_prev-{timestamp}/로 옮긴 뒤 새로 시작한다. 재실행에서는 book_manifest.json의 genre·delegation_mode를 그대로 쓴다.