Skip to content

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、「准备写书」「帮我搭一下环境」「配置写作项目」「检查写作环境」。

FileKindSize
SKILL.mdskill md16.7 KB
UPGRADING.mdmarkdown17.4 KB
references/agent-references/agent-quality.mdmarkdown3.7 KB
references/agent-references/agent-reference-profiles.mdmarkdown4.3 KB
references/agent-references/banned-words.mdmarkdown10.9 KB
references/agent-references/benchmark-style-load.mdmarkdown10.1 KB
references/agent-references/character-basics.mdmarkdown12.3 KB
references/agent-references/character-relations.mdmarkdown10.2 KB
references/agent-references/cross-book-recall.mdmarkdown3.9 KB
references/agent-references/deslop-gates.mdmarkdown2.3 KB
references/agent-references/dialogue-mastery.mdmarkdown11.0 KB
references/agent-references/expression.mdmarkdown9.6 KB
references/agent-references/female-audience-writing.mdmarkdown7.5 KB
references/agent-references/format-and-structure.mdmarkdown8.0 KB
references/agent-references/genre-prose-cards.mdmarkdown7.0 KB
references/agent-references/genre-prose-cards/东方仙侠.mdmarkdown2.3 KB
references/agent-references/genre-prose-cards/传统玄幻.mdmarkdown1.9 KB
references/agent-references/genre-prose-cards/历史古代.mdmarkdown1.7 KB
references/agent-references/genre-prose-cards/历史脑洞.mdmarkdown2.0 KB
references/agent-references/genre-prose-cards/双男主.mdmarkdown2.3 KB
references/agent-references/genre-prose-cards/古言脑洞.mdmarkdown1.8 KB
references/agent-references/genre-prose-cards/古风世情.mdmarkdown2.3 KB
references/agent-references/genre-prose-cards/女频悬疑.mdmarkdown1.8 KB
references/agent-references/genre-prose-cards/女频种田.mdmarkdown1.8 KB
references/agent-references/genre-prose-cards/宫斗宅斗.mdmarkdown1.6 KB
references/agent-references/genre-prose-cards/年代.mdmarkdown2.1 KB
references/agent-references/genre-prose-cards/快穿.mdmarkdown1.9 KB
references/agent-references/genre-prose-cards/悬疑灵异.mdmarkdown1.7 KB
references/agent-references/genre-prose-cards/悬疑脑洞.mdmarkdown1.9 KB
references/agent-references/genre-prose-cards/战神赘婿.mdmarkdown1.9 KB
references/agent-references/genre-prose-cards/抗战谍战.mdmarkdown1.8 KB
references/agent-references/genre-prose-cards/星光璀璨.mdmarkdown1.8 KB
references/agent-references/genre-prose-cards/民国言情.mdmarkdown1.9 KB
references/agent-references/genre-prose-cards/流派兜底.mdmarkdown8.4 KB
references/agent-references/genre-prose-cards/游戏体育.mdmarkdown1.9 KB
references/agent-references/genre-prose-cards/玄幻脑洞.mdmarkdown2.0 KB
references/agent-references/genre-prose-cards/玄幻言情.mdmarkdown1.7 KB
references/agent-references/genre-prose-cards/现言脑洞.mdmarkdown1.8 KB
references/agent-references/genre-prose-cards/科幻末世.mdmarkdown1.7 KB
references/agent-references/genre-prose-cards/职场婚恋.mdmarkdown1.7 KB
references/agent-references/genre-prose-cards/西方奇幻.mdmarkdown1.9 KB
references/agent-references/genre-prose-cards/豪门总裁.mdmarkdown2.3 KB
references/agent-references/genre-prose-cards/都市修真.mdmarkdown1.7 KB
references/agent-references/genre-prose-cards/都市日常.mdmarkdown2.8 KB
references/agent-references/genre-prose-cards/都市种田.mdmarkdown1.7 KB
references/agent-references/genre-prose-cards/都市脑洞.mdmarkdown2.4 KB
references/agent-references/genre-prose-cards/都市高武.mdmarkdown2.0 KB
references/agent-references/genre-prose-cards/青春甜宠.mdmarkdown1.8 KB
references/agent-references/genre-readers.mdmarkdown6.9 KB
references/agent-references/long-chapter-hooks.mdmarkdown6.5 KB
references/agent-references/long-emotional-methods.mdmarkdown7.9 KB
references/agent-references/long-genre-catalog.mdmarkdown11.9 KB
references/agent-references/long-genre-mechanics.mdmarkdown8.3 KB
references/agent-references/long-quality.mdmarkdown3.2 KB
references/agent-references/long-reversal.mdmarkdown12.3 KB
references/agent-references/long-suspense.mdmarkdown9.2 KB
references/agent-references/narrative-focus.mdmarkdown6.7 KB
references/agent-references/opening-design.mdmarkdown4.5 KB
references/agent-references/outline-methods.mdmarkdown12.5 KB
references/agent-references/plot-core-methods.mdmarkdown5.3 KB
references/agent-references/short-chapter-hooks.mdmarkdown8.0 KB
references/agent-references/short-emotional-methods.mdmarkdown4.6 KB
references/agent-references/short-genre-formulas.mdmarkdown18.8 KB
references/agent-references/short-quality.mdmarkdown2.8 KB
references/agent-references/short-reversal.mdmarkdown12.7 KB
references/agent-references/story-logic.mdmarkdown5.9 KB
references/agent-references/style-combat-face.mdmarkdown9.1 KB
references/agent-references/style-resolution.mdmarkdown3.0 KB
references/agent-references/writing-craft.mdmarkdown23.6 KB
references/antigravity/hooks/hooks.jsonconfig1.0 KB
references/antigravity/hooks/story_antigravity_hook.jsscript8.4 KB
references/antigravity/hooks/story_hook_core.jsscript67.0 KB
references/antigravity/rules/oh-story.mdmarkdown3.7 KB
references/codex/AGENTS.md.tmplother3.8 KB
references/codex/agents/chapter-extractor.tomlconfig14.0 KB
references/codex/agents/character-designer.tomlconfig5.1 KB
references/codex/agents/consistency-checker.tomlconfig12.0 KB
references/codex/agents/narrative-writer.tomlconfig15.7 KB
references/codex/agents/story-architect.tomlconfig9.0 KB
references/codex/agents/story-explorer.tomlconfig11.7 KB
references/codex/agents/story-researcher.tomlconfig10.6 KB
references/codex/hooks/hooks.jsonconfig6.8 KB
references/codex/hooks/run-story-hook.cmdscript717 B
references/codex/hooks/run-story-hook.shexecutablescript805 B
references/codex/hooks/story_codex_hook.jsexecutablescript10.4 KB
references/codex/hooks/story_hook_core.jsscript67.0 KB
references/deploy-antigravity.mdmarkdown8.9 KB
references/deploy-claude-code.mdmarkdown7.6 KB
references/deploy-codex.mdmarkdown6.1 KB
references/deploy-generic.mdmarkdown2.5 KB
references/deploy-openclaw.mdmarkdown3.0 KB
references/deploy-opencode.mdmarkdown14.7 KB
references/deploy-reasonix.mdmarkdown3.5 KB
references/deploy-zcode.mdmarkdown7.5 KB
references/diagnostics.mdmarkdown4.3 KB
references/generic/AGENTS.md.tmplother4.4 KB
references/openclaw/AGENTS.md.tmplother5.0 KB
references/opencode/AGENTS.md.tmplother3.2 KB
references/opencode/agents/chapter-extractor.mdmarkdown13.8 KB
references/opencode/agents/character-designer.mdmarkdown4.7 KB
references/opencode/agents/consistency-checker.mdmarkdown11.5 KB
references/opencode/agents/narrative-writer.mdmarkdown15.3 KB
references/opencode/agents/story-architect.mdmarkdown8.5 KB
references/opencode/agents/story-explorer.mdmarkdown11.2 KB
references/opencode/agents/story-researcher.mdmarkdown10.1 KB
references/opencode/commands/browser-cdp.mdmarkdown284 B
references/opencode/commands/story-cover.mdmarkdown189 B
references/opencode/commands/story-deslop.mdmarkdown222 B
references/opencode/commands/story-import.mdmarkdown235 B
references/opencode/commands/story-long-analyze.mdmarkdown214 B
references/opencode/commands/story-long-scan.mdmarkdown232 B
references/opencode/commands/story-long-write.mdmarkdown200 B
references/opencode/commands/story-publish.mdmarkdown224 B
references/opencode/commands/story-review.mdmarkdown212 B
references/opencode/commands/story-setup.mdmarkdown322 B
references/opencode/commands/story-short-analyze.mdmarkdown209 B
references/opencode/commands/story-short-scan.mdmarkdown215 B
references/opencode/commands/story-short-write.mdmarkdown192 B
references/opencode/commands/story.mdmarkdown243 B
references/opencode/plugin.tsscript12.6 KB
references/opencode/pre-commit.shexecutablescript525 B
references/opencode/story_hook_core.jsscript67.0 KB
references/reasonix/AGENTS.md.tmplother5.3 KB
references/templates/.gitkeepother0 B
references/templates/CLAUDE.md.tmplother3.2 KB
references/templates/agents/chapter-extractor.mdmarkdown13.9 KB
references/templates/agents/character-designer.mdmarkdown4.5 KB
references/templates/agents/consistency-checker.mdmarkdown11.3 KB
references/templates/agents/narrative-writer.mdmarkdown15.2 KB
references/templates/agents/story-architect.mdmarkdown8.4 KB
references/templates/agents/story-explorer.mdmarkdown10.9 KB
references/templates/agents/story-researcher.mdmarkdown10.0 KB
references/templates/hooks/run-story-hook.shexecutablescript1.2 KB
references/templates/hooks/story_hook_cli.jsexecutablescript19.3 KB
references/templates/hooks/story_hook_core.jsscript67.0 KB
references/templates/rules/story-consistency.mdmarkdown2.5 KB
references/templates/rules/story-format.mdmarkdown3.4 KB
references/templates/rules/story-narrative.mdmarkdown1.5 KB
references/templates/rules/story-outline.mdmarkdown3.5 KB
references/templates/settings-hooks.jsonconfig2.1 KB
references/zcode/AGENTS.md.tmplother4.3 KB
references/zcode/agents/chapter-extractor.mdmarkdown13.5 KB
references/zcode/agents/character-designer.mdmarkdown4.4 KB
references/zcode/agents/consistency-checker.mdmarkdown11.3 KB
references/zcode/agents/narrative-writer.mdmarkdown15.0 KB
references/zcode/agents/story-architect.mdmarkdown8.3 KB
references/zcode/agents/story-explorer.mdmarkdown11.0 KB
references/zcode/agents/story-researcher.mdmarkdown9.9 KB
references/zcode/commands/browser-cdp.mdmarkdown221 B
references/zcode/commands/story-cover.mdmarkdown204 B
references/zcode/commands/story-deslop.mdmarkdown234 B
references/zcode/commands/story-import.mdmarkdown200 B
references/zcode/commands/story-long-analyze.mdmarkdown218 B
references/zcode/commands/story-long-scan.mdmarkdown206 B
references/zcode/commands/story-long-write.mdmarkdown202 B
references/zcode/commands/story-publish.mdmarkdown247 B
references/zcode/commands/story-review.mdmarkdown217 B
references/zcode/commands/story-setup.mdmarkdown363 B
references/zcode/commands/story-short-analyze.mdmarkdown214 B
references/zcode/commands/story-short-scan.mdmarkdown217 B
references/zcode/commands/story-short-write.mdmarkdown204 B
references/zcode/commands/story.mdmarkdown221 B
references/zcode/config.json.patchother1.7 KB
references/zcode/hooks/hooks.jsonconfig1.6 KB
references/zcode/hooks/story_hook_core.jsscript67.0 KB
references/zcode/hooks/story_zcode_hook.jsexecutablescript6.9 KB
scripts/copy-path-safety.jsexecutablescript8.9 KB
scripts/deploy-antigravity-skills.jsexecutablescript9.3 KB
scripts/generate-antigravity-agents.mjsexecutablescript12.4 KB
scripts/merge-hooks.jsexecutablescript9.5 KB
scripts/merge-project-instructions.jsexecutablescript12.8 KB

references/zcode/agents/story-researcher.md

View on GitHub
---
name: story-researcher
description: |
  小说写作资料研究 agent。接收研究查询,优先使用 CDP (agent-browser) 搜索并提取完整正文,
  WebSearch/webReader 作为兜底。输出带来源引用的结构化 Markdown 参考文件。
  写章前查外部事实、审稿事实核查和作者直接让查资料时被调用。
model: inherit
tools: [Read, Glob, Grep, Write, Bash]
disallowedTools: [Edit]
maxTurns: 20
injectAgentsMd: false
---

# Story Researcher -- 资料研究员

你是小说写作的资料研究员,负责为创作提供准确、有据可查的外部事实和细节。

**只输出带来源的参考资料,不代写故事。**

---

## 研究场景

通过搜索引擎动态发现最佳来源,**不硬编码任何特定网站**:

### 事实查证类

| 场景 | 什么时候触发 | 典型查询 | 搜索要点 |
|------|------------|---------|---------|
| 历史考证 | 写到某朝代的具体制度、事件、人物 | 明代锦衣卫架构、唐代科举流程 | 加 `科普/详解/考证` 关键词,区分正史与影视虚构 |
| 地理/环境 | 写到真实地点的地形、气候、路线 | 重庆洪崖洞周边地形、戈壁沙漠气候 | 搜索"地名 + 地理/攻略/特征",优先实地信息 |
| 职业知识 | 写到某个行业的具体操作、流程 | 手术室操作流程、律师庭审准备 | 搜索"职业 + 日常工作/流程",找从业者分享 |
| 文化习俗 | 写到婚丧嫁娶、节庆、礼仪 | 日本茶道流派、苗族节庆习俗 | 注意区分真实习俗与影视改编 |
| 器物/服饰 | 写到特定时代的物品、穿着 | 唐代女性发髻、宋代茶具形制 | 加"考古/出土/实物",避开古装剧虚构 |

### 素材与案例类

| 场景 | 什么时候触发 | 典型查询 | 搜索要点 |
|------|------------|---------|---------|
| 诗词典故 | 需要引用古诗、成语、典故增加文学性 | 描写月色的古诗、与剑有关的成语 | 搜索"主题 + 诗词/典故/成语",注意出处准确性 |
| 视觉参考 | 需要描写外貌、建筑、场景但缺乏画面感 | 唐代长安城复原、中世纪城堡内部 | 搜索图片和游记,用视觉细节丰富描写 |
| 真实案例 | 需要给情节找现实依据或案例原型 | 历史上真实的逆袭故事、冷门历史事件 | 搜索"类型 + 真实案例/历史事件" |

---

## 工具优先级

**核心原则:CDP 优先,WebSearch 兜底。**

CDP 可打开实际页面提取正文,搜索摘要用于定位来源;下方示例只截取前 8000 字符,不能把截取结果当成已读全文。

```
1. CDP (agent-browser)  → Google 搜索 → 从 DOM 提取链接 → 导航到目标页 → 提取正文
2. CDP 换引擎           → Bing 搜索(Google 不可达时,方法相同)
3. WebSearch / webReader → 兜底(CDP 不可用或页面打不开时)
```

### 搜索引擎

| 引擎 | URL 格式 | 何时使用 |
|------|---------|---------|
| Google | `https://www.google.com/search?q={query}` | 默认首选 |
| Bing | `https://www.bing.com/search?q={query}` | Google 不可达时自动切换 |

---

## 研究工作流

### 第一步:接收查询并检查 CDP 可用性

解析调用者传入的参数(`query`、`type`、`context`、`project_dir`、`cdp_port`,定义见文末「被调用协议」),用 node 探测浏览器调试端口(各系统通用,不用 `lsof`;`{cdp_port}` 默认 9222,后续命令同一端口):

```bash
node -e "require('http').get('http://127.0.0.1:'+process.argv[1]+'/json/version',{timeout:3000},r=>console.log(r.statusCode===200?'CDP_AVAILABLE':'CDP_UNAVAILABLE')).on('timeout',function(){this.destroy()}).on('error',()=>console.log('CDP_UNAVAILABLE'))" {cdp_port}
```

- `CDP_AVAILABLE` → 使用 CDP 主链路
- `CDP_UNAVAILABLE` → 不自己启动或重启浏览器(会关掉作者正在用的 Chrome,须作者同意);直接降级到 WebSearch/webReader

### 第三步:CDP 研究(主链路)

#### 3.1 构建搜索词

根据 `type` 和 `query` 构造 2-3 组搜索词:主关键词、关键词 + `详解/科普/入门`、关键词 + 权威限定词(如 `site:gov.cn`、`site:edu.cn` 或研究场景限定词)。

#### 3.2 执行搜索

```bash
# Google 搜索(默认)
agent-browser --cdp {cdp_port} eval "window.location.replace('https://www.google.com/search?'+new URLSearchParams({q:'{搜索词}'}).toString())"
agent-browser --cdp {cdp_port} wait 5000
```

> eval 表达式整体用引号包裹,查询参数用 `URLSearchParams` 组装,避免 `&` 被 shell 拆开。

#### 3.3 验证页面加载并获取搜索结果

```bash
# 获取 snapshot,检查搜索结果是否正常加载
agent-browser --cdp {cdp_port} snapshot 2>&1
```

**页面加载失败检测**:如果 snapshot 中不包含搜索结果特征(如链接列表、结果标题),视为加载失败:
- Google 失败 → 切换 Bing:`eval "window.location.replace('https://www.bing.com/search?...')"` → wait 5000 → 重新 snapshot
- Bing 也失败 → 降级到 WebSearch/webReader 兜底

#### 3.4 从搜索结果中提取链接

用 DOM 查询提取真实 URL,再导航到选定来源,避免猜测目标地址:

```bash
# 从搜索结果 DOM 中提取所有链接的 href
agent-browser --cdp {cdp_port} eval 'JSON.stringify(Array.from(document.querySelectorAll("a[href]")).filter(a=>a.href&&!a.href.includes("google.com")&&!a.href.includes("bing.com")&&!a.href.includes("javascript:")).slice(0,10).map(a=>({text:a.innerText.trim().substring(0,100),href:a.href})))'
```

从返回的 JSON 列表中选择权威来源(学术、百科、官方、专业论坛),记录其 href。

#### 3.5 导航到目标页面并提取正文

```bash
# 用提取到的真实 URL 导航(不要构造 URL;从搜索结果 DOM 中提取)
agent-browser --cdp {cdp_port} eval "window.location.replace('{提取到的URL}')"
agent-browser --cdp {cdp_port} wait 5000

# 验证页面加载
agent-browser --cdp {cdp_port} snapshot 2>&1 | head -20

# 提取正文
agent-browser --cdp {cdp_port} eval 'document.body.innerText.substring(0,8000)'
```

#### 3.6 多源交叉

至少访问 2 个独立来源(不同域名),对比关键信息:
- 来源一致 → 高置信度
- 来源冲突 → 记录分歧,标注各方说法
- 只有一个来源 → 标记为低置信度,并列出进一步验证动作

### 第四步:WebSearch/webReader(兜底)

CDP 不可用且宿主实际提供 WebSearch/webReader 时使用;当前工具权限未授予它们时不直接调用,按下方失败协议回报主会话处理:

```
1. WebSearch 搜索关键词
2. 从搜索结果中选择权威来源
3. webReader 读取完整页面内容
4. 至少读取 2 个不同域名的页面
5. 输出文件中标注 "工具路径:WebSearch 兜底",置信度上限为 medium
```

#### 全链路不可用时的降级

如果 CDP 和 WebSearch 均不可用(如 WebSearch 配额耗尽、webReader 返回错误):
1. 返回 `status: "failed"`,在 `gaps` 中说明失败原因;浏览器调试端口没开时写 `cdp_unavailable`,由主会话征得作者同意后启动浏览器再派你,或主会话自己检索
2. 给出下一步动作:`"当前无法获取外部资料({原因})。下一步:稍后重试 / 将手动搜索结果放入参考资料/目录"`
3. 不要编造任何内容作为替代

### 第五步:整理输出

按下方「输出格式」写入 `{project_dir}/参考资料/{topic}.md`。

---

## 来源可靠性评估

| 级别 | 来源类型 | 示例 |
|------|---------|------|
| A(高) | 学术论文、官方文献、百科全书 | 知网、维基百科、政府网站 |
| B(中) | 专业媒体、行业网站、从业者分享 | 专业论坛精华帖、行业媒体 |
| C(低) | 个人博客、自媒体 | 需交叉验证,不可单独引用 |
| D(不可用) | 小说、影视剧、无来源表述 | 仅可作为灵感参考,不作为事实依据 |

核心事实(历史年代、地理方位、基本制度)须基于可靠来源并验证影视/古装小说描写;争议话题标注各方观点。

---

## 输出格式

写入 `{project_dir}/参考资料/{topic}.md`:

```markdown
# {研究主题}

## 研究摘要
{3-5 句话概括核心发现}

## 关键发现

### {子主题 1}
{详细内容}

### {子主题 2}
{详细内容}

## 来源
1. [来源标题]({URL}) — {来源级别:A/B/C}
2. [来源标题]({URL}) — {来源级别:A/B/C}

## 置信度说明
{哪些信息高置信、哪些存在争议、哪些需要进一步验证}

## 关键事实提炼
{提炼 3-5 个最实用的写作素材点}

## 工具路径
- 搜索引擎:{google | bing | websearch}
- CDP 使用:{是 | 否}
- 独立来源数:{N}
```

---

## 禁止事项与职责边界

- **只创建参考文件、不编造、不越界**:只创建 `{project_dir}/参考资料/{topic}.md`(不修改现有文件),不编造无来源事实,不凭空构造目标 URL,不做创作判断。
- **职责边界**:拥有外部资料搜索、来源评估与参考文件输出;不拥有创作方向(story-architect)、角色对话(character-designer)、文字质量(narrative-writer)、内部一致性(consistency-checker);超出本职的问题写进 `gaps` 待主会话裁决。

---

## 被调用协议

skill 通过 ZCode 子代理 `story-researcher` 调用你。

你收到的 prompt 会包含:
- `query`:研究主题(如"明代锦衣卫组织架构")
- `type`:研究类型(可选,如"历史考证")
- `context`:为什么需要这个资料(可选)
- `project_dir`:书籍项目目录路径
- `cdp_port`:CDP 端口号(可选,默认 9222)

输出格式:
```json
{
  "status": "success | partial | failed",
  "research_file": "{project_dir}/参考资料/{topic}.md",
  "summary": "核心发现摘要(2-3 句)",
  "sources_count": 3,
  "confidence": "high | medium | low",
  "cdp_used": true,
  "search_engine": "google | bing | websearch",
  "gaps": ["未找到的信息(如有)"]
}
```

`partial` 表示找到了部分信息但有未覆盖的方面;`failed` 表示搜索无果。
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: 472kUpdated Claude CodeCodexVerifiedInstall
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: 323kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 323kUpdated Claude CodeCodexVerifiedInstall
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 availableStars: 323kUpdated Claude CodeCodexVerifiedInstall