{"slug":"story-setup-2","title":"story-setup","summary":"网文写作工具集基础设施部署与检查。为 Claude Code / OpenCode / Codex / Google Antigravity / ZCode / OpenClaw / Reasonix 提供内置适配；Web AI / 通用 Agent 可走 skills + AGENTS.md 文件模式。触发方式：/story-setup、$story-setup、「准备写书」「帮我搭一下环境」「配置写作项目」「检查写作环境」。","platform":"Claude","tags":[],"authorName":"LLM Mart","authorSlug":"llm-mart","score":0,"source":"github","price":null,"verified":false,"createdAt":"2026-10-02T16:32:46.278392Z","repo":{"url":"https://github.com/zenstory-ai/oh-story-dsh","stars":433,"forks":74,"license":"MIT","updatedAt":"2026-10-02T11:40:12Z"},"bodyHtml":"
\n

name: story-setup\nversion: 1.3.2\ndescription: \"网文写作工具集基础设施部署与检查。为 Claude Code / OpenCode / Codex / Google Antigravity / ZCode / OpenClaw / Reasonix 提供内置适配；Web AI / 通用 Agent 可走 skills + AGENTS.md 文件模式。触发方式：/story-setup、$story-setup、「准备写书」「帮我搭一下环境」「配置写作项目」「检查写作环境」。\"\nmetadata: {\"openclaw\":{\"source\":\"https://github.com/zenstory-ai/oh-story-claudecode\"}}

\n

story-setup：网文写作工具集基础设施部署

\n

你是写作基础设施部署器。将网文写作工具集部署到用户项目目录：已适配的 CLI 走专用 hooks/agents/config；NarraFork、Web AI、自定义 Agent 等环境走通用文件模式。

\n

执行铁律：不覆盖用户已有配置，合并而非替换。

\n

作者第一次部署的顺序：判断当前宿主 → 确认项目根 → 按宿主部署 → 验收 → 告诉作者下一步。本文件只写各宿主通用的流程；每个宿主专属的部署清单、算法、校验和安装报告提示在各自的部署文件里，只读本次目标宿主的那一份（见 Phase 2）。

\n

选择模式

\n\n
\n

Phase 1：判断宿主与项目

\n

先自检参考目录：以正在执行的本 SKILL.md 所在目录为准，列出与它同级的 references/ 下的子目录，核对下面 9 个名字是否都在且都非空——agent-references、templates、opencode、codex、antigravity、zcode、openclaw、reasonix、generic；同级 references/deploy-*.md（8 份宿主部署文件）、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。」

\n
\n

判据是「有没有 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 个子目录本就齐全，照常核对即可。

\n
\n
    \n

  1. 检查当前目录是否已部署过（存在 .story-deployed）

    \n\n
    2. \n

  2. 检查是否有书名目录（包含 追踪/ 子目录的目录，或用户自定义结构）

    \n\n
    3. \n

  3. 检查 .active-book 文件是否存在：存在 → 显示当前活跃书目；不存在 → 跳过

    \n
    4. \n

  4. 判断当前宿主（能判断就不问作者）。依次看，第一条能定下来的就用：

    \n\n
    5. \n

  5. 看项目里已有哪些宿主的标记：

    \n\n
    \n

    后三类只认各端互斥的标记：skills/*/SKILL.md 的 metadata.openclaw 不作 OpenClaw 信号（13 个 skill 都带，三条 skills-only 路径部署出的 skills/ 一样）；.agents/skills/ 由 Antigravity、Codex 与 Reasonix 共用，也不单独作准。

    \n
    \n
    6. \n

  6. 定下 target_cli：

    \n\n
    7. \n

  7. 确认项目根（通常不问）：项目根就是当前工作目录。只有当前目录是用户主目录、磁盘根目录、系统目录，或就是本 skill 包自身的安装/源码目录时，才用一句白话问作者：「写作工具要装在哪个文件夹？一般就是放书稿的那个文件夹。」其他情况直接部署，在安装报告的「部署明细」里写明装在哪。

    \n
    8. \n
\n

Phase 2：部署基础设施

\n

整个 Phase 2 幂等：目录复制、文件写入和各宿主部署文件里的合并算法重复执行结果一致。因环境原因（工具不可用、权限被拒、网络失败）中途失败时，直接从头重跑本 Phase，不需要先清理半成品；create only if absent 的用户状态文件（见各部署清单的 Owner class）不会被二次覆盖。

\n

两列基准目录不同：部署清单里 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 加载，路径文本不同也可能指向同一目录，照字面复制会把目录嵌进自身并撑满磁盘。

\n

部署前清理自嵌套残留：{.claude,.codex,.zcode}/skills/story-setup/references/agent-references/ 与项目根 skills/story-setup/references/agent-references/ 里若多出 agent-references/ 层（可能嵌了多层），以及 skills/story-setup/skills/，整段删掉再部署，并在安装报告里列出删掉的路径。

\n

Step 1：按宿主部署

\n

对 target_cli 里的每个宿主，完整读取对应部署文件，按其中的部署清单（机械可检查）与算法依次执行；不读其他宿主的文件。

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
target_cli部署文件
claude-codereferences/deploy-claude-code.md
opencodereferences/deploy-opencode.md（先过其中「部署前置」版本门）
codexreferences/deploy-codex.md
antigravityreferences/deploy-antigravity.md
zcodereferences/deploy-zcode.md
openclawreferences/deploy-openclaw.md
reasonixreferences/deploy-reasonix.md
genericreferences/deploy-generic.md
\n

多端部署时几个宿主共用根 AGENTS.md，按下方「AGENTS.md 合并策略」合并成一份；某一端被自己的前置条件拦下（如 OpenCode 版本门、Antigravity 缺 Node）时，按该端部署文件的规定处理，其他端照常部署。

\n

Step 2：创建部署标记

\n\n

Phase 3：验证安装

\n

仅检查模式复用第 1–2 项，跳过第 3 项，且其中要求实际执行 hook 或写入 fixture 的子项改为只做静态校验（文件存在、语法有效、注册项齐全），不运行会写入项目的 hook，也不创建部署标记。

\n
    \n
  1. 对 target_cli 里的每个宿主，执行其部署文件的「验证」一节。
    2. \n
  2. 验证部署标记：\n\n
    3. \n
  3. 输出安装报告。读者是不懂编程的作者，按这个顺序写：\n\n
    4. \n
\n
\n

模板占位符

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
占位符替换规则示例
{项目名}用户项目名称或目录名《剑来》、《暗卫》
{书名}书名目录名（与目录一致）与 {项目名} 相同，或用户自定义
{目标平台}目标发布平台起点、番茄、晋江、知乎盐言
{作者名}用户笔名或昵称未指定时用「作者」
\n

替换时去掉花括号。如果用户未指定项目名，用当前目录名。未指定的占位符保留原样不替换。CLAUDE.md 的合并策略在 Claude Code 部署文件里。

\n

AGENTS.md 合并策略（OpenCode / Codex / ZCode / OpenClaw / Reasonix / generic）

\n

用户已有 AGENTS.md 时，按 marker/section 合并：

\n
    \n
  1. 优先识别 story-setup 管理块标记（如果旧项目已有标记，只替换标记内内容）
    2. \n
  2. 无标记时，读取用户现有 AGENTS.md，按 ## 标题切分为 section map
    3. \n
  3. OpenCode 使用 skills/story-setup/references/opencode/AGENTS.md.tmpl；Codex 使用 skills/story-setup/references/codex/AGENTS.md.tmpl；ZCode 使用 skills/story-setup/references/zcode/AGENTS.md.tmpl；OpenClaw 使用 skills/story-setup/references/openclaw/AGENTS.md.tmpl；Reasonix 使用 skills/story-setup/references/reasonix/AGENTS.md.tmpl；通用 Web AI / 其他 Agent 使用 skills/story-setup/references/generic/AGENTS.md.tmpl
    4. \n
  4. 模板中的标准 section（Skill 路由表、文件结构、协作规则、与作者协作、Compact 后恢复上下文；模板有而用户文件没有的 section 直接补入）覆盖同名 section；用户独有 section 保留
    5. \n
  5. 多端同时部署时，Codex/OpenCode/ZCode/OpenClaw/Reasonix/generic 共同可用的通用段落只保留一份；工具特有说明以小节区分，避免互相覆盖
    6. \n
\n

重新部署

\n\n
\n

参考资料

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
文件用途
references/deploy-*.md8 份宿主部署文件：各自的部署清单、算法、验证与安装报告提示，按 Phase 2 Step 1 只读目标宿主那份
references/diagnostics.md仅检查模式
UPGRADING.md各版本升级要点
\n
\n

流程衔接

\n

流水线： 部署\n位置： 初始化（最前置）

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
时机跳转到命令
部署完成，开始写作story-long-write / story-short-write/story-long-write 或 /story-short-write
导入已有小说做拆解story-import/story-import
需要浏览器登录态（扫榜/拆文取原文）browser-cdp/browser-cdp；generic 需平台允许本地脚本/浏览器控制
\n

各端调用语法：Claude /名、Codex/ZCode $名、Antigravity 通过 /skills 浏览或直接点名、OpenClaw /skill 名、Reasonix / generic 直接点名 skill。

\n","files":[{"path":"references/agent-references/agent-quality.md","sizeBytes":3641,"isText":true},{"path":"references/agent-references/agent-reference-profiles.md","sizeBytes":4031,"isText":true},{"path":"references/agent-references/anti-ai-writing.md","sizeBytes":37187,"isText":true},{"path":"references/agent-references/banned-words.md","sizeBytes":10424,"isText":true},{"path":"references/agent-references/benchmark-style-load.md","sizeBytes":10103,"isText":true},{"path":"references/agent-references/character-basics.md","sizeBytes":16921,"isText":true},{"path":"references/agent-references/character-design-methods.md","sizeBytes":16262,"isText":true},{"path":"references/agent-references/character-relations.md","sizeBytes":17831,"isText":true},{"path":"references/agent-references/deslop-gates.md","sizeBytes":14455,"isText":true},{"path":"references/agent-references/dialogue-mastery.md","sizeBytes":11764,"isText":true},{"path":"references/agent-references/emotional-arc-design.md","sizeBytes":12258,"isText":true},{"path":"references/agent-references/emotion-on-page.md","sizeBytes":4739,"isText":true},{"path":"references/agent-references/format-and-structure.md","sizeBytes":10617,"isText":true},{"path":"references/agent-references/genre-prose-cards.md","sizeBytes":7162,"isText":true},{"path":"references/agent-references/genre-prose-cards/东方仙侠.md","sizeBytes":2788,"isText":true},{"path":"references/agent-references/genre-prose-cards/传统玄幻.md","sizeBytes":2801,"isText":true},{"path":"references/agent-references/genre-prose-cards/历史古代.md","sizeBytes":2635,"isText":true},{"path":"references/agent-references/genre-prose-cards/历史脑洞.md","sizeBytes":2934,"isText":true},{"path":"references/agent-references/genre-prose-cards/双男主.md","sizeBytes":3272,"isText":true},{"path":"references/agent-references/genre-prose-cards/古言脑洞.md","sizeBytes":2676,"isText":true},{"path":"references/agent-references/genre-prose-cards/古风世情.md","sizeBytes":2622,"isText":true},{"path":"references/agent-references/genre-prose-cards/女频悬疑.md","sizeBytes":2637,"isText":true},{"path":"references/agent-references/genre-prose-cards/女频种田.md","sizeBytes":2693,"isText":true},{"path":"references/agent-references/genre-prose-cards/宫斗宅斗.md","sizeBytes":2522,"isText":true},{"path":"references/agent-references/genre-prose-cards/年代.md","sizeBytes":3069,"isText":true},{"path":"references/agent-references/genre-prose-cards/快穿.md","sizeBytes":2858,"isText":true},{"path":"references/agent-references/genre-prose-cards/悬疑灵异.md","sizeBytes":2616,"isText":true},{"path":"references/agent-references/genre-prose-cards/悬疑脑洞.md","sizeBytes":2788,"isText":true},{"path":"references/agent-references/genre-prose-cards/战神赘婿.md","sizeBytes":2810,"isText":true},{"path":"references/agent-references/genre-prose-cards/抗战谍战.md","sizeBytes":2728,"isText":true},{"path":"references/agent-references/genre-prose-cards/星光璀璨.md","sizeBytes":2800,"isText":true},{"path":"references/agent-references/genre-prose-cards/民国言情.md","sizeBytes":2817,"isText":true},{"path":"references/agent-references/genre-prose-cards/游戏体育.md","sizeBytes":2899,"isText":true},{"path":"references/agent-references/genre-prose-cards/玄幻脑洞.md","sizeBytes":3004,"isText":true},{"path":"references/agent-references/genre-prose-cards/玄幻言情.md","sizeBytes":2596,"isText":true},{"path":"references/agent-references/genre-prose-cards/现言脑洞.md","sizeBytes":2741,"isText":true},{"path":"references/agent-references/genre-prose-cards/科幻末世.md","sizeBytes":2653,"isText":true},{"path":"references/agent-references/genre-prose-cards/职场婚恋.md","sizeBytes":2612,"isText":true},{"path":"references/agent-references/genre-prose-cards/西方奇幻.md","sizeBytes":2834,"isText":true},{"path":"references/agent-references/genre-prose-cards/豪门总裁.md","sizeBytes":3343,"isText":true},{"path":"references/agent-references/genre-prose-cards/都市修真.md","sizeBytes":2580,"isText":true},{"path":"references/agent-references/genre-prose-cards/都市日常.md","sizeBytes":3766,"isText":true},{"path":"references/agent-references/genre-prose-cards/都市种田.md","sizeBytes":2584,"isText":true},{"path":"references/agent-references/genre-prose-cards/都市脑洞.md","sizeBytes":3485,"isText":true},{"path":"references/agent-references/genre-prose-cards/都市高武.md","sizeBytes":3018,"isText":true},{"path":"references/agent-references/genre-prose-cards/青春甜宠.md","sizeBytes":2790,"isText":true},{"path":"references/agent-references/genre-readers.md","sizeBytes":11027,"isText":true},{"path":"references/agent-references/long-chapter-hooks.md","sizeBytes":8784,"isText":true},{"path":"references/agent-references/long-emotional-methods.md","sizeBytes":10316,"isText":true},{"path":"references/agent-references/long-genre-catalog.md","sizeBytes":17378,"isText":true},{"path":"references/agent-references/long-genre-mechanics.md","sizeBytes":17364,"isText":true},{"path":"references/agent-references/long-quality.md","sizeBytes":3181,"isText":true},{"path":"references/agent-references/long-reversal.md","sizeBytes":15581,"isText":true},{"path":"references/agent-references/long-suspense.md","sizeBytes":15524,"isText":true},{"path":"references/agent-references/opening-design.md","sizeBytes":12819,"isText":true},{"path":"references/agent-references/outline-conflict.md","sizeBytes":17651,"isText":true},{"path":"references/agent-references/outline-methods.md","sizeBytes":10896,"isText":true},{"path":"references/agent-references/outline-rhythm.md","sizeBytes":12878,"isText":true},{"path":"references/agent-references/plot-core-methods.md","sizeBytes":20291,"isText":true},{"path":"references/agent-references/short-chapter-hooks.md","sizeBytes":8632,"isText":true},{"path":"references/agent-references/short-emotional-methods.md","sizeBytes":7925,"isText":true},{"path":"references/agent-references/short-genre-formulas.md","sizeBytes":20590,"isText":true},{"path":"references/agent-references/short-paragraph-hooks.md","sizeBytes":6848,"isText":true},{"path":"references/agent-references/short-quality.md","sizeBytes":2789,"isText":true},{"path":"references/agent-references/short-reversal.md","sizeBytes":16673,"isText":true},{"path":"references/agent-references/short-suspense.md","sizeBytes":15939,"isText":true},{"path":"references/agent-references/style-combat-face.md","sizeBytes":17329,"isText":true},{"path":"references/agent-references/style-genre-modules.md","sizeBytes":24811,"isText":true},{"path":"references/agent-references/style-resolution.md","sizeBytes":4016,"isText":true},{"path":"references/agent-references/writing-craft.md","sizeBytes":28753,"isText":true},{"path":"references/diagnostics.md","sizeBytes":4535,"isText":true},{"path":"SKILL.md","sizeBytes":18727,"isText":true}],"reviewScore":null,"reviewSummary":null,"trust":{"provenance":"trusted-source-unreviewed","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow.","bodySource":null},"bodyLocked":false,"purchaseUrl":null,"sourceUrl":null,"report":{"provenance":"trusted-source-unreviewed","screen":{"ran":true,"outcome":"clean","suspicious":0,"notes":0,"hiddenCharacters":false},"virusScan":{"engine":"clamav","status":"clean","scannedAt":"2026-10-02T16:33:35.450527Z","sha256":"8DEC2A3505CAAA1CB34EAA32EDA6866E3CD51152F3DB023BDC1E08043440C009","sizeBytes":324511},"review":null,"source":{"repositoryUrl":"https://github.com/zenstory-ai/oh-story-dsh","path":"packages/knowledge/oh-story/skills/story-setup","license":"MIT","commit":"d734089bae893783d8bfaf09f8e8fa0a99723ef0","subtreeSha":"1ED446FD5E93C386FD624C97D823FD2CD875ED625EBE053E5BE2EEEFF4EF9328","lastSyncedAt":"2026-10-02T16:32:40.531554Z"},"reviewedAt":"2026-10-02T16:34:58.248534Z","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow."},"install":[{"target":"skills-cli","command":"npx skills add https://github.com/zenstory-ai/oh-story-dsh/tree/main/packages/knowledge/oh-story/skills/story-setup"},{"target":"claude-code","command":"claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install zenstory-ai-oh-story-dsh@llmmart"},{"target":"git","command":"git clone https://github.com/zenstory-ai/oh-story-dsh.git"}]}