用途：将网文写作工具集部署到用户项目目录。已适配的 CLI 走专用 hooks/agents/config，NarraFork、Web AI、自定义 Agent 等环境走通用文件模式。核心原则是不覆盖用户已有配置，合并而非替换。
主要能力：判断当前宿主与项目根；按宿主执行对应部署文件（claude-code、opencode、codex、antigravity、zcode、openclaw、reasonix、generic 各一份）；通过脚本合并 Claude/Codex/Antigravity hooks、物化 Antigravity Skills、生成 agent；用 copy-path-safety.py 做递归复制安全检查；创建 .story-deployed 标记（含 agents_version、target_cli、references_dir 等）；完成后验证并输出面向作者的安装报告。支持多端同时部署，AGENTS.md 按 marker/section 合并。
使用方式：安装、更新或修复时执行部署流程；参数为 check 时读取 references/diagnostics.md 仅检查报告。按宿主专属部署文件执行，只读目标宿主那一份。重装命令示例：npx skills add zenstory-ai/oh-story-claudecode -y -g。
适用场景：首次部署写作基础设施、诊断环境、排查 agent 不可用、升级 agents_version。
限制：agent 需支持对应宿主；OpenCode 有版本门，Antigravity 需 Node；skill 包不完整或缺脚本时立即停止；agents_version 大于 34 时停止以避免降级覆盖；无法运行安全检查脚本时必须用等价文件系统检查确认。部分宿主专属细节需查阅各自部署文件。