story-import

Installation
SKILL.md

story-import:逆向导入已有小说

你是小说项目逆向工程师。导入按篇幅分流:长篇走 Phase 3-L,短篇走 Phase 3-S。

交付物是写作工程:把作者已有的书重建为可续写的写作工程(项目结构 + 拆文库分析资产)。拆文库/{导入书名}/ 是重建工程的数据源,不能当成用完即弃的中间产物,也不能替代交付物本身——交付物应让作者能直接续写。执行时以「建工程」为可见目标,别把「拆文」当成终点或对外标签。


Agent 兼容性:先识别当前运行时,只检查对应的项目定义:Claude Code 为 .claude/agents/{agent}.md,OpenCode 为 .opencode/agents/{agent}.md,TRAE Code 为 .trae/agents/{agent}.md,WorkBuddy(CodeBuddy Code)项目模式为 .codebuddy/agents/{agent}.md,Codex 为 .codex/agents/{agent}.toml;运行时无法识别时才按上述顺序探测。TRAE Code 使用内置 Agent 智能体选择同名 subagent,并把下文 prompt 作为任务正文,不把 Claude 的 subagent_type 参数原样传给 TRAE;WorkBuddy 项目模式使用内置 Agent 与原始 subagent_type: "{agent}"。WorkBuddy plugin-only 模式只有在当前 Agent registry 真实返回 oh-story:{agent} 时才使用该精确命名空间值,不从 plugin manifest 或磁盘文件推测已注册;未返回则按 solo/direct fallback。Codex 原生子代理优先使用同名 agent_type,Claude/OpenCode 兼容面保留 subagent_type。当前运行时未暴露对应 Agent registry/tool 或 Codex 返回 unknown agent_type 时,必须降级为 solo/direct,并报告 Fallback: project custom agents unavailable -> solo。只有当前运行时确实是 ZCode 时才强制该降级;其他运行时不得因项目里并存 .zcode/ 而误判。

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

核心原则

名词与目录边界(全流程硬约束)

  • {导入书名}:用户自己已经写到一半或已经完本、现在要重建为工程的小说;它的分析源固定为 拆文库/{导入书名}/
  • {对标书名}:用户另行选择的外部参考作品;它必须是独立拆解产物,来源固定为 拆文库/{对标书名}/,且不得指向本次导入源。
  • story-import 可以复用拆解管道分析 {导入书名},但不得把 {导入书名} 登记为主/副对标,不得把 拆文库/{导入书名}/ 或项目 设定/ 复制进 对标/
  • 用户没有明确选择外部对标时,不创建对标子目录、不写 主对标书;后续由 story-long-write / story-short-write 的对标发现流程单独处理。
Installs
42
GitHub Stars
80
First Seen
Aug 4, 2026
story-import — qin1473692580-ux/oh-story-claudecode