- name
SKILL.md
Le fichier du skill reste dans le dépôt de l'éditeur.
Collez la commande copiée dans un terminal. Elle installe ce SKILL.md dans cet agent.
npx skills add zenstory-ai/oh-story-claudecode --skill story -a cursor -yCollez la commande copiée dans un terminal. Elle installe ce SKILL.md dans cet agent.
npx skills add zenstory-ai/oh-story-claudecode --skill story -a claude-code -yCollez la commande copiée dans un terminal. Elle installe ce SKILL.md dans cet agent.
npx skills add zenstory-ai/oh-story-claudecode --skill story -a codex -yCollez la commande copiée dans un terminal. Elle installe ce SKILL.md dans cet agent.
npx skills add zenstory-ai/oh-story-claudecode --skill story -a grok -yEnvoyez le message copié dans un chat Grok Bot. Le Bot récupère ce SKILL.md sur GitHub et l'ajoute aux skills que partagent tous vos Bots.
Install this skill: https://github.com/zenstory-ai/oh-story-claudecode/tree/HEAD/skills/storyDe l'éditeur
识别用户的写作需求,并路由到对应 skill。
各宿主的调用写法:Claude Code、OpenCode 用 /story-*(Claude 插件安装时为 /oh-story:story-*),也可 Skill("story-*");Codex、ZCode 用 $story-*(Codex 也可 /skills);OpenClaw 用 /skill story-*;Antigravity、Reasonix 在 skill 入口选择或用自然语言点名。下表按 /story-* 写,其他宿主照此替换,本文件其余地方同理。
能明确匹配就直接调用对应 skill;匹配不上时只问缺的那一项。用户说"我想写小说"但没说长篇还是短篇,先问篇幅再路由。
只说 /story、看不出意图时,不贴路由表,给四个白话选项:「开一本长篇或接着写」→ /story-long-write;「写一篇短篇」→ /story-short-write;「把一章改得不那么 AI」→ /story-deslop;「更多(拆书、扫榜、导入旧稿、审稿、封面)」→ 再列进阶项。还没部署过(项目根没有 .story-deployed)时先建议 /story-setup,并说明部署完要新开一个会话再开始,写作助手才会生效。
作者明确要填平台建书资料(书名、简介、标签)时走 /story-publish,只说“开书”照常进长篇写作。ClawHub 单独安装的 story 不带 story-publish,找不到它时直接告诉作者,请其安装完整技能包,不凭记忆给平台标签。
用户问"导入续写先 setup 还是 import"时,直接回答:推荐先 /story-setup,新开会话后 /story-import;导完长篇说 /story-long-write 写第N章(N 是导入后的下一章),短篇用 /story-short-write 先补完构思。如果用户已经直接触发 /story-import,按 story-import 自带环境检测继续:未 setup 时让用户选择先去 setup 或继续串行导入。
本文件的"书目录""当前书"均按此查找:
.active-book 且指向项目内一个存在的目录 → 就是它。. 开头的目录、node_modules、拆文库/、对标/:
追踪/、正文/ 子目录或 正文.md 文件的目录(与写作 hook 同一口径);设定/题材定位.md 的目录;设定.md 与 小节大纲.md 的目录。
找到多本又没有 .active-book 时,需要"当前书"就问作者是哪本(做法同「多书切换」)。正文/ 或 设定/ 子目录的是长篇,有 正文.md 或 设定.md 文件的是短篇。没找到任何书目录:创建写作项目时先运行 /story-setup;只讨论结构、选题,或要扫榜、拆文时直接路由。找到了:按目标 skill 自己的环境检查继续,需要初始化或补部署时运行 /story-setup。
按用户明确指定的长篇/短篇选写作 skill;没指定时按当前书的篇幅。没有当前书的通用习惯交 /story-long-write 管理;只针对某本书却定位不到时问是哪本,不要求先建书。路由层只转交,不读写作者记忆文件。
「查故事资料」交 story-explorer,prompt 三行:
项目目录:{书目录的绝对路径}
查询类型:{按下表选}
查询参数:{用户问到的角色名、伏笔、设定关键词或章节范围}
一句话含多类查询时,分次调用或只选最主要的一类;问的是创作建议而不是查已有内容时,不交给它,主会话直接答。
「查资料」交 story-researcher,prompt 按下面写,没有的可选项整行省略:
query:{要查的主题}
type:{可选:历史考证、地理/环境、职业知识、文化习俗、器物/服饰、诗词典故、视觉参考、真实案例}
context:{可选:为什么要查,如正在写哪一段}
project_dir:{书目录的绝对路径;没有书目录时用项目根}
cdp_port:{可选:Chrome 调试端口不是 9222 时写}
Spawn 版本提示(不阻断 spawn):先读取项目根
.story-deployed的agents_version。与本版agents_version: 44不一致时(标记缺失、字段缺失/非整数、小于或大于 44)照常按当前宿主角色来源检查并 spawn;同时用一句白话提示作者「查资料助手是旧版,运行 /story-setup(ZCode 先更新插件)后新开会话」,Notice: agents bundle 版本不匹配(项目 {N},本版 44)原文写进回答最末一行「技术备注:」;大于 44 时额外提示先更新 oh-story-claudecode,不要用本地旧版 setup 降级覆盖。只有当前宿主角色缺失或不暴露调用能力时才降级 solo/direct,Fallback: ... -> solo同样只进技术备注行。
走助手前只做本端可用性检查:当前不在子代理内、有本端调用工具,且对应角色可用(Claude .claude/agents/*.md、OpenCode .opencode/agents/*.md、Codex .codex/agents/*.toml、Antigravity .agents/agents/agent-name/agent.md;ZCode 查插件注册的同名角色,不要求 .zcode/agents)→ 可尝试 spawn。Antigravity 用 invoke_subagent + 同名 TypeName,ZCode 用 Agent 按实际 schema 派发,不跨端误判。任一不满足或返回 unknown agent,则降级处理:
story-explorer 不可用 → 主会话直接用 Read/Grep 从书目录检索(角色状态、伏笔、进度、设定),回答前说一句「查资料助手没启用,这次我直接翻项目文件」;项目尚未部署时提示先 /story-setup。story-researcher 不可用 → 主会话用当前可用的搜索能力回答,回答前说一句「查资料助手没启用,这次我直接搜」;搜不到就如实说明。讲故事里的事(谁、在哪章、发生了什么);文件字段名、伏笔/事件编号不单独出现,编号必须跟着故事描述。助手返回的英文字段和缺口说明由主会话翻成白话再说。
用户想切换或查看在写的书时(一个项目可同时有多本):
.active-book 指向的那本。.active-book(覆盖原内容)。用户执行 /story dashboard,或明确要求打开工作台、查看项目文件时,启动本 skill 的本地 Dashboard:
把当前工作目录作为默认工作区;用户明确给出目录时改用该目录。目录必须存在。
从当前已加载的 story skill 目录定位 scripts/dashboard-server.mjs,不要硬编码仓库路径、
全局 skill 路径或用户主目录。
检查 node 可用后,以长运行进程执行:
node "<story-skill-dir>/scripts/dashboard-server.mjs" --root "<workspace>" --open
等待输出出现“本机地址”,把完整 URL 回给用户。工具支持后台进程/PTY 时让服务保持运行; 无法自动拉起浏览器不算失败,仍返回可点击 URL。
Dashboard 默认只监听 127.0.0.1。不要主动增加 --allow-network,不要把工作区暴露到
局域网或公网。
工作台按自己的规则识别目录,与上方「书目录判定」不同:识别标准 拆文库/{书名}/,兼容存量 拆文库-{书名}/;写作项目识别同时支持:
正文/、大纲/、设定/ 或 追踪/ 任一普通子目录。正文.md 且同时含 小节大纲.md 或 设定.md,或构思阶段同时含普通文件 设定.md 与 小节大纲.md。符号链接不作为项目标记,只有单个 正文.md 或单个 设定.md 的资料目录不识别为写作项目。浏览器可编辑 .md、.txt、.json、.yaml、.yml、.toml;保存或确认删除时核对文件内容版本,避免覆盖外部修改。
停止服务时终止对应的 Node 长运行进程即可。若用户只问用法,不要替他启动;告诉用户用 /story dashboard(按上方宿主写法替换)。
用户问“有没有新版本”“检查更新”“升级”时执行。先报告版本,是否安装由用户决定。
当前版本:读本 skill 同目录的 VERSION 文件;缺失则视为未知。本 skill 在写作项目里(如项目下的 skills/、.agents/skills/、.zcode/skills/)时,读到的是项目副本的版本。
最新版本:优先 gh release view --json tagName,name,url -R zenstory-ai/oh-story-claudecode 取 tagName;无 gh 用 curl -fsS --max-time 5 https://api.github.com/repos/zenstory-ai/oh-story-claudecode/releases/latest 取 .tag_name(jq 或 grep)。查不到 → 告知"暂时拉不到最新版本,可手动看 Releases",不报错。
比较:当前版本已知时,去掉 v 前缀按语义版本比较(major.minor.patch);未知时只展示最新稳定版,不判定是否已最新。gh release 默认取 latest 稳定版,不含 pre-release。
告知:
更新(用户同意后):按本 skill 目录的位置判断安装方式。
plugins/):Claude Code 跑 claude plugin marketplace update oh-story-skills 再跑 claude plugin update oh-story@oh-story-skills,重启后生效;ZCode 在 Plugin Management 里刷新市场后更新 oh-story。npx skills 装在全局或当前目录:重跑 npx skills add zenstory-ai/oh-story-claudecode -y -g(原来装在当前目录的去掉 -g)。/story-setup,项目里的副本才会换成新版;OpenClaw、Reasonix 和通用文件模式下项目里跑的就是这份旧副本,要用新包手动覆盖项目 skills/ 下的 14 个 skill 目录。更新完提示:已部署过的项目在项目根重跑 /story-setup 同步 hooks、agents 和参考资料,然后新开一个会话,写作助手才会重新加载。
网络小说工具箱主入口。根据用户需求自动路由到对应 skill,并可启动本地 Dashboard。触发方式:/story、$story、/story dashboard、/网文、「我想写小说」「记住我的写作习惯」「打开工作台」「检查更新」。
---name: storydescription: 网络小说工具箱主入口。根据用户需求自动路由到对应 skill,并可启动本地 Dashboard。触发方式:/story、$story、/story…---# skills/story/SKILL.mdFAQ
Téléchargez skills/story/SKILL.md auprès de l'éditeur, ou copiez le chemin et ouvrez le dépôt. PlugMCP répertorie le skill et n'héberge pas le fichier.
L'éditeur le maintient sur https://github.com/zenstory-ai/oh-story-claudecode.
Claude, Cursor, Codex et Grok Build peuvent lire un SKILL.md que vous ajoutez depuis le dépôt de l'éditeur. Grok Bot l'installe lorsque vous envoyez dans un chat le lien du dossier GitHub du skill.