story-setup

网文写作工具集基础设施部署。为 Claude Code / OpenCode / Codex / ZCode / OpenClaw / Reasonix 提供内置适配；Web AI / 通用 Agent 可走 skills + AGENTS.md 文件模式。触发方式：/story-setup、$story-setup、「准备写书」「帮我搭一下环境」「配置写作项目」。

Aller à l'installation

Dépôt: zenstory-ai/oh-story-claudecode
Dernière activité de la source: 24 août 2026 à 15:14
Langue détectée de SKILL.md: chinois
Étoiles: 6 020
Forks: 894

Options d'installation

Le prompt qui vérifie d'abord la source est sélectionné par défaut. Vous pouvez passer à une commande directe ou télécharger une copie locale.

Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.

Une commande directe contourne le prompt de vérification. Examinez la source avant de l'exécuter.

npx skills add https://github.com/zenstory-ai/oh-story-claudecode --skill story-setup

La commande reste sur une seule ligne. Faites défiler horizontalement pour la vérifier avant de la copier.

Vous préférez une copie locale ? Téléchargez les fichiers actuellement disponibles dans SkillsMP.

Vérifiez les fichiers source

Lisez SKILL.md et les fichiers associés affichés par SkillsMP avant de décider de l'installer.

Explorateur de fichiers

100 fichiers

SKILL.md

Instructions source · Aperçu en lecture seule

Retour à la recherche Retour à l’installation

browser-cdp

Use this skill when you need to control a Chrome browser via CDP (Chrome DevTools Protocol) to reuse existing login sessions. Covers: launching Chrome in debug mode, opening URLs, waiting for page load, evaluating JavaScript, taking snapshots, and extracting auth tokens. Trigger phrases: browser automation, CDP, agent-browser, 浏览器操作, 操作浏览器, Chrome CDP, 复用登录态, extract token from browser.

2026-08-24

story-cover

小说封面生成。根据书名、作者名自动分析题材风格，调用 GPT-Image-2 生成含标题和署名的专业级网文封面；Codex CLI 优先使用内置 ImageGen，无需单独 API Key。触发方式：/story-cover、/封面、「帮我做个封面」「生成封面图」「做个小说封面」「封面设计」。

2026-08-24

story-deslop

网文去AI味。检测并清除文本中的AI写作痕迹，让文字回归自然、非模板化。触发方式：/story-deslop、/去AI味、「去AI味」「这篇太AI了」「网文去AI味」。

2026-08-24

Tout voir dans ce dépôt

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

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

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

Phase 1：检测项目状态

先自检参考目录：以正在执行的本 SKILL.md 所在目录为准，列出与它同级的 references/ 下的子目录，核对下面 8 个名字是否都在且都非空——agent-references、templates、opencode、codex、zcode、openclaw、reasonix、generic；同级 scripts/merge-claude-settings.py、scripts/merge-codex-hooks.py 与 scripts/copy-path-safety.py 也必须存在（Claude/Codex hooks 合并和递归复制安全检查依赖它们）。有缺即 skill 包没装全，立即停止，不写任何部署文件，报告里区分「缺目录」「目录为空」和「缺脚本」，并给修复指令：「story-setup 参考资料包不完整，缺 {路径}。按你的安装方式重装 oh-story-claudecode（命令行装的重跑 npx skills add zenstory-ai/oh-story-claudecode -y -g，marketplace / Plugin Management 装的在面板里重装），再执行 /story-setup。」

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

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

Phase 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

skills/story-setup/references/opencode/agents/

.opencode/agents/

story-setup managed

replace

7 agent files exist（replace 前按「配置 OpenCode Agent 模型」中的「保留已有模型配置」缓存现有 model:，避免覆盖用户已配模型）

skills/story-setup/references/opencode/plugin.ts

.opencode/plugins/story-hooks.ts

story-setup managed

replace

TypeScript plugin file exists

skills/story-setup/references/opencode/story_hook_core.js

.opencode/plugins/lib/story_hook_core.js

story-setup managed

replace

Node syntax valid；与 ZCode 副本字节一致；被 story-hooks.ts import

skills/story-setup/references/opencode/commands/

.opencode/commands/

story-setup managed

replace

13 command files exist

skills/story-setup/references/opencode/opencode.json.patch

merge into opencode.json

user+managed

merge by plugin/permission key

plugin entry registered

repository skills/story-setup/references/agent-references/

skills/story-setup/references/agent-references/

story-setup managed

replace

every reference resolves

skills/story-setup/references/opencode/pre-commit.sh

.git/hooks/pre-commit

user+managed

append or create

file exists and is executable；含 marker 块则替换块内容，不含则检测 exit 0 位置智能插入

skills/story-setup/references/codex/AGENTS.md.tmpl

AGENTS.md

user+managed

marker/section merge

contains Codex story skill routing sections

skills/story-setup/references/codex/agents/

.codex/agents/

story-setup managed

replace

7 TOML agent files parse and contain name/description/developer_instructions

skills/story-setup/references/codex/hooks/hooks.json

.codex/hooks.json

user+managed

replace managed registrations by stable hook identity

hook JSON valid; all stale direct/launcher registrations removed, current 6 registrations present exactly once

skills/story-setup/references/codex/hooks/{story_codex_hook.py,run-story-hook.sh,run-story-hook.cmd}

.codex/hooks/ 同名文件

story-setup managed

replace

Python/shell/cmd launcher 文件齐全

skills/story-setup/scripts/merge-codex-hooks.py

部署时执行，不复制到项目

story-setup helper

execute

替换已知管理注册、保留用户 hooks 与未知顶层字段，结果幂等

skills/story-setup/references/agent-references/

.codex/skills/story-setup/references/agent-references/

story-setup managed

replace

every reference resolves

skills/story-setup/references/zcode/AGENTS.md.tmpl

AGENTS.md

user+managed

marker/section merge

contains ZCode $story-* routing and solo fallback

repository skills/{browser-cdp,story*}/

.zcode/skills/{browser-cdp,story*}/

story-setup managed for known skill names

replace known skill dirs only

13 SKILL.md files exist and satisfy ZCode frontmatter limits

skills/story-setup/references/zcode/commands/

.zcode/commands/

story-setup managed for known command names

replace known command files only

13 commands have valid names/frontmatter

skills/story-setup/references/zcode/hooks/story_zcode_hook.js

.zcode/hooks/story_zcode_hook.js

story-setup managed

replace

Node syntax valid; hook contract tests pass

skills/story-setup/references/zcode/hooks/story_hook_core.js

.zcode/hooks/story_hook_core.js

story-setup managed

replace

Node syntax valid; hook contract tests pass

skills/story-setup/references/zcode/config.json.patch

merge into .zcode/config.json

user+managed

merge by event+matcher+process args

JSON valid; 按「ZCode 部署算法」第 4 步 hooks 互斥分支校验——未装 oh-story 插件时 hooks.enabled=true、only supported events；已装插件时校验 .zcode/config.json 不含（或已移除）这批 oh-story hooks 注册

skills/story-setup/references/openclaw/AGENTS.md.tmpl

AGENTS.md

user+managed

marker/section merge

contains OpenClaw story skill routing sections

skills/story-setup/references/generic/AGENTS.md.tmpl

AGENTS.md

user+managed

marker/section merge

contains generic story skill routing sections

skills/story-setup/references/reasonix/AGENTS.md.tmpl

AGENTS.md

user+managed

marker/section merge

contains Reasonix story skill routing sections and solo/direct fallback

repository skills/{browser-cdp,story*}/

skills/{browser-cdp,story*}/

story-setup managed for known skill names

replace known skill dirs only

13 SKILL.md files exist; OpenClaw-compatible frontmatter

repository skills/story-setup/references/agent-references/

随上一行整份 skill 拷贝落地，本行 no-op

story-setup managed

不单独复制

every reference resolves

Agent 模型配置： story-architect → <高端模型>（provider/model-id） narrative-writer → <中端模型>（provider/model-id） character-designer → <中端模型>（provider/model-id） story-researcher → <中端模型>（provider/model-id） chapter-extractor → <低端模型>（provider/model-id） consistency-checker → <低端模型>（provider/model-id） story-explorer → <低端模型>（provider/model-id）

无法自动检测模型列表。以下 Agent 未配置模型，将使用主模型，成本可能较高： - chapter-extractor（建议使用低成本模型） - consistency-checker（建议使用低成本模型） - story-explorer（建议使用低成本模型）手动配置方法：编辑 .opencode/agents/{agent名}.md，在 frontmatter 中添加： model: provider/model-id 可用模型列表与成本可通过 opencode models --verbose 查看（输出含每模型 cost/context）。模型库与定价见 OpenCode 官方模型源 https://models.dev/。

等级	匹配关键词	对应 Agent
低端	`haiku`, `flash`, `mini`, `nano`, `lite`	chapter-extractor, consistency-checker, story-explorer
中端	`sonnet`, `plus`	story-researcher, narrative-writer, character-designer
高端	`opus`, `pro`, `ultra`, `max`	story-architect

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

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

story-setup

Options d'installation

Vérifiez les fichiers source

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

Phase 1：检测项目状态

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

Phase 1：检测项目状态

Phase 2：部署基础设施

Step 1：部署清单（机械可检查）

opencode.json 合并算法

Step 2：部署 CLAUDE.md

Step 3：部署 Hooks

Step 4：部署 Rules

Step 5：部署 Agents

Agent 兼容性处理

部署 Agent References

部署 Codex Agents（target_cli 含 codex 时）

配置 OpenCode Agent 模型

Step 1：保留已有模型配置（必须在 `.opencode/agents/` 的 replace 之前执行）

Step 2：获取模型列表

Step 3：模型分级

Step 4：逐级交互选择

Step 5：写入 model 字段

Step 6：合并 Hooks 注册到 settings.local.json

Codex hooks.json 合并算法（target_cli 含 codex 时）

ZCode 部署算法（target_cli 含 zcode 时）

OpenClaw skills-only 部署算法（target_cli 含 openclaw 时）

Reasonix skills-only 部署算法（target_cli 含 reasonix 时）

通用 Web AI / 其他 Agent 部署算法（target_cli 含 generic 时）

Step 7：创建部署标记

Phase 3：验证安装

模板占位符

CLAUDE.md 合并策略

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

重新部署

参考资料

流程衔接

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

story-setup

Informations de source

Options d'installation

Vérifiez les fichiers source

Plus depuis ce dépôt

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

Phase 1：检测项目状态

Plus depuis ce dépôt

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

Phase 1：检测项目状态

Phase 2：部署基础设施

Step 1：部署清单（机械可检查）

opencode.json 合并算法

Step 2：部署 CLAUDE.md

Step 3：部署 Hooks

Step 4：部署 Rules

Step 5：部署 Agents

Agent 兼容性处理

部署 Agent References

部署 Codex Agents（target_cli 含 codex 时）

配置 OpenCode Agent 模型

Step 1：保留已有模型配置（必须在 .opencode/agents/ 的 replace 之前执行）

Step 2：获取模型列表

Step 3：模型分级

Step 4：逐级交互选择

Step 5：写入 model 字段

Step 6：合并 Hooks 注册到 settings.local.json

Codex hooks.json 合并算法（target_cli 含 codex 时）

ZCode 部署算法（target_cli 含 zcode 时）

OpenClaw skills-only 部署算法（target_cli 含 openclaw 时）

Reasonix skills-only 部署算法（target_cli 含 reasonix 时）

通用 Web AI / 其他 Agent 部署算法（target_cli 含 generic 时）

Step 7：创建部署标记

Phase 3：验证安装

模板占位符

CLAUDE.md 合并策略

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

重新部署

参考资料

流程衔接

Step 1：保留已有模型配置（必须在 `.opencode/agents/` 的 replace 之前执行）