SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场story-setup

story-setup

写作与研究

查看项目

更新于 10-16 10:46

技能介绍

用途

story-setup 是网文写作工具集的基础设施部署器，负责把写作工具集部署到用户的项目目录，让作者可以直接开始长篇或短篇网文写作、拆解对标书等工作。它同时可作为环境诊断工具使用。

主要能力

  • 多宿主适配部署：为 Claude Code、OpenCode、Codex、Google Antigravity（含命令行 agy）、ZCode、OpenClaw、Reasonix 提供内置适配；Web AI、通用 Agent、NarraFork、自建 Agent 等环境走 skills + AGENTS.md 的通用文件模式。
  • 合并而非覆盖：执行铁律是不覆盖用户已有配置。已有的 AGENTS.md、CLAUDE.md、settings 等文件按 marker 或 section 合并：优先识别 story-setup 管理块标记，无标记时按 ## 标题切分 section 合并，模板中的标准 section 覆盖同名 section，用户独有 section 保留。多端同时部署时共用段落只保留一份。
  • 部署状态管理：通过 .story-deployed 标记文件记录 deployed_at、agents_version、setup_skill_version、target_cli、resolver_strategy、references_dir 等字段，供 session-start 和写作 skill 检测部署状态，避免重复提示。
  • 重新部署与版本控制：.story-deployed 不存在为全新安装；version 等于 34 时提示已部署并询问是否重装；缺失或小于 34 时标记待更新并覆盖更新 agents/hooks/rules/reference bundle；大于 34 时停止以避免降级覆盖。
  • 仅检查模式：参数为 check，或用户只要求检查部署、诊断环境、排查 agent 不可用时，读取 references/diagnostics.md，按其中流程仅检查并报告，不进入部署流程。
  • 安全复制检查：执行复制前用 scripts/copy-path-safety.py 检查源/目标路径，读取其 JSON 结果，仅在 copy_allowed: true 时可复制，遇到撞路径或异常必须停止。

使用方式

作者首次部署顺序为：判断当前宿主 → 确认项目根 → 按宿主部署 → 验收 → 告知作者下一步。选择模式：参数为 check 或仅要求检查时仅诊断报告；要求安装、更新或修复时执行部署流程。

部署流程分三个阶段：

  • Phase 1 判定宿主与项目：自检 references 目录完整性，检查是否已部署、是否有书名目录、.active-book 是否存在，判断当前宿主并确定 target_cli。
  • Phase 2 部署基础设施：对 target_cli 中每个宿主读取对应部署文件执行；创建 .story-deployed 标记。整个阶段幂等，中途失败可直接重跑。
  • Phase 3 验证安装：执行各宿主部署文件的验证一节；仅检查模式复用第 1–2 项并做静态校验；输出面向不懂编程作者的安装报告，分「现在可以做什么」「你还需要做的事」「部署明细」三段。

各端调用语法：Claude 用 /名、Codex/ZCode 用 $名、Antigravity 通过 /skills 浏览或直接点名、OpenClaw 用 /skill 名、Reasonix 与 generic 直接点名 skill。

安装命令：npx skills add zenstory-ai/oh-story-claudecode -y -g（也可在 marketplace / Plugin Management 面板安装后执行 /story-setup）。

适用场景

  • 网文作者首次在受支持的 CLI 或 Web AI / 通用 Agent 中搭建写作环境。
  • 已经部署过、需要更新 hooks/agents/rules/reference bundle 的已有项目。
  • 排查「agent 不可用」等环境问题时的诊断检查。
  • 使用 OpenCode / Codex / ZCode / OpenClaw / Reasonix / generic 等通过 AGENTS.md 接入的宿主。

限制

  • 该 skill 仅做基础设施部署与检查，不直接进行写作；写作经 story-long-write / story-short-write 命令，导入已有小说走 story-import，需要浏览器登录态（扫榜/拆文取原文）走 browser-cdp（generic 需平台允许本地脚本/浏览器控制）。
  • 需要 skill 包完整（references 下 9 个子目录与 8 份宿主部署文件、若干脚本齐备），有缺即停止且不写任何部署文件。
  • 无法运行 copy-path-safety.py 时只能用当前环境的文件系统 API 做等价的 canonical realpath、same-object 与 target-descendant 检查，无法确认则停止，不得尝试复制。
  • 下载/重装 skill 本身需走 npx skills add 或 marketplace，story-setup 只刷新项目文件。
  • 具体各类宿主的部署步骤、参数与版本门细节由各自的部署文件定义。

关于收费、价格、平台、效果等未在本资料中提供的具体信息，暂未提供。