zenstory-ai/oh-story-claudecode / skills/story-setup
story-setup
Unverified网文写作工具集基础设施部署与检查。为 Claude Code / OpenCode / Codex / Google Antigravity / ZCode / OpenClaw / Reasonix 提供内置适配;Web AI / 通用 Agent 可走 skills + AGENTS.md 文件模式。触发方式:/story-setup、$story-setup、「准备写书」「帮我搭一下环境」「配置写作项目」「检查写作环境」。
references/openclaw/AGENTS.md.tmpl
View on GitHub# {项目名} — 网文写作工具集(OpenClaw)
本项目已部署 oh-story skills 的 OpenClaw 兼容层。
## Skill 路由表
OpenClaw 会从项目 `skills/` 目录发现 `SKILL.md`。优先通过 OpenClaw 的 skills/slash-command 入口调用;若当前客户端未显示直接命令,可用自然语言点名 skill。
| 命令/意图 | Skill | 说明 |
|------|-------|------|
| `/skill story-long-write`、写长篇 | story-long-write | 长篇网文写作(逐章推进) |
| `/skill story-short-write`、写短篇 | story-short-write | 短篇网文写作(情绪驱动) |
| `/skill story-long-analyze`、长篇拆文 | story-long-analyze | 长篇小说深度拆解 |
| `/skill story-short-analyze`、短篇拆文 | story-short-analyze | 短篇小说拆文分析 |
| `/skill story-long-scan`、长篇扫榜 | story-long-scan | 长篇小说榜单与市场趋势 |
| `/skill story-short-scan`、短篇扫榜 | story-short-scan | 短篇小说榜单与情绪风口 |
| `/skill story-deslop`、去 AI 味 | story-deslop | 去除 AI 写作痕迹 |
| `/skill story-cover`、封面 | story-cover | 生成封面图;需要 `GPT_IMAGE_API_KEY` |
| `/skill story-publish`、发布资料 | story-publish | 发布准备:整理并核对平台书籍资料;封面能力不可用时记待办 |
| `/skill story-review`、审查 | story-review | 多视角审查;OpenClaw Phase 1 默认 solo/soft-fallback |
| `/skill story-import`、导入 | story-import | 逆向导入已有小说到项目结构 |
| `/skill story`、网文 | story | 工具箱路由 · 模糊意图自动分发 |
| `/skill story-setup`、准备写书 | story-setup | 环境部署 · 多 CLI 配置入口 |
| `/skill browser-cdp` | browser-cdp | 浏览器 CDP 工具 |
## OpenClaw 兼容说明
- Phase 1 只部署 skills:`skills/*/SKILL.md` 使用 OpenClaw 兼容 frontmatter(`name` / `description` 单行,`metadata` 单行 JSON)。
- 暂不部署 OpenClaw agents/hooks:写正文前大纲守卫、commit 提醒、session/compact 自动注入在 OpenClaw 下不是硬拦截,只作为 skill 内软约束执行。
- OpenClaw 会在 session 启动时 snapshot eligible skills;部署或更新后如未立即出现,请新开 OpenClaw session,或等待 skills watcher 刷新。
- `story-cover` 依赖 `GPT_IMAGE_API_KEY`,未配置时 OpenClaw 会将该 skill 标记为不可用/缺少 env。
## 文件结构
- `skills/` — OpenClaw workspace skills,包含 oh-story 的 14 个 skill
- `拆文库/` — 拆文分析结果存放目录
- `{书名}/正文/` — 长篇小说正文章节
- `{书名}/正文.md` — 短篇小说正文
- `{书名}/设定/` — 角色设定、世界设定
- `{书名}/大纲/` — 卷纲、细纲
- `{书名}/追踪/` — 以 `_tracking-state.json` 为唯一底账,自动生成固定 7 栏 `上下文.md`、逐章记录、核心角色状态卡、伏笔清单和作者/读者双时间线
- `{书名}/对标/` — 对标作品分析
## 写作约束
- 写正文前必须先有对应大纲:长篇 `大纲/细纲_第N章*.md`,短篇 `小节大纲.md`。
- OpenClaw Phase 1 没有硬 hook 拦截;执行写作 skill 时必须由 skill 流程自行检查大纲,不得跳过。
- **每章写完先去 AI 味**(没有 hook 替你检查):正文落盘后同一轮内按写作 skill 的去味流程复核并清零 blocking 机械套式(词表仅作语境定位线索,不逐词清零);能运行 node 时跑写作 skill 的 `scripts/check-ai-patterns.js --check --fail-on=blocking {正文文件}`。写下一章前先确认上一章已改净。只有作者明确说「这章不去味」时才跳过,并在标题行下加 `<!-- 去味:跳过 -->`。
## 与作者协作
- 回复用作者说话的语言,等后台助手时的进度说明也一样;主体用写书的话说(书、章、大纲、设定),不抛脚本名、字段名或状态名;报错时附原始报错。skill 里标着 `<!-- author-report -->` 的模板块只是格式参考,回复时直接输出其中的文字,不带代码块围栏。
- 作者要求记住、改掉或忘掉一条写作习惯/偏好时(如「记住:这本书对话用直角引号」),按用户明确类型或当前书类型走 story-long-write / story-short-write 的「作者记忆管理」;无当前书的通用习惯默认交长篇入口,限定本书却无法定位时问哪本书,不要求先建书,写入相应工作区或书目录的 `.story/作者记忆/`;不要存进编程工具自带的记忆。一次性要求直接照做,不记录。
- 不修改项目里已安装的 skill 文件(`SKILL.md`、`references/`、`scripts/`;story-setup 重新部署时覆盖除外)。skill 脚本报错时停下,把报错和所执行的命令告诉作者,不自行修补绕过。
## Compact 后恢复上下文
写作中的关键上下文:
1. 当前写作项目名称和进度
2. 最近讨论的角色设定变更
3. 未完成的伏笔列表
4. 当前章节的情绪/节奏目标
长篇先读 `{书名}/追踪/上下文.md`;短篇先读 `{书名}/设定.md` 和 `{书名}/小节大纲.md`。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |