用户意图	关键词示例	路由到
长篇规划/写作	讨论长篇结构、规划剧情、开书、写大纲、补细纲、长篇、连载	`/story-long-write`
写短篇	短篇、盐言、一万字	`/story-short-write`
长篇拆文	拆文、分析这本书、黄金三章、灵感库、跨书灵感聚合	`/story-long-analyze`
短篇拆文	拆短篇、分析这个故事	`/story-short-analyze`
长篇扫榜	长篇排行、什么火、新书在冒什么、起点/番茄/晋江/七猫长篇	`/story-long-scan`
选题决策	写什么能爆、帮我选题、选题方向	`/story-long-scan`
短篇扫榜	短篇排行、知乎盐言排行	`/story-short-scan`
去 AI 味	去 AI 味、太 AI、去味	`/story-deslop`
审查稿件	审查、审稿、帮我审一下、一致性检查、看看有没有问题	`/story-review`
封面	封面、封面图	`/story-cover`
环境部署	准备写书、搭环境、初始化	`/story-setup`
浏览器操控	浏览器、抓取、登录态	`/browser-cdp`
导入小说	导入、反向解析、导入小说、把我的书导进来	`/story-import`
工作台	dashboard、工作台、看拆文库、浏览项目文件、打开项目面板	见下方「Dashboard 工作台」
检查/更新版本	检查更新、有新版本吗、升级、更新工具箱	见下方「版本更新检查」
切换/列出书目	切书、换书、列出我的书、我在写哪几本、切换项目	见下方「多书切换」
管理作者习惯	记住我的写作习惯、作者画像、待确认偏好、忘掉这个偏好	`/story-long-write` 或 `/story-short-write`（按下方规则选择）
查故事资料	查角色、查伏笔、查进度、查设定、什么状态、写到哪了	spawn `story-explorer` agent（结构化 prompt：`项目目录：{dir}\n查询类型：{根据意图选择}\n查询参数：{用户查询}`）；agent 不可用时见下方「查询降级」
查资料	查资料、帮我查资料、调研、搜索一下、搜一下	spawn `story-researcher` agent；agent 不可用时见下方「查询降级」

裸调用与新手

只说 /story、看不出意图时，不贴路由表，给四个白话选项：「开一本长篇或接着写」→ /story-long-write；「写一篇短篇」→ /story-short-write；「把一章改得不那么 AI」→ /story-deslop；「更多（拆书、扫榜、导入旧稿、审稿、封面）」→ 再列进阶项。还没部署过（项目根没有 .story-deployed）时先建议 /story-setup。

导入续写顺序

用户问"导入续写先 setup 还是 import"时，直接回答：推荐先 /story-setup，新开/刷新会话后 /story-import，最后 /story-long-write 日更 或 /story-long-write 写第N章。如果用户已经直接触发 /story-import，按 story-import 自带环境检测继续：未 setup 时让用户选择先去 setup 或继续串行导入。

作者习惯管理路由

按用户明确指定的长篇/短篇类型选择对应写作 skill；未指定时用当前书类型（正文/ 为长篇，正文.md 与 小节大纲.md 或 设定.md 为短篇）。无当前书的通用习惯默认交长篇入口管理；只限定本书却无法定位时问哪本书，不要求先建书。将管理请求交给该写作 skill，路由层不读写作者记忆文件。

Dashboard 工作台

用户执行 /story dashboard（Codex 为 $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、.txt、.json、.yaml、.yml、.toml；保存或确认删除时核对文件内容版本，避免覆盖外部修改。

停止服务时终止对应的 Node 长运行进程即可。若用户只问用法，不要替他启动；给出 /story dashboard / $story dashboard 两种平台对应入口。

路由流程

分析用户请求，提取意图关键词
匹配上表，找到对应的 skill
如果能明确匹配，直接调用对应 skill（Claude/OpenCode 可用 Skill("skill-name") 或 slash command；Codex 用 $skill-name / /skills；Antigravity 用 /skills 或自然语言点名；OpenClaw 用 /skill skill-name 或自然语言点名）
无法匹配时只问缺失信息；写作篇幅按下一条处理
如果用户说"我想写小说"但未指定长篇/短篇，询问篇幅类型后再路由

查询降级

Spawn 版本提示（不阻断 spawn）：先读取项目根 .story-deployed 的 agents_version。与本版 agents_version: 35 不一致时（标记缺失、字段缺失/非整数、小于或大于 35）照常按文件存在性检查并 spawn，但只检查当前运行时的 canonical 目录；同时报告 Notice: agents bundle 版本不匹配（项目 {N}，本版 35） 并提示重新运行 /story-setup 后新开会话；大于 35 时额外提示先更新 oh-story-claudecode，不要用本地旧版 setup 降级覆盖。只有 agent 文件缺失、或运行时不暴露 custom agent 时才降级 solo/direct，报告 Fallback: ... -> solo。

「查故事资料」「查资料」走 agent 前先做轻量可用性检查（路由只做这一层，不承担全局部署策略）：当前不在子代理上下文、当前运行时的 Agent/Task 或 invoke_subagent 工具可用，且对应部署文件存在（Claude .claude/agents/*.md、OpenCode .opencode/agents/*.md、Codex .codex/agents/*.toml、Antigravity .agents/agents/agent-name/agent.md，其中 agent-name 为目标 agent 名）→ 可尝试 spawn。Antigravity 用 invoke_subagent + 同名 TypeName，不得因其他端文件存在而误判。任一不满足，或运行时返回 unknown agent / 未暴露 custom-agent registry，则降级，不硬失败：

story-explorer 不可用 → 主会话直接用 Read/Grep 从项目文件检索（角色状态/伏笔/进度/设定），回答前说一句「查资料助手没启用，这次我直接翻项目文件」；项目尚未部署时提示先 /story-setup（Codex 中用 $story-setup）。
story-researcher 不可用 → 主会话用现有检索/回答能力完成，或提示用户改用 /browser-cdp 采集，同样用一句白话说明。

回答作者时讲故事里的事（谁、在哪章、发生了什么）；文件字段名、伏笔/事件编号不单独出现，编号必须跟着故事描述。

项目状态感知

路由前先检查当前项目状态：

无项目目录（没有包含 追踪/ 或 设定/ 的书名目录，也没有同时有 正文.md 与 小节大纲.md（或 设定.md）的短篇目录）：
- 创建写作项目时先运行 /story-setup 初始化环境（Codex 中用 $story-setup）；只讨论结构或选题时直接路由
- 如果用户要扫榜/拆文，直接路由
已有项目：读取 .story-deployed，按目标 skill 的环境检查继续；查询沿用上方降级，导入保留串行选项。需要初始化或补部署时运行 /story-setup（Codex 中用 $story-setup）。

多书切换

用户想切换或查看在写的书时（一个项目可同时有多本）：

在项目根查找所有书目录：包含 追踪/ 或 设定/ 子目录的目录，或同时有 正文.md 与 小节大纲.md（或 设定.md）的目录（含 长篇/、短篇/ 下的子目录）。
列出书名，并标出当前 .active-book 指向的那本。
让用户选择，把所选书的相对路径写入项目根 .active-book（覆盖原内容）。
只发现一本时直接确认为活跃书，无需询问。

版本更新检查

用户问“有没有新版本”“检查更新”“升级”时执行。先报告版本，是否安装由用户决定。

当前版本：读本 skill 同目录的 VERSION 文件；缺失则视为未知。
最新版本：优先 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。
告知：
- 已最新 → 「已是最新版 vX.Y.Z」。
- 有新版或当前版本未知 → 展示已知版本与 Releases/CHANGELOG，有 release notes 时附更新要点，再用宿主可用的提问方式问「现在更新吗？」：
  - 选更新 → 跑 npx skills add zenstory-ai/oh-story-claudecode -y -g（-g 全局，去掉则只更当前目录）；完成后提示：已部署过的项目在项目根重跑 /story-setup（Codex 中用 $story-setup）同步 hooks/agents/references，并新开一个会话让 agents 重新注册。
  - 选先不 → 不动，告知随时可再来。

story

story：网文工具箱路由

路由表