网文写作工具集基础设施部署与检查。为 Claude Code / OpenCode / Codex / Google Antigravity / ZCode / OpenClaw / Reasonix 提供内置适配;Web AI / 通用 Agent 可走 skills + AGENTS.md 文件模式。触发方式:/story-setup、$story-setup、「准备写书」「帮我搭一下环境」「配置写作项目」「检查写作环境」。
90%
Does it follow best practices?
Run evals on this skill
Adds up to 20 points to the overall score
Failed to scan
The risk profile of this skill
你负责把网文写作工具集部署到用户项目目录:已适配的 CLI 使用专用 hooks/agents/config;NarraFork、Web AI、自定义 Agent 等使用通用文件模式。
保留用户配置;受管文件按清单更新,共同维护的文件按管理块合并。
作者第一次部署的顺序:判断当前宿主 → 确认项目根 → 按宿主部署 → 验收 → 告诉作者下一步。本文件写公共流程;各宿主的部署清单、算法、校验和报告提示见 Phase 2 对应文件,只读本次目标宿主的那一份。
check,或用户只要求检查部署、诊断环境、排查 agent 不可用时:完整读取 references/diagnostics.md,按其中流程仅检查并报告;不进入下面的部署流程。先自检参考目录:以正在执行的本 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/merge-project-instructions.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 缺失、非整数或小于 44 → 标记为待更新,继续执行当前部署agents_version: 44 → 使用 AskUserQuestion 确认是否重新部署;提示里写明重新部署只用当前本地 skill 包刷新项目文件,要拿 skill 本身的新版本得先更新 oh-story-claudecode(npx skills add 或 marketplace),再回来重跑agents_version 大于 44 → 当前 story-setup 比项目部署旧;停止以避免降级覆盖,提示先更新 oh-story-claudecode,不写任何部署文件target_cli 字段。已部署项目以 sentinel 里的值为准:非空时(逗号分隔的多端组合原样保留)这些端照常重新部署,不再让作者选;第 4 步仍判断当前宿主:判断出来且不在其中(作者换了软件)→ AskUserQuestion 问「这个文件夹之前是给 {已部署宿主名} 装的,你现在用的是 {当前宿主名},要一起装上吗?」(「一起装上(推荐)」「只更新原来的」),选前者就加进 target_cli;判断不出不问。字段缺失或为空才走第 4-6 步。用户明确要求增删目标端时,用 AskUserQuestion 在现有值基础上改,改完的值写回 sentinel。target_cli 不含 opencode、但项目里有 .opencode/plugins/story-hooks.ts 或 .opencode/agents/(多端部署时 OpenCode 曾被版本门拦下)→ 用 AskUserQuestion 问是否把 OpenCode 加回来;选加回则先过 references/deploy-opencode.md 的「部署前置」,通过后写回 target_cli检查是否有书名目录(包含 追踪/ 子目录的目录,或用户自定义结构)
检查 .active-book 文件是否存在:存在 → 显示当前活跃书目;不存在 → 跳过
判断当前宿主(能判断就不问作者)。依次看,第一条能定下来的就用:
agy)、ZCode、OpenClaw 或 Reasonix 里;SKILL.md 的安装位置带有宿主专属目录(如 .claude/、.codex/、.zcode/、.gemini/、.openclaw/、.opencode/);看项目里已有哪些宿主的标记:
.claude/ 或 CLAUDE.md → target_cli = claude-codeopencode.json、opencode.jsonc 或 .opencode/ → target_cli = opencode.codex/、.codex/config.toml、.codex/agents/、.codex/hooks.json、AGENTS.md 中的 Codex 段 → target_cli = codex.agents/hooks.json、.agents/agents/,或 .agents/rules/oh-story.md 中的 Antigravity 标记 → target_cli = antigravity.zcode/、.zcode/config.json、zcode.json、.zcode/skills/、.zcode/commands/、AGENTS.md 中的 ZCode 段 → target_cli = zcodeopenclaw.json、.openclaw/,或 AGENTS.md 中的 OpenClaw 段(标题行含 网文写作工具集(OpenClaw))→ target_cli = openclaw.reasonix/、reasonix-plugin.json、REASONIX.md,或 AGENTS.md 中的 Reasonix 段(标题行含 网文写作工具集(Reasonix))→ target_cli = reasonixAGENTS.md 中的通用段(标题行含 网文写作工具集(通用 Agent / Web AI))→ target_cli = genericCLAUDE.md / AGENTS.md 里的 <!-- oh-story:{宿主} 开始 管理块 → target_cli 含该宿主后三类只认各端互斥的标记:
skills/*/SKILL.md的metadata.openclaw不作 OpenClaw 信号(14 个 skill 都带,三条 skills-only 路径部署出的skills/一样);.agents/skills/由 Antigravity、Codex 与 Reasonix 共用,也不单独作准。
定下 target_cli:
target_cli 就是它。项目里另有其他宿主的标记时,用 AskUserQuestion 问一句白话:「这个文件夹之前也给 {其他宿主名} 装过写作工具,这次要一起更新吗?」选项:「只装 {当前宿主名}(推荐)」「一起更新」。作者一开始就说要装多个时照办。claude-code、网页版 AI 或其他工具 → generic、其余取小写产品名」换成 target_cli;多端为 claude-code,opencode,codex,antigravity,zcode,openclaw,reasonix,generic 中选中的端。确认项目根(通常不问):项目根就是当前工作目录。只有当前目录是用户主目录、磁盘根目录、系统目录,或就是本 skill 包自身的安装/源码目录时,才用一句白话问作者:「写作工具要装在哪个文件夹?一般就是放书稿的那个文件夹。」其他情况直接部署,在安装报告的「部署明细」里写明装在哪。
Phase 2 幂等:复制、写入与各宿主合并重复执行结果一致。受管目录中只覆盖 oh-story 自己的 14 个 skill、7 个助手、hook 与规则文件,保留同目录里作者自己的文件;不覆盖书稿、设定、大纲、追踪和 .active-book。工具、权限或网络问题中断后,从头重跑即可,不另清理半成品;create only if absent 的用户状态文件(见清单 Owner class)不会被覆盖。
两列基准目录不同:Source path 相对当前 SKILL.md 所在包目录;Target path 相对用户项目根。每个递归复制步骤前,先把通配符具体化为单个源/目标,再用同级 scripts/copy-path-safety.py 检查(按 Path.resolve / realpath 跟随 symlink,两侧存在时用 samefile 核对文件系统对象,目标位于源目录内判 target-descendant 拦截;只比字符串不算检查):status: same 时 no-op 禁复制;仅 copy_allowed: true 可复制;其余异常状态停止并报告。无法跑脚本时须用文件系统 API 做完全相同的 realpath、samefile 与 target-descendant 检查,无法确认即停止。
部署前清理自嵌套残留与独占目录退役文件:
{.claude,.codex,.zcode}/skills/story-setup/references/agent-references/ 与项目根 skills/story-setup/references/agent-references/ 若多出 agent-references/ 层,以及 skills/story-setup/skills/,整段删掉并记入报告。agent-references/、.claude/hooks/ 及 ZCode / OpenClaw / Reasonix / generic 的 14 个已知 {.zcode/skills,skills}/{skill-name}/ 前,按 python3 → python → py 探测解释器运行 scripts/copy-path-safety.py --prune-orphans <源目录> <目标目录>(仅 status: safe 且目标非 symlink 时删源端已删文件与空子目录,pruned 记入报告;same 零改动;无解释器时按同一安全条件手工清理)。agents/、rules/、commands/ 与顶层 skills/ 只按已知名字覆盖 oh-story 条目,不删同级用户文件或目录。对 target_cli 里的每个宿主,完整读取对应部署文件,按其中的部署清单(机械可检查)与算法依次执行;不读其他宿主的文件。
target_cli | 部署文件 |
|---|---|
claude-code | references/deploy-claude-code.md |
opencode | references/deploy-opencode.md(先过其中「部署前置」版本门) |
codex | references/deploy-codex.md |
antigravity | references/deploy-antigravity.md |
zcode | references/deploy-zcode.md |
openclaw | references/deploy-openclaw.md |
reasonix | references/deploy-reasonix.md |
generic | references/deploy-generic.md |
多端部署时几个宿主共用根 AGENTS.md,各占一个管理块(见下方「项目指令合并」);某一端被自己的前置条件拦下(如 OpenCode 版本门、Antigravity 缺 Node)时,按该端部署文件的规定处理,其他端照常部署。
.story-deployed(sentinel file);全部目标停止时保留旧标记,不创建新标记。key: value 格式,hook 用 references/templates/hooks/lib/sentinel.sh 读取):
deployed_at: <date -u +"%Y-%m-%dT%H:%M:%SZ">
agents_version: 44
setup_skill_version: 1.3.12
target_cli: claude-code(或 opencode、codex、antigravity、zcode、openclaw、reasonix、generic,或其任意组合)
resolver_strategy: project-local-skill-reference
references_dir: .claude/skills/story-setup/references/agent-references(Codex 写 .codex/skills/...;Antigravity 写 .agents/skills/...;ZCode 写 .zcode/skills/...;OpenCode / OpenClaw / Reasonix / generic 写 skills/...;多端用逗号分隔)仅检查模式复用第 1–2 项,跳过第 3 项,且其中要求实际执行 hook 或写入 fixture 的子项改为只做静态校验(文件存在、语法有效、注册项齐全),不运行会写入项目的 hook,也不创建部署标记。
target_cli 里的每个宿主,执行其部署文件的「验证」一节。.story-deployed 存在,字段齐全,版本号与 Step 2 的字段块一致只替换 {项目名}:用作者给的书名或项目名,没给就用当前目录名,去掉花括号。模板里其余花括号写法(如 {书名}/正文/)表示「任意一本书的目录」,原样保留。
每个宿主在项目指令文件里占一个管理块:<!-- oh-story:{宿主} 开始 … --> 到 <!-- oh-story:{宿主} 结束 -->,块里是渲染后的模板;Claude Code 写 CLAUDE.md,其余宿主共用根 AGENTS.md。按 python3 → python → py 的顺序探测出可用的 Python 记为 PYBIN,运行:
"$PYBIN" "{story-setup skill目录}/scripts/merge-project-instructions.py" --host {宿主} --template {该宿主模板} --existing {项目指令文件} --output {项目指令文件} --project-name {项目名}规则(无法运行脚本时照此手工合并):
把脚本输出的旧节名写进安装报告的「部署明细」。
| 文件 | 用途 |
|---|---|
| references/deploy-*.md | 8 份宿主部署文件:各自的部署清单、算法、验证与安装报告提示,按 Phase 2 Step 1 只读目标宿主那份 |
| references/diagnostics.md | 仅检查模式 |
| UPGRADING.md | 写给作者:各版本要不要重跑、哪些旧数据要迁移 |
zenstory-ai/oh-story-claudecode
41a9b6c
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.