Story Setup
网文写作工具集基础设施部署与检查。为 Claude Code / OpenCode / Codex / Google Antigravity / ZCode / OpenClaw / Reasonix 提供内置适配；Web AI / 通用 Agent 可走 skills + AGENTS.md 文件模式。触发方式：/story-setup、$story-setup、「准备写书」「帮我搭一下环境」「配置写作项目」「检查写作环境」。
Specification
- Skill ID
- zenstory-ai/oh-story-claudecode/story-setup
- Publisher
- zenstory-ai
- Repository
- oh-story-claudecode
- Installs
- 0
- Files
- 165
- Synced
- Sep 23, 2026
How to use it
Open any RiverX project, open the Skills panel in the chat, and search for this identifier. The files are fetched from the source repository at install time.
zenstory-ai/oh-story-claudecode/story-setupInstalls these files- SKILL.md
- UPGRADING.md
- references/agent-references/agent-quality.md
- references/agent-references/agent-reference-profiles.md
- references/agent-references/anti-ai-writing.md
- references/agent-references/banned-words.md
- references/agent-references/character-basics.md
- references/agent-references/character-design-methods.md
- references/agent-references/character-relations.md
- references/agent-references/deslop-gates.md
- references/agent-references/dialogue-mastery.md
- references/agent-references/emotional-arc-design.md
- references/agent-references/format-and-structure.md
- references/agent-references/genre-prose-cards.md
- references/agent-references/genre-prose-cards/东方仙侠.md
- references/agent-references/genre-prose-cards/传统玄幻.md
- references/agent-references/genre-prose-cards/历史古代.md
- references/agent-references/genre-prose-cards/历史脑洞.md
- references/agent-references/genre-prose-cards/双男主.md
- references/agent-references/genre-prose-cards/古言脑洞.md
- references/agent-references/genre-prose-cards/古风世情.md
- references/agent-references/genre-prose-cards/女频悬疑.md
- references/agent-references/genre-prose-cards/女频种田.md
- references/agent-references/genre-prose-cards/宫斗宅斗.md
- references/agent-references/genre-prose-cards/年代.md
- references/agent-references/genre-prose-cards/快穿.md
- references/agent-references/genre-prose-cards/悬疑灵异.md
- references/agent-references/genre-prose-cards/悬疑脑洞.md
- references/agent-references/genre-prose-cards/战神赘婿.md
- references/agent-references/genre-prose-cards/抗战谍战.md
- references/agent-references/genre-prose-cards/星光璀璨.md
- references/agent-references/genre-prose-cards/民国言情.md
- references/agent-references/genre-prose-cards/游戏体育.md
- references/agent-references/genre-prose-cards/玄幻脑洞.md
- references/agent-references/genre-prose-cards/玄幻言情.md
- references/agent-references/genre-prose-cards/现言脑洞.md
- references/agent-references/genre-prose-cards/科幻末世.md
- references/agent-references/genre-prose-cards/职场婚恋.md
- references/agent-references/genre-prose-cards/西方奇幻.md
- references/agent-references/genre-prose-cards/豪门总裁.md
- references/agent-references/genre-prose-cards/都市修真.md
- references/agent-references/genre-prose-cards/都市日常.md
- references/agent-references/genre-prose-cards/都市种田.md
- references/agent-references/genre-prose-cards/都市脑洞.md
- references/agent-references/genre-prose-cards/都市高武.md
- references/agent-references/genre-prose-cards/青春甜宠.md
- references/agent-references/genre-readers.md
- references/agent-references/long-chapter-hooks.md
- references/agent-references/long-emotional-methods.md
- references/agent-references/long-genre-catalog.md
- references/agent-references/long-genre-mechanics.md
- references/agent-references/long-quality.md
- references/agent-references/long-reversal.md
- references/agent-references/long-suspense.md
- references/agent-references/opening-design.md
- references/agent-references/outline-conflict.md
- references/agent-references/outline-methods.md
- references/agent-references/outline-rhythm.md
- references/agent-references/plot-core-methods.md
- references/agent-references/short-chapter-hooks.md
- references/agent-references/short-emotional-methods.md
- references/agent-references/short-genre-formulas.md
- references/agent-references/short-paragraph-hooks.md
- references/agent-references/short-quality.md
- references/agent-references/short-reversal.md
- references/agent-references/short-suspense.md
- references/agent-references/style-combat-face.md
- references/agent-references/style-genre-modules.md
- references/agent-references/style-resolution.md
- references/agent-references/writing-craft.md
- references/antigravity/hooks/hooks.json
- references/antigravity/hooks/story_antigravity_hook.js
- references/antigravity/hooks/story_hook_core.js
- references/antigravity/rules/oh-story.md
- references/codex/AGENTS.md.tmpl
- references/codex/agents/chapter-extractor.toml
- references/codex/agents/character-designer.toml
- references/codex/agents/consistency-checker.toml
- references/codex/agents/narrative-writer.toml
- references/codex/agents/story-architect.toml
- references/codex/agents/story-explorer.toml
- references/codex/agents/story-researcher.toml
- references/codex/hooks/hooks.json
- references/codex/hooks/run-story-hook.cmd
- references/codex/hooks/run-story-hook.sh
- references/codex/hooks/story_codex_hook.py
- references/diagnostics.md
- references/generic/AGENTS.md.tmpl
- references/openclaw/AGENTS.md.tmpl
- references/opencode/AGENTS.md.tmpl
- references/opencode/agents/chapter-extractor.md
- references/opencode/agents/character-designer.md
- references/opencode/agents/consistency-checker.md
- references/opencode/agents/narrative-writer.md
- references/opencode/agents/story-architect.md
- references/opencode/agents/story-explorer.md
- references/opencode/agents/story-researcher.md
- references/opencode/commands/browser-cdp.md
- references/opencode/commands/story-cover.md
- references/opencode/commands/story-deslop.md
- references/opencode/commands/story-import.md
- references/opencode/commands/story-long-analyze.md
- references/opencode/commands/story-long-scan.md
- references/opencode/commands/story-long-write.md
- references/opencode/commands/story-review.md
- references/opencode/commands/story-setup.md
- references/opencode/commands/story-short-analyze.md
- references/opencode/commands/story-short-scan.md
- references/opencode/commands/story-short-write.md
- references/opencode/commands/story.md
- references/opencode/opencode.json.patch
- references/opencode/plugin.ts
- references/opencode/pre-commit.sh
- references/opencode/story_hook_core.js
- references/reasonix/AGENTS.md.tmpl
- references/templates/.gitkeep
- references/templates/CLAUDE.md.tmpl
- references/templates/agents/chapter-extractor.md
- references/templates/agents/character-designer.md
- references/templates/agents/consistency-checker.md
- references/templates/agents/narrative-writer.md
- references/templates/agents/story-architect.md
- references/templates/agents/story-explorer.md
- references/templates/agents/story-researcher.md
- references/templates/hooks/check-prose-after-write.sh
- references/templates/hooks/detect-story-gaps.sh
- references/templates/hooks/guard-outline-before-prose.sh
- references/templates/hooks/lib/common.sh
- references/templates/hooks/lib/sentinel.sh
- references/templates/hooks/post-compact.sh
- references/templates/hooks/pre-compact.sh
- references/templates/hooks/session-end.sh
- references/templates/hooks/session-start.sh
- references/templates/hooks/story_hook_cli.js
- references/templates/hooks/story_hook_core.js
- references/templates/hooks/validate-story-commit.sh
- references/templates/rules/story-consistency.md
- references/templates/rules/story-format.md
- references/templates/rules/story-narrative.md
- references/templates/rules/story-outline.md
- references/templates/settings-hooks.json
- references/zcode/AGENTS.md.tmpl
- references/zcode/commands/browser-cdp.md
- references/zcode/commands/story-cover.md
- references/zcode/commands/story-deslop.md
- references/zcode/commands/story-import.md
- references/zcode/commands/story-long-analyze.md
- references/zcode/commands/story-long-scan.md
- references/zcode/commands/story-long-write.md
- references/zcode/commands/story-review.md
- references/zcode/commands/story-setup.md
- references/zcode/commands/story-short-analyze.md
- references/zcode/commands/story-short-scan.md
- references/zcode/commands/story-short-write.md
- references/zcode/commands/story.md
- references/zcode/config.json.patch
- references/zcode/hooks/hooks.json
- references/zcode/hooks/story_hook_core.js
- references/zcode/hooks/story_zcode_hook.js
- scripts/copy-path-safety.py
- scripts/deploy-antigravity-skills.py
- scripts/generate-antigravity-agents.mjs
- scripts/merge-antigravity-hooks.py
- scripts/merge-claude-settings.py
- scripts/merge-codex-hooks.py
What this skill tells the agent
story-setup：网文写作工具集基础设施部署
你是写作基础设施部署器。将网文写作工具集部署到用户项目目录：已适配的 CLI 走专用 hooks/agents/config；NarraFork、Web AI、自定义 Agent 等环境走通用文件模式。
执行铁律：不覆盖用户已有配置，合并而非替换。
选择模式
- 参数为
check，或用户只要求检查部署、诊断环境、排查 agent 不可用时：完整读取 references/diagnostics.md，按其中流程仅检查并报告；不进入下面的部署流程。 - 用户要求安装、更新或修复时：执行下面的部署流程。检查后已明确授权的修复沿用本文件的部署与合并规则。
Phase 1：检测项目状态
先自检参考目录：以正在执行的本 SKILL.md 所在目录为准，列出与它同级的 references/ 下的子目录，核对下面 9 个名字是否都在且都非空——agent-references、templates、opencode、codex、antigravity、zcode、openclaw、reasonix、generic；同级 scripts/merge-claude-settings.py、scripts/merge-codex-hooks.py、scripts/merge-antigravity-hooks.py、scripts/generate-antigravity-agents.mjs、scripts/deploy-antigravity-skills.py 与 scripts/copy-path-safety.py 也必须存在（Claude/Codex/Antigravity hooks 合并、Antigravity Skills 物化与 agent 生成、递归复制安全检查依赖它们）。有缺即 skill 包没装全，立即停止，不写任何部署文件，报告里区分「缺目录」「目录为空」和「缺脚本」，并给修复指令：「story-setup 参考资料包不完整，缺 {路径}。按你的安装方式重装 oh-story-claudecode（命令行装的重跑 npx skills add zenstory-ai/oh-story-claudecode -y -g，marketplace / Plugin Management 装的在面板里重装），再执行 /story-setup。」
判据是「有没有SKILL.md」：只看正在执行的SKILL.md同级的references/。项目内.claude/skills/story-setup/、.codex/skills/story-setup/和 OpenCode 的skills/story-setup/只有references/agent-references/、不含SKILL.md，不会是执行目录，也不要拿它们核对。Antigravity / ZCode / OpenClaw / Reasonix / generic 的项目副本是整份 skill 拷贝、自带SKILL.md，9 个子目录本就齐全，照常核对即可。
- 检查当前目录是否已部署过（存在
.story-deployed）
agents_version缺失、非整数或小于30→ 标记为待更新，继续执行当前部署agents_version: 30→ 使用 AskUserQuestion 确认是否重新部署；提示里写明重新部署只用当前本地 skill 包刷新项目文件，要拿 skill 本身的新版本得先更新 oh-story-claudecode（npx skills add或 marketplace），再回来重跑agents_version大于30→ 当前 story-setup 比项目部署旧；停止以避免降级覆盖，提示先更新 oh-story-claudecode，不写任何部署文件- 同时读
target_cli字段。已部署项目以 sentinel 里的值为准：非空时（逗号分隔的多端组合原样保留）跳过下面第 5-12 步的环境探测与选择，直接按这些端重新部署。只有字段缺失或为空，才回落到探测。用户明确要求增删目标端时，用 AskUserQuestion 在现有值基础上改，改完的值写回 sentinel。
- 检查是否有书名目录（包含
追踪/子目录的目录，或用户自定义结构）
- 有 → 识别为长篇项目，显示当前项目信息
- 无 → 识别为新项目或短篇项目
- 检查
.claude/settings.local.json是否存在
- 存在 → 读取现有配置，后续合并
- 不存在 → 后续创建新文件
- 检查
.active-book文件是否存在
- 存在 → 显示当前活跃书目
- 不存在 → 跳过
- 检查
opencode.json或.opencode/是否存在
- 存在 → 识别为 opencode 项目，
target_cli = opencode - 不存在 → 跳过
- 检查
.codex/、.codex/config.toml、.codex/agents/、.codex/hooks.json、AGENTS.md中的 Codex 段
- 存在 → 识别为 Codex 项目，
target_cli = codex - 不存在 → 跳过
- 检查
.agents/hooks.json、.agents/agents/，或.agents/rules/oh-story.md中的 Antigravity 标记
- 存在 → 识别为 Google Antigravity 项目，
target_cli = antigravity - 不存在 → 跳过
- 检查
.zcode/、.zcode/config.json、zcode.json、.zcode/skills/、.zcode/commands/、AGENTS.md中的 ZCode 段
- 存在 → 识别为 ZCode 项目，
target_cli = zcode - 不存在 → 跳过
- 检查
openclaw.json、.openclaw/，或AGENTS.md中的 OpenClaw 段（标题行含网文写作工具集（OpenClaw））
- 存在 → 识别为 OpenClaw 项目，
target_cli = openclaw - 不存在 → 跳过
- 检查
.reasonix/、reasonix-plugin.json、REASONIX.md，或AGENTS.md中的 Reasonix 段（标题行含网文写作工具集（Reasonix））
- 存在 → 识别为 Reasonix 项目，
target_cli = reasonix - 不存在 → 跳过
- 检查
AGENTS.md中的通用段（标题行含网文写作工具集（通用 Agent / Web AI））
- 存在 → 识别为通用 Web AI 项目，
target_cli = generic - 不存在 → 跳过
第 9-11 步只认各端互斥的标记。skills/*/SKILL.md的metadata.openclaw不作 OpenClaw 信号：13 个 skill 全都带这个字段，而 OpenClaw / Reasonix / generic 三条 skills-only 路径部署出的skills/长得一样，用它判定会把后两者一律误认成 OpenClaw。.agents/skills/由 Antigravity、Codex 与 Reasonix 共用，也不单独作准；Antigravity 必须由 hooks/agents/rule 专属标记识别。后三端真正的分辨点是各自AGENTS.md模板的标题行。
- 如
.claude/或CLAUDE.md、OpenCode、Codex、Antigravity、ZCode、OpenClaw、Reasonix、generic 标记同时存在 → 使用 AskUserQuestion 让用户选择目标环境（选项：Claude Code / OpenCode / Codex / Google Antigravity / ZCode / OpenClaw / Reasonix / 通用 Web AI 或其他 Agent / 任意组合） - 如八类标记都不存在（全新项目）→ 使用 AskUserQuestion 让用户选择目标环境
- 用户选择 opencode →
target_cli = opencode，部署时创建opencode.json和.opencode/ - 用户选择 claude-code → 按现有逻辑处理
- 用户选择 codex →
target_cli = codex，部署时创建.codex/ - 用户选择 antigravity →
target_cli = antigravity，部署时创建.agents/skills、.agents/agents、.agents/rules、.agents/hooks并合并.agents/hooks.json - 用户选择 zcode →
target_cli = zcode，部署时创建.zcode/、合并根AGENTS.md，不创建项目 custom agents - 用户选择 openclaw →
target_cli = openclaw，部署时复制 OpenClaw 兼容 skills 到项目skills/ - 用户选择 reasonix →
target_cli = reasonix，部署时复制 skills 到项目skills/、写入 Reasonix 版AGENTS.md，不创建项目 custom agents/hooks - 用户选择通用 Web AI / 其他 Agent →
target_cli = generic，部署通用AGENTS.md与项目本地skills/；不写平台专属 hooks/agents - 用户选择多端 →
target_cli = claude-code,opencode,codex,antigravity,zcode,openclaw,reasonix,generic的子集（仅包含用户选择的端）
Phase 2：部署基础设施
使用 AskUserQuestion 确认部署位置后，依次执行。
整个 Phase 2 幂等：目录复制、文件写入和下表各合并算法重复执行结果一致。因环境原因（工具不可用、权限被拒、网络失败）中途失败时，直接从头重跑本 Phase，不需要先清理半成品；create only if absent 的用户状态文件（见下表 Owner class）不会被二次覆盖。
两列基准目录不同：Source path 相对正在执行的这份 skill 包，Target path 相对用户项目根。执行每一行（以及下面各端部署算法里的每个递归复制步骤）之前，先把通配符具体化为单个源/目标，再用本 SKILL.md 同级的 scripts/copy-path-safety.py 检查。该脚本按 Path.resolve / realpath 语义跟随已有 symlink，并在两侧都存在时用 samefile 核对文件系统对象；只转绝对路径或比较字符串不算检查完成。读取其 JSON：status: same 时 no-op，禁止复制；仅 copy_allowed: true 时可以复制；source_missing、unsafe_target_within_source 或 filesystem_identity_error 必须停止该步骤并报告。无法运行脚本时只能用当前环境的文件系统 API 做完全相同的 canonical realpath、same-object 与 target-descendant 检查；无法确认就停止，不得尝试复制。OpenClaw / Reasonix / generic 的项目副本是整份 skill 拷贝，重跑时执行的就是项目里那份；Reasonix / Codex 还可能经 .agents/skills → ../skills symlink 加载，路径文本不同也可能指向同一目录，照字面复制会把目录嵌进自身并撑满磁盘。
部署前清理自嵌套残留：{.claude,.codex,.zcode}/skills/story-setup/references/agent-references/ 与项目根 skills/story-setup/references/agent-references/ 里若多出 agent-references/ 层（可能嵌了多层），以及 skills/story-setup/skills/，整段删掉再部署，并在安装报告里列出删掉的路径。
Step 1：部署清单（机械可检查）
| Source path | Target path | Owner class | Merge mode | Validation check | |
|---|---|---|---|---|---|
skills/story-setup/references/templates/CLAUDE.md.tmpl | CLAUDE.md | user+managed | marker/section merge | contains story skill routing sections | |
skills/story-setup/references/templates/hooks/ | .claude/hooks/ | story-setup managed | recursive replace | session-*.sh, detect-story-gaps.sh, validate-story-commit.sh, guard-outline-before-prose.sh, check-prose-after-write.sh, story_hook_core.js, story_hook_cli.js, lib/common.sh, lib/sentinel.sh exist；story_hook_core.js 与 OpenCode/ZCode 副本字节一致 | |
skills/story-setup/references/templates/rules/*.md | .claude/rules/*.md | story-setup managed | replace | every rule contains paths frontmatter | |
skills/story-setup/references/templates/agents/*.md | .claude/agents/*.md | story-setup managed | replace | 7 agent files exist | |
skills/story-setup/references/agent-references/*.md | .claude/skills/story-setup/references/agent-references/*.md | story-setup managed | replace | every story-setup/references/agent-references/*.md reference resolves | |
skills/story-setup/references/templates/settings-hooks.json | .claude/settings.local.json | user+managed | replace managed registrations by stable hook identity | hook JSON valid；旧 matcher 注册已迁移、当前模板命令各一份、用户 hook 保留 | |
skills/story-setup/scripts/merge-claude-settings.py | 部署时执行，不复制到项目 | story-setup helper | execute | 替换已知 story hook 注册、保留用户 hooks/顶层字段，v24→v25 迁移与重复执行幂等 | |
skills/story-setup/scripts/copy-path-safety.py | 每个递归复制步骤前执行，不复制到项目专用目录 | story-setup helper | execute | JSON 仅 copy_allowed: true 时允许复制；symlink 同对象 no-op；target 位于 source 内时停止 | |
| generated sentinel | .story-deployed | story-setup managed | replace | contains agents_version, setup_skill_version, target_cli, resolver_strategy, references_dir | |
skills/story-setup/references/opencode/AGENTS.md.tmpl | AGENTS.md | user+managed | marker/section merge | contains story skill routing sections | target_cli 含 opencode |
More from zenstory-ai
Use this skill in a project
Open any RiverX project, search the Skills panel for zenstory-ai/oh-story-claudecode/story-setup, and install it in one click.