oh-story-claudecode

环境要求

• 已安装并可用一个受支持的编程 Agent：Claude Code、Codex CLI、Google Antigravity、OpenCode、ZCode、Ope
• Node 环境（npx 可用，部分 hook 依赖 PATH 中的 node）
• 已安装 git；Windows 上 Codex 用户需为 git 开启 core.symlinks=true
• 无需 GPU，本地只运行 Node / Python 确定性检查脚本

安装与启动步骤

1. 1命令行安装 skill

   用 npx skills 独立安装，不经过任何 marketplace。加 -g 为全局安装（所有目录可用），去掉 -g 只装到当前目录。

   npx skills add zenstory-ai/oh-story-claudecode -y -g

   复制

2. 2Claude Code 插件安装

   Claude Code 用户也可用插件市场方式安装，marketplace 名保持 oh-story-skills，安装 oh-story bundle。

   claude plugin marketplace add https://github.com/zenstory-ai/oh-story-claudecode
   claude plugin install oh-story@oh-story-skills

   复制

3. 3让 Agent 自行安装

   支持导入 GitHub 仓库/skill 的 Web AI 或 Agent 平台，把这句话发给它即可。升级时再说一次同一句话。

   安装这个 skill https://github.com/zenstory-ai/oh-story-claudecode

   复制

4. 4部署到写作项目

   在写作项目根目录运行 story-setup，按目标 CLI 写入 skills/agents/hooks 等。OpenClaw、Reasonix、通用路径需选 target_cli。

   /story-setup

   复制

5. 5检查安装环境

   向 Agent 说这句话或给 story-setup 传 check 参数，按目标 CLI 的部署清单检查并给出建议，仅检查不改动项目。

   /story-setup check

   复制

6. 6导入已有小说

   续写场景使用。它会先检测是否已 setup，未部署时让你选择先去 setup 或继续串行导入。

   /story-import

   复制

7. 7开始写作

   部署并刷新会话后调用写作命令，例如日更模式或指定章节号续写。

   /story-long-write 日更

   复制

关键配置

如何确认成功

新会话里运行 /story-review，报告头显示 Effective Mode: full/lean 说明 agent 注册成功；显示 Fallback: ... -> solo 则当前运行时未暴露。

常见问题

注意事项

• 安装命令 `npx skills add zenstory-ai/oh-story-claudecode -y -g` 是独立安装路径，不经过 Claude Code 或 ZCode marketplace。
• 升级后建议在项目根重跑 /story-setup 同步 hooks / agents / references。
• 7 个专业 agent 由 /story-setup 写入项目，必须部署后新开会话才生效。
• agy 1.1.22 -p 暂不在支持面内，命令行写作请从项目目录启动交互式 agy。