Skip to content

zjs105910/workbuddy-market / bundled/novel-writing-suite/skills/story-setup

story-setup

Flagged

网文写作工具集基础设施部署与检查。为 Claude Code / OpenCode / Codex / Google Antigravity / ZCode / OpenClaw / Reasonix 提供内置适配;Web AI / 通用 Agent 可走 skills + AGENTS.md 文件模式。触发方式:/story-setup、$story-setup、「准备写书」「帮我搭一下环境」「配置写作项目」「检查写作环境」。

FileKindSize
SKILL.mdskill md18.3 KB
UPGRADING.mdmarkdown33.9 KB
references/agent-references/agent-quality.mdmarkdown3.6 KB
references/agent-references/agent-reference-profiles.mdmarkdown3.9 KB
references/agent-references/anti-ai-writing.mdmarkdown36.3 KB
references/agent-references/banned-words.mdmarkdown10.2 KB
references/agent-references/benchmark-style-load.mdmarkdown9.9 KB
references/agent-references/character-basics.mdmarkdown16.5 KB
references/agent-references/character-design-methods.mdmarkdown15.9 KB
references/agent-references/character-relations.mdmarkdown17.4 KB
references/agent-references/deslop-gates.mdmarkdown14.1 KB
references/agent-references/dialogue-mastery.mdmarkdown11.5 KB
references/agent-references/emotion-on-page.mdmarkdown4.6 KB
references/agent-references/emotional-arc-design.mdmarkdown12.0 KB
references/agent-references/format-and-structure.mdmarkdown10.4 KB
references/agent-references/genre-prose-cards.mdmarkdown7.0 KB
references/agent-references/genre-prose-cards/东方仙侠.mdmarkdown2.7 KB
references/agent-references/genre-prose-cards/传统玄幻.mdmarkdown2.7 KB
references/agent-references/genre-prose-cards/历史古代.mdmarkdown2.6 KB
references/agent-references/genre-prose-cards/历史脑洞.mdmarkdown2.9 KB
references/agent-references/genre-prose-cards/双男主.mdmarkdown3.2 KB
references/agent-references/genre-prose-cards/古言脑洞.mdmarkdown2.6 KB
references/agent-references/genre-prose-cards/古风世情.mdmarkdown2.6 KB
references/agent-references/genre-prose-cards/女频悬疑.mdmarkdown2.6 KB
references/agent-references/genre-prose-cards/女频种田.mdmarkdown2.6 KB
references/agent-references/genre-prose-cards/宫斗宅斗.mdmarkdown2.5 KB
references/agent-references/genre-prose-cards/年代.mdmarkdown3.0 KB
references/agent-references/genre-prose-cards/快穿.mdmarkdown2.8 KB
references/agent-references/genre-prose-cards/悬疑灵异.mdmarkdown2.6 KB
references/agent-references/genre-prose-cards/悬疑脑洞.mdmarkdown2.7 KB
references/agent-references/genre-prose-cards/战神赘婿.mdmarkdown2.7 KB
references/agent-references/genre-prose-cards/抗战谍战.mdmarkdown2.7 KB
references/agent-references/genre-prose-cards/星光璀璨.mdmarkdown2.7 KB
references/agent-references/genre-prose-cards/民国言情.mdmarkdown2.8 KB
references/agent-references/genre-prose-cards/游戏体育.mdmarkdown2.8 KB
references/agent-references/genre-prose-cards/玄幻脑洞.mdmarkdown2.9 KB
references/agent-references/genre-prose-cards/玄幻言情.mdmarkdown2.5 KB
references/agent-references/genre-prose-cards/现言脑洞.mdmarkdown2.7 KB
references/agent-references/genre-prose-cards/科幻末世.mdmarkdown2.6 KB
references/agent-references/genre-prose-cards/职场婚恋.mdmarkdown2.6 KB
references/agent-references/genre-prose-cards/西方奇幻.mdmarkdown2.8 KB
references/agent-references/genre-prose-cards/豪门总裁.mdmarkdown3.3 KB
references/agent-references/genre-prose-cards/都市修真.mdmarkdown2.5 KB
references/agent-references/genre-prose-cards/都市日常.mdmarkdown3.7 KB
references/agent-references/genre-prose-cards/都市种田.mdmarkdown2.5 KB
references/agent-references/genre-prose-cards/都市脑洞.mdmarkdown3.4 KB
references/agent-references/genre-prose-cards/都市高武.mdmarkdown2.9 KB
references/agent-references/genre-prose-cards/青春甜宠.mdmarkdown2.7 KB
references/agent-references/genre-readers.mdmarkdown10.8 KB
references/agent-references/long-chapter-hooks.mdmarkdown8.6 KB
references/agent-references/long-emotional-methods.mdmarkdown10.1 KB
references/agent-references/long-genre-catalog.mdmarkdown17.0 KB
references/agent-references/long-genre-mechanics.mdmarkdown17.0 KB
references/agent-references/long-quality.mdmarkdown3.1 KB
references/agent-references/long-reversal.mdmarkdown15.2 KB
references/agent-references/long-suspense.mdmarkdown15.2 KB
references/agent-references/opening-design.mdmarkdown12.5 KB
references/agent-references/outline-conflict.mdmarkdown17.2 KB
references/agent-references/outline-methods.mdmarkdown10.6 KB
references/agent-references/outline-rhythm.mdmarkdown12.6 KB
references/agent-references/plot-core-methods.mdmarkdown19.8 KB
references/agent-references/short-chapter-hooks.mdmarkdown8.4 KB
references/agent-references/short-emotional-methods.mdmarkdown7.7 KB
references/agent-references/short-genre-formulas.mdmarkdown20.1 KB
references/agent-references/short-paragraph-hooks.mdmarkdown6.7 KB
references/agent-references/short-quality.mdmarkdown2.7 KB
references/agent-references/short-reversal.mdmarkdown16.3 KB
references/agent-references/short-suspense.mdmarkdown15.6 KB
references/agent-references/style-combat-face.mdmarkdown16.9 KB
references/agent-references/style-genre-modules.mdmarkdown24.2 KB
references/agent-references/style-resolution.mdmarkdown3.9 KB
references/agent-references/writing-craft.mdmarkdown28.1 KB
references/antigravity/hooks/hooks.jsonconfig994 B
references/antigravity/hooks/story_antigravity_hook.jsscript8.2 KB
references/antigravity/hooks/story_hook_core.jsscript57.3 KB
references/antigravity/rules/oh-story.mdmarkdown3.0 KB
references/codex/AGENTS.md.tmplother3.6 KB
references/codex/agents/chapter-extractor.tomlconfig16.5 KB
references/codex/agents/character-designer.tomlconfig9.7 KB
references/codex/agents/consistency-checker.tomlconfig12.2 KB
references/codex/agents/narrative-writer.tomlconfig15.5 KB
references/codex/agents/story-architect.tomlconfig11.1 KB
references/codex/agents/story-explorer.tomlconfig11.8 KB
references/codex/agents/story-researcher.tomlconfig12.7 KB
references/codex/hooks/hooks.jsonconfig6.8 KB
references/codex/hooks/run-story-hook.cmdscript699 B
references/codex/hooks/run-story-hook.shscript769 B
references/codex/hooks/story_codex_hook.pyscript71.9 KB
references/deploy-antigravity.mdmarkdown9.5 KB
references/deploy-claude-code.mdmarkdown8.3 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.3 KB
references/deploy-zcode.mdmarkdown6.7 KB
references/diagnostics.mdmarkdown4.4 KB
references/generic/AGENTS.md.tmplother4.2 KB
references/openclaw/AGENTS.md.tmplother4.7 KB
references/opencode/AGENTS.md.tmplother3.0 KB
references/opencode/agents/chapter-extractor.mdmarkdown16.4 KB
references/opencode/agents/character-designer.mdmarkdown9.3 KB
references/opencode/agents/consistency-checker.mdmarkdown11.7 KB
references/opencode/agents/narrative-writer.mdmarkdown15.0 KB
references/opencode/agents/story-architect.mdmarkdown10.6 KB
references/opencode/agents/story-explorer.mdmarkdown11.3 KB
references/opencode/agents/story-researcher.mdmarkdown12.2 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-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.tsscript8.0 KB
references/opencode/pre-commit.shscript4.3 KB
references/opencode/story_hook_core.jsscript57.3 KB
references/reasonix/AGENTS.md.tmplother5.0 KB
references/templates/.gitkeepother0 B
references/templates/CLAUDE.md.tmplother3.0 KB
references/templates/agents/chapter-extractor.mdmarkdown16.4 KB
references/templates/agents/character-designer.mdmarkdown9.1 KB
references/templates/agents/consistency-checker.mdmarkdown11.7 KB
references/templates/agents/narrative-writer.mdmarkdown15.0 KB
references/templates/agents/story-architect.mdmarkdown10.5 KB
references/templates/agents/story-explorer.mdmarkdown11.2 KB
references/templates/agents/story-researcher.mdmarkdown12.1 KB
references/templates/hooks/check-prose-after-write.shscript6.0 KB
references/templates/hooks/detect-story-gaps.shscript7.0 KB
references/templates/hooks/guard-outline-before-prose.shscript14.4 KB
references/templates/hooks/lib/common.shscript7.7 KB
references/templates/hooks/lib/sentinel.shscript1.5 KB
references/templates/hooks/post-compact.shscript698 B
references/templates/hooks/pre-compact.shscript1.0 KB
references/templates/hooks/session-end.shscript946 B
references/templates/hooks/session-start.shscript10.7 KB
references/templates/hooks/story_hook_cli.jsscript10.6 KB
references/templates/hooks/story_hook_core.jsscript57.3 KB
references/templates/hooks/validate-story-commit.shscript6.4 KB
references/templates/rules/story-consistency.mdmarkdown2.7 KB
references/templates/rules/story-format.mdmarkdown3.2 KB
references/templates/rules/story-narrative.mdmarkdown2.9 KB
references/templates/rules/story-outline.mdmarkdown6.3 KB
references/templates/settings-hooks.jsonconfig2.0 KB
references/zcode/AGENTS.md.tmplother4.0 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-review.mdmarkdown216 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.jsscript57.3 KB
references/zcode/hooks/story_zcode_hook.jsscript6.7 KB
scripts/copy-path-safety.pyscript3.1 KB
scripts/deploy-antigravity-skills.pyscript4.5 KB
scripts/generate-antigravity-agents.mjsscript12.1 KB
scripts/merge-antigravity-hooks.pyscript2.3 KB
scripts/merge-claude-settings.pyscript4.6 KB
scripts/merge-codex-hooks.pyscript5.2 KB

references/deploy-claude-code.md

View on GitHub
# Claude Code 部署

`target_cli` 含 `claude-code` 时,由 SKILL.md Phase 2 完整读取本文件并按顺序执行。路径安全检查、幂等重跑、清理自嵌套残留、部署标记、模板占位符和安装报告的写法在 SKILL.md,这里只写 Claude Code 专属部分。

## 部署清单(机械可检查)

| Source path | Target path | Owner class | Merge mode | Validation check |
|-------------|-------------|-------------|------------|------------------|
| `skills/story-setup/references/templates/CLAUDE.md.tmpl` | `CLAUDE.md` | user+managed | marker/section merge | contains story skill routing sections |
| `skills/story-setup/references/templates/hooks/` | `.claude/hooks/` | story-setup managed | recursive replace | `session-*.sh`, `detect-story-gaps.sh`, `validate-story-commit.sh`, `guard-outline-before-prose.sh`, `check-prose-after-write.sh`, `story_hook_core.js`, `story_hook_cli.js`, `lib/common.sh`, `lib/sentinel.sh` exist;`story_hook_core.js` 与 OpenCode/ZCode 副本字节一致 |
| `skills/story-setup/references/templates/rules/*.md` | `.claude/rules/*.md` | story-setup managed | replace | every rule contains `paths` frontmatter |
| `skills/story-setup/references/templates/agents/*.md` | `.claude/agents/*.md` | story-setup managed | replace | 7 agent files exist |
| `skills/story-setup/references/agent-references/*.md` | `.claude/skills/story-setup/references/agent-references/*.md` | story-setup managed | replace | every `story-setup/references/agent-references/*.md` reference resolves |
| `skills/story-setup/references/templates/settings-hooks.json` | `.claude/settings.local.json` | user+managed | replace managed registrations by stable hook identity | hook JSON valid;旧 matcher 注册已迁移、当前模板命令各一份、用户 hook 保留 |
| `skills/story-setup/scripts/merge-claude-settings.py` | 部署时执行,不复制到项目 | story-setup helper | execute | 替换已知 story hook 注册、保留用户 hooks/顶层字段,v24→v25 迁移与重复执行幂等 |
| `skills/story-setup/scripts/copy-path-safety.py` | 每个递归复制步骤前执行,不复制到项目专用目录 | story-setup helper | execute | JSON 仅 `copy_allowed: true` 时允许复制;symlink 同对象 no-op;target 位于 source 内时停止 |
| generated sentinel | `.story-deployed` | story-setup managed | replace | contains `agents_version`, `setup_skill_version`, `target_cli`, `resolver_strategy`, `references_dir` |

`references/templates/hooks/` 内容:8 个 hook 脚本模板 + `story_hook_core.js`(正文网/大纲守卫/连续性/commit 侦测的共享实现,与 OpenCode/ZCode 同一份)+ `story_hook_cli.js`(bash hook 调核的 node 桥)+ `lib/common.sh`/`lib/sentinel.sh`。正文兜底 `check-prose-after-write.sh` 限 PostToolUse Write/Edit;`cat>`/`tee` 等 Bash 写正文由 Codex Stop 回合末 git 扫描兜,Claude/OpenCode 的 Bash 仅 pre-guard。

## 部署 CLAUDE.md

- 读取 `skills/story-setup/references/templates/CLAUDE.md.tmpl`
- 替换占位符(见 SKILL.md「模板占位符」)
- 写入项目根目录 `CLAUDE.md`;已存在时按下面「CLAUDE.md 合并策略」处理

### CLAUDE.md 合并策略

用户已有 CLAUDE.md 时,按 marker/section 合并:
1. 优先识别 story-setup 管理块标记(如果旧项目已有标记,只替换标记内内容)
2. 无标记时,读取用户现有 CLAUDE.md,按 `##` 标题切分为 section map
3. 读取模板 CLAUDE.md.tmpl,同样切分
4. 模板中的标准 section(Skill 路由表、文件结构、协作规则、与作者协作、Compact 后恢复上下文;模板有而用户文件没有的 section 直接补入)**覆盖**用户同名 section
5. 用户独有的 section(自定义内容)**保留**不动
6. 未知冲突用 AskUserQuestion 让用户选择保留哪个版本

## 部署 Hooks

- **递归复制完整目录树**:将 `skills/story-setup/references/templates/hooks/` 复制到用户项目 `.claude/hooks/`
- 必须保留子目录 `lib/`,其中:
  - `lib/common.sh` 提供 `project_root`、`discover_active_book`、`discover_all_books`
  - `lib/sentinel.sh` 提供 `.story-deployed` 字段读取
- 只需对 `.claude/hooks/*.sh` 设置执行权限(`chmod +x`);`lib/*.sh` 由 hook `source`,不要求可执行位

## 部署 Rules

- 读取 `skills/story-setup/references/templates/rules/` 下所有 `.md` 文件
- 复制到用户项目的 `.claude/rules/` 目录

## 部署 Agents

- 读取 `skills/story-setup/references/templates/agents/` 下所有 `.md` 文件
- 复制到用户项目的 `.claude/agents/` 目录
- Agent 文件属于 story-setup 管理文件,可安全覆盖;版本升级时按 `UPGRADING.md` 的版本检测结果重新部署
- Agent 正文以这里的 Claude Code Markdown 为真源,其他宿主的 agent 都由它转换而来
- **部署后必须新开会话**:agent 只在会话启动时注册;报告文案见下方「安装报告必须提示」。

### 部署 Agent References

- 将 `skills/story-setup/references/agent-references/` 下所有 `.md` 复制到项目内 `.claude/skills/story-setup/references/agent-references/`
- 校验:凡 agent 或 reference 中出现 `story-setup/references/agent-references/<file>.md`,源包与目标包都必须存在 `<file>.md`
- 部署到项目后,agent 内引用的参考资料必须走 `story-setup/references/agent-references/*.md` 这一本 skill 内复制路径;不要跨 skill 引用其他 skill 的 references。Claude Code 只使用当前规范前缀 `.claude/skills/`,不在运行时遍历历史备选路径。

## 合并 Hooks 注册到 settings.local.json

先看 `.claude/settings.local.json` 是否存在:存在则读取现有配置,后续合并;不存在则由 helper 创建新文件。

1. 按现有跨平台规则探测 Python:`for PYBIN in python3 python py; do "$PYBIN" -c "" 2>/dev/null && break; done`;无可用解释器时停止,不手写或简化合并。
2. 调用 `"$PYBIN" "{story-setup skill目录}/scripts/merge-claude-settings.py" --existing "{项目}/.claude/settings.local.json" --template "{story-setup skill目录}/references/templates/settings-hooks.json" --output "{项目}/.claude/settings.local.json"`。
3. helper 会移除所有已知 story-setup hook 的历史注册,再追加当前模板;因此 matcher/timeout/if 能随版本升级,同时混在旧 block 中的用户 hook 与未知顶层字段原样保留。写后解析 JSON,验证模板命令各一份、用户配置仍在,再复跑 helper 比较文件字节确认幂等。

## 部署标记补充

- `references_dir` 写 `.claude/skills/story-setup/references/agent-references`(多端时与其他端逗号拼接)。
- 同时创建一次性标记文件 `.claude/.agents-pending-restart`(空文件即可)。session-start.sh 在下一个会话启动时据此确认 agents 已随新会话注册,并自动删除该标记——用来向用户确认「重启已生效」。

## 验证

1. 验证 hooks 注册:
   - 检查 `.claude/settings.local.json` 中的 hooks 字段是否正确
   - 检查 `.claude/hooks/` 下的脚本是否存在且有执行权限
   - 检查 `.claude/hooks/lib/common.sh` 与 `.claude/hooks/lib/sentinel.sh` 是否存在
2. 验证 rules 路径:
   - 检查 `.claude/rules/` 下的规则文件是否存在且包含 `paths` frontmatter
3. 验证 agents:
   - 检查 `.claude/agents/` 下的 7 个 agent 定义文件是否存在
4. 验证 agent reference bundle:
   - 检查 `.claude/skills/story-setup/references/agent-references/` 下 reference 文件完整
   - 检查所有 `story-setup/references/agent-references/<file>.md` 都能解析到 deployed bundle

## 安装报告必须提示

- **⚠️ 重启提示(必须醒目,放进「你还需要做的事」)**:本次部署写入了 `.claude/agents/`,但这些 custom agent 只在「会话启动」时才会被 Claude Code 注册成 `subagent_type`。**请新开一个 Claude Code 会话再开始写作**,否则当前会话里 story-review / story-long-write 等想 spawn `story-architect`、`narrative-writer` 等时会拿到「subagent_type 不可用」并降级 solo(单视角,失去多 agent 协作)。判断是否生效:新会话里跑 `/story-review`,报告开头「这次怎么审的」写着几个视角(完整审或精简审)即注册成功;若写着「我一个人审」说明还在旧会话或未注册。
- 重启后即可使用 `/story-long-write` 或 `/story-short-write`
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: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated 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: 322kUpdated Claude CodeCodexVerifiedInstall