oh-story-claudecode
무엇인가
oh-story-claudecode는 중국어 네트워크 소설(网文) 집필을 순위표 분석, 기존 작품 해체, 개요 설계, 본문 작성, AI 문체 제거, 표지 이미지 생성의 단계로 나누고 각 단계를 별도 스킬로 규율하는 스킬 팩이다. 규율 대상은 창작 자체가 아니라 집필 과정의 순서와 상태 관리다. 본문을 쓰기 전에 개요를 통과시켜야 하는 게이트, 설정·개요·본문·추적 파일을 분리해 유지하는 규칙, 결정론적 검사 스크립트가 여기에 포함된다.
어떻게 동작하나
저장소 루트의 skills/ 아래 13개 디렉터리가 각각 SKILL.md와 references/를 갖고, Codex는 .agents/skills 심링크로 이를 스캔한다. 설치 후 프로젝트 루트에서 /story-setup(Codex는 $story-setup)을 실행하면 대상 CLI별로 훅·에이전트·참조 자료가 배포된다. Claude Code는 .claude/agents/에 7개 전문 에이전트(story-architect, narrative-writer, consistency-checker 등)를, Codex는 .codex/agents/*.toml과 .codex/hooks.json을, ZCode는 .zcode/skills/와 .zcode/hooks/story_zcode_hook.js를 쓴다. 8개 자동화 훅이 세션 시작·종료·컴팩트 시점에 상태를 복원하고, 100여 편의 작법 방법론 문서가 references/로 함께 배포된다.
무엇과 다른가
프롬프트에 작법 지침을 직접 붙여 넣는 방식과 달리, 이 팩은 규칙을 파일로 고정하고 상태를 대화 기록이 아니라 파일 시스템에 둔다. 설정·개요·본문·추적이 각각 독립 파일로 유지되므로 수백 장 분량에서도 이전 맥락을 대화에서 재구성할 필요가 없다. 단일 CLAUDE.md나 AGENTS.md 한 장에 규칙을 몰아넣는 방식과도 다르다. 단계별 스킬이 분리되어 있고, 본문 작성 전 개요 게이트와 결정론적 검사 스크립트가 규칙 위반을 실행 시점에 차단한다.
어떻게 쓰나
npx skills add zenstory-ai/oh-story-claudecode -y -g 로 전역 설치하거나 -g를 빼서 현재 디렉터리에만 설치한다. Claude Code는 claude plugin marketplace add 후 claude plugin install oh-story@oh-story-skills로도 붙일 수 있고, 이 경우 /oh-story:story-setup 같은 명령을 쓴다. 설치 후 집필 프로젝트 루트에서 /story-setup을 실행해 훅·에이전트·참조 자료를 배포하고 새 세션을 연다. 업그레이드 후에는 같은 설치 명령을 다시 실행하고 /story-setup을 재실행한다.
전제와 한계
Claude Code, Google Antigravity, OpenCode, ZCode, OpenClaw, Codex CLI, Reasonix를 지원하며, 프로젝트 파일을 읽을 수 있는 Web AI/Agent 환경은 skills/*/SKILL.md를 직접 읽는 방식으로 쓸 수 있다. 훅은 PATH에 node가 있어야 동작한다. OpenClaw와 Reasonix는 스킬만 배포되고 에이전트·훅은 배포되지 않아 본문 전 개요 게이트가 스킬 내부의 소프트 제약으로만 남는다. ZCode 3.3.4는 프로젝트/플러그인 커스텀 에이전트를 실행하지 않고 PreCompact·SessionEnd가 없어 관련 흐름이 solo/direct로 강등된다. Antigravity의 agy 1.1.22 -p 헤드리스 모드는 지원 대상이 아니다. Windows에서 심링크가 비활성화된 환경은 $story-setup 배포 경로를 써야 한다.