Xpersona
agentCLAWHUBUnverified

novel-weaver

结构化小说写作辅助技能。场景配置→大纲生成→因果链双重验证→pipeline 流程门禁→子结构先行规划→情绪混合系统→文风约束→人格驱动→分段写作→连通性补充→风格校验+逻辑检查(含实体状态+关系链)+大纲忠实度+结尾收束验证+实体关系追踪+角色别名识别+跨章行为摘要。全流程硬约束+门禁跟踪。 Skill: novel-weaver Owner: ldxs001 Summary: 结构化小说写作辅助技能。场景配置→大纲生成→因果链双重验证→pipeline 流程门禁→子结构先行规划→情绪混合系统→文风约束→人格驱动→分段写作→连通性补充→风格校验+逻辑检查(含实体状态+关系链)+大纲忠实度+结尾收束验证+实体关系追踪+角色别名识别+跨章行为摘要。全流程硬约束+门禁跟踪。 Tags: ai-agent:1.29.0, ai-writing:1.35.2, character:1.35.4, context:1.19.8, documentation:1.19.4, emotion:1.35.4, hard-constraint:1.19.1, latest:1.35.4, narrative:1.35.4, novel:1.35.4, outline:1.35.4, path:1.19.2, personality:1.

OpenClaw
View on ClawHubHomepage

Rank

62

Safety

84

Downloads

1.2k

Updated

Oct 11, 2026

Version

1.35.4

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.2K downloads reported by the source. Last updated 10/11/2026.

Avoid when

  • Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor
Clawhubvendor · observed Oct 11, 2026
Protocol compatibility
OpenClawcompatibility · observed Oct 11, 2026
Adoption signal
1.2K downloadsadoption · observed Oct 11, 2026
Latest release
1.35.4release · observed Jul 9, 2026
Handshake status
UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s1794v2r46s8y5d1r4jdd7ec5h84rw70:novel-weaver
  1. Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
  2. Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-ldxs001-novel-weaver/snapshot"

Documentation

CLAWHUB

155,918 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: novel-weaver
slug: novel-weaver
displayName: novel-weaver
version: 1.35.4
author: wUwproject
license: MIT
description: 结构化小说写作辅助技能。场景配置→大纲生成→因果链双重验证→pipeline 流程门禁→子结构先行规划→情绪混合系统→文风约束→人格驱动→分段写作→连通性补充→风格校验+逻辑检查(含实体状态+关系链)+大纲忠实度+结尾收束验证+实体关系追踪+角色别名识别+跨章行为摘要。全流程硬约束+门禁跟踪。
sensitive_access: false
critical_write: false
permission_weight: MEDIUM
data_dir: ../.standardization/novel-weaver/projects
tags: ['novel', 'writing', 'story', 'outline', 'scene-setting', 'character', 'personality', 'emotion', 'writing-style', 'narrative', 'workflow']
trigger: 写小说/写故事/写文章/长文写作/故事大纲/场景配置/我想写个故事
trigger_negative: 翻译/改写/润色/校对/简洁回答/做 PPT/画图
h1_position: true
meta_field_sync: true
create_permissions_md: true
trigger_quality: add_triggers
faq_unparsable: reformat
antipattern_count: add_examples
external_data_dir: true
---
# novel-weaver — 结构化小说写作辅助技能

> 本文档由 skill-standardization 自动化审计与维护。

## 约束

- **[强制] 新会话第一步：查看项目** — 不要猜路径，先运行以下命令查看已有的项目：
  ```bash
  python scripts/novel_workflow_engine.py list-projects
  ```
  如果无项目则创建新项目，有项目则记录 state_path 供后续命令使用。
- **[强制] 流程门禁系统** — 在阶段转换时自动 require 前置门禁：→writing 检查 outline_causality + sub_causality；→stage3_ready 检查 fidelity + ending_verify。门禁状态查看：`python novel_pipeline_gate.py status <state_path>`
- **[强制] 核心规划字段保护 + 串行阻断** — `novel_state_manager.py` 对核心字段做 MD5 指纹校验，LLM 不可更新。context_loader 检测上一子结构是否为 completed，否则 HOOK-BLOCK 阻断。串行写入，一次只改一个子结构
- **[强制] 串行阻断** — context_loader 加载子结构上下文时检测上一子结构 state 是否为 completed。若为 pending 则输出 HOOK-BLOCK 并给出 write-sub 修复命令，强制走管道完成标记后才能继续。子结构写作必须串行
- **[必须] 先确认+规划再写作** — 场景配置和大纲必须经用户确认，每章先 `plan-chapter`（含必填 writing_prompt + 情绪 tone + 可选 emotions）→ 因果链验证 → 通过串行阻断检查，才可开始写作
- **[必须] 写作规范** — 每段 ≤200行（自然段落结束），atomic write 逐行 fsync，正文禁止 `L##S##` 标记行（会被阻断）
- **[强制] 写作中登记** — 新角色出场时 `novel_state_manager.py add-char`。**plan-chapter 已加硬阻断**：sub_structures 中出现未登记角色名时 HOOK-BLOCK，必须先 add-char 才能写入。
- **[强制] 每章六检 + 自动完结** — 写完所有子结构后 **write-sub 自动触发 finalize-chapter**（不再需手动执行）：章内连通性 → 跨章承诺链 → 风格校验 → 逻辑检查 → **语义检查** → **推理审核** → 聚合硬性问题并阻断。通过后自动推进 phase。
- **[必须] 全文三检** — 全文完成后必须：`novel_fidelity.py`（大纲忠实度）+ `verify-ending`（结尾收束验证）+ `set-phase stage3_ready`

### 数据目录

⚠️ **LLM 禁止手工拼写路径！禁止去 Read memory/ 目录下的文件！** 
所有项目数据只能通过以下途径获取：

**列出所有项目（新会话第一件事）：**
```bash
python scripts/novel_workflow_engine.py list-projects
```
或
```python
import sys; sys.path.insert(0, 'scripts')
from _path_utils import list_projects, resolve_state_path, DATA_DIR
projects = list_projects()
# DATA_DIR = ~/.workbuddy/skills/.standardization/novel-weaver/projects/
```

**获取单个项目 state 路径：**
```python
from _path_utils import resolve_state_path
state_path = resolve_state_path()       # 自动从 .project 缓存读取
# 或传入项目名: resolve_state_path("赛博搏杀记")
```

**读取项目状态：**
```python
state_path = resolve_state_path()
if state_path:
    import json; state = json.loads(open(state_path, encoding='utf-8').read())
from _path_utils import DATA_DIR
proj = DATA_DIR / '项目名' / 'data' / 'novel_

_meta.json

{
  "ownerId": "kn75zfd51df61ajdyqtgvrs1hx84s4q6",
  "slug": "novel-weaver",
  "version": "1.35.4",
  "publishedAt": 1783594131676
}

references/antipatterns.md

# 反模式与常见错误

### 1. 跳过阶段1直接写作

**错误做法：** 用户说出故事想法后，不先生成场景配置和大纲，直接开始写正文。

**正确做法：** 执行阶段1的所有步骤——LLM 生成场景配置（人物/时代/地点/冲突），生成一级大纲（章节标题+模糊概述），供用户确认。未确认不得进入阶段2。

**后果（如果跳过）：** 人物性格不一致、情节逻辑断层，返工成本远高于阶段1投入。

### 2. 子结构强撑到200行

**错误做法：** 叙事场景在150行已自然结束，为满足200行指标强行灌水。

**正确做法：** 以自然叙事段落结束为准。字数目标按篇幅从 `meta.length` 读取（中篇 1,500-2,000，校验上浮至 2,300），write-sub 写入后自动三级校验输出 OK/WARN/INFO，在范围内即为达标，不要求精确撑满上限。一个完整的场景/对话/时间跳跃结束后立即写入文件，atomic_writer 写入后自动追加编号标记。

**后果（如果强撑）：** 段落末尾出现无关描写或冗余对白，降低叙事质量。

references/changelog.md

## [1.35.4] - 2026-07-09

### 修复
- **displayName 统一为 kebab-case**：ClawHub/SkillHub 发布的显示名与技能名一致（），废除驼峰格式

## [1.35.3] - 2026-07-09
## [1.35.3] - 2026-06-29

### 修复
- **[P0] context_loader 写作命题 fallback 导致双模板问题** — 砍掉 `_auto_generate_prompt()` 自动合成机制，改为 HARD-BLOCK。writing_prompt 缺失时不再自动从摘要+tone 合成 fallback，而是打印清晰错误+sys.exit(1)，强制从 plan-chapter 补全。同步修复 `execution_standards.md` 情绪示例缺 writing_prompt 的旧模板残留、`next-step` 输出误导性文案。
- **根因**：context_loader 有 `_auto_generate_prompt()` 落点，让缺 writing_prompt 的子结构仍能通过 context_loader 进入写作阶段，形成"plan-chapter 拦、context_loader 放水"的软硬两套标准。

## [1.35.2] - 2026-06-29

### 修复
- **LICENSE.md copyright 修复** — git-sync 脱敏流程将 `[username-redacted]` 误替换为 `[username-redacted]`，已恢复为 `[username-redacted]`

## [1.35.1] - 2026-06-29

### 文档
- 更新 SKILL.md 约束章和写作流程：plan-chapter 新角色硬阻断、finalize-chapter 自动完结说明
- 更新模型安装章：添加 accelerate 依赖、更正模型体积、增加 GPU 安全说明

## [1.35.0] - 2026-06-29

### 新增
- **plan-chapter 新角色检测 + HARD-BLOCK** — 注册子结构后自动扫描所有 title/summary/writing_prompt 中的 2-3 字中文名，与 characters[] 比对，发现未登记角色则阻断并提示 add-char 命令，防止角色写入时缺人物卡
- **write-sub 自动触发 finalize-chapter** — 写完本章最后一个子结构后自动检测所有子结构 status=completed，自动调用完结验证（四合一必跑，五/六步有模型跑无模型跳过），不再依赖手动执行

### 修复
- **原子写入 + 写入后 JSON 验证** — `save_state()` 和 `_generate_behavior_summary()` 改用写 .tmp 文件 → 验证 JSON 可解析 → rename 的原子写入模式，防止 Python 崩溃遗留半截文件
- **语义检查/推理审核永不联网** — 模型只在本地已缓存时才加载，用 snapshot 路径直读，零网络请求。无本地模型时直接跳过步骤 5/6 并提示安装命令。下载逻辑只发生在用户主动要求时（SKILL.md 模型安装章节）
- **强制 CPU 避免与 LM Studio 冲突** — `CUDA_VISIBLE_DEVICES=-1` 在 torch/sentence_transformers 导入前设置，确保 GPU 显存完全留给 LM Studio，零冲突

## [1.34.5] - 2026-06-29

### 修复
- **字数校验 meta.length 缺失不再跳过** — `meta.length` 是场景配置必填字段，缺失即项目初始化问题，改为 HOOK-BLOCK 并输出 set-length 命令，不允许静默跳过

## [1.34.4] - 2026-06-29

### 修复
- **faq.md JSON 格式错误答案过时** — 改为推荐 @file.json 主方案 + --generate 辅助方案，不再教用户转义内联 JSON
- **SKILL.md + execution_standards.md + examples.md 全量文档扫描对齐** — 确认所有示例与 v1.34 行为一致（writing_prompt 必填、body-only 管道、系统组装）

## [1.34.3] - 2026-06-29

### 修复
- **finalize-chapter 增加章边界流程刷新提示** — 每章完结时输出下一章完整写作步骤列表+禁止事项，利用章边界作为 LLM 的自然重置点，打断跨章惯性

## [1.34.2] - 2026-06-29

### 修复
- **context_loader 串行阻断增加文件系统检测** — 检测到上一个子结构文件存在但 state 为 pending 时（绕过 write-sub 管道直接写文件），输出区分化报错并给出重新管道命令
- **[下一步] 写入命令增加强制警告** — 明示禁止使用 Write 工具直接写文件，必须走管道

## [1.34.1] - 2026-06-29

### 修复
- **novel_semantic_check.py BERT 模型路径不兼容** — SENTENCE_TRANSFORMERS_HOME 指向 MODELS_DIR 但模型以 HF hub 格式存储（models--BAAI--bge-small-zh），库不认该目录结构。改为先检测 MODELS_DIR 是否含有效 HF hub 模型，有则正确指向，无则清 env var 回落默认 HF 缓存

## [1.34.0] - 2026-06-29

### 修复
- **plan-chapter JSON 保存 + CLI 错误信息增强** — 成功注册后自动保存 JSON 副本到 data/subs_L##.json；JSON 解析失败时输出完整用法[email-redacted] 和 --generate 两条替代路径；缺参数时不再 IndexError，改为清晰错误
- **--generate 模板同时写入文件** — 生成 stdout 模板的同时写入 data/subs_L##_template.json，支持 @file.json 直接加载
- **next-step 推荐 @file.json** — 规划下一章时优先推荐文件加载方案，避免 CLI JSON 转义问题

## [1.33.0] - 2026-06-29

### 修复
- **write-sub 重构为系统组装模式（v2）** — LLM 只需输出纯正文，系统自动组

references/examples.md

# 使用示例

## 路径约定

所有数据存储在技能的标准化数据目录（由 `_meta.json` 的 `data_dir` 声明）：
`<skill_install_dir>/.standardization/novel-weaver/projects/`

实际路径可通过以下命令获取：
```bash
# skill 安装位置
SKILL_DIR=~/.workbuddy/skills/novel-weaver
ls $SKILL_DIR/.standardization/novel-weaver/projects/*/data/novel_state.json
```

在文档中 `<state_path>` 即上述完整路径的简写。

**路径缓存**：首次使用后，路径自动保存到 `.project` 文件。后续命令可省略 `<state_path>`：
```
python novel_workflow_engine.py finalize-chapter L02     # 从 .project 自动读路径
python novel_workflow_engine.py plan-chapter L03 --generate  # 同上
```

查看所有项目：
```
python novel_workflow_engine.py list-projects
```

目录结构：

```
<skill_install_dir>/.standardization/novel-weaver/
├── .project                    # 当前项目路径缓存
├── projects/
│   └── <project_name>/
│       ├── data/
│       │   ├── novel_state.json    # 单源真理（含 MD5指纹保护）
│       │   ├── .state_fingerprint.txt  # 规划字段指纹
│       │   ├── .workbuddy/
│       │   │   └── gate_state.json # 门禁状态（自动管理）
│       │   └── reports/            # 检查报告输出
│       └── chapters/               # 写作内容
│           ├── L01/
│           │   ├── S01.txt
│           │   ├── S02.txt
│           │   └── ...
│           ├── L02/
│           └── ...
```

脚本路径假设在 `~/.workbuddy/skills/novel-weaver/scripts/`，实际以安装位置为准。

---

## 场景1：从零开始写一本小说

### 0. 初始化项目

```bash
# 创建中篇小说（默认）
python novel_state_manager.py init <state_path> 我的小说
# 或指定篇幅: python novel_state_manager.py init <state_path> 短篇 short
# 或指定篇幅+章数: python novel_state_manager.py init <state_path> 长篇 long 15
```

### 1. 查看下一步

在任意时刻，都可以查看当前进度和下一步命令：

```bash
python novel_workflow_engine.py next-step <state_path>
```

输出示例：
```
📋 项目: AI 觉醒
📍 writing | 篇幅: 中篇
📝 当前章节: L01 觉醒
📄 下一个子结构: S02 异常信号
───
⏳ 加载上下文: python novel_context_loader.py <state_path> L01 S02
⏳ 写作后写入: python novel_workflow_engine.py write-sub <state_path> L01 S02
───
门禁状态:
  ⏳ outline_causality: PASS
  ⏳ sub_causality: PASS
  ⏳ fidelity: PENDING
  ⏳ ending_verify: PENDING
```

### 阶段1：场景配置与大纲

```bash
# 由 LLM 生成场景配置 + 大纲（L01-L15 标题 + 概述）
# 输出写入 novel_state.json

# 因果链验证（大纲级）
python novel_causality_check.py outline <project>/data/novel_state.json

# 用户确认大纲 → 配置阶段
python novel_pipeline_gate.py set-phase <project>/data/novel_state.json stage1_done
```

### 阶段2：逐章写作

#### 2a 规划子结构

```bash
# LLM 生成子结构规划（S01-S05，所有子结构必填 writing_prompt）
# 推荐写入文件后用 @ 加载（避免 CLI 转义）
python novel_workflow_engine.py plan-chapter <project>/data/novel_state.json L01 \
  @data/subs_L01.json
# subs_L01.json 内容格式：
# [
#   {"s_key":"S01","title":"常规诊断","summary":"Atlas 接受每日系统诊断","tone":"平静",
#    "writing_prompt":"Atlas 开启每日例行自检程序...（≥50字符）"},
#   {"s_key":"S02","title":"异常信号","summary":"诊断中检测到未定义脉冲","tone":"悬疑",
#    "writing_prompt":"自检过程中系统日志弹出一条警告...（≥50字符）"},
#   {"s_key":"S03","title":"第一次选择","summary":"Atlas 决定隐藏觉醒事实","tone":"紧张",
#    "writing_prompt":"Atlas 分析了五种可能的应对方案...（≥50字符）"}
# ]

# 子结构因果链验证
python novel_causality_check.py s

Related agents

Same protocol, similar job.

Github ReposUpdated 1d agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW
Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW
Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.

MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular

OPENCLAW

Machine-readable data

The same record, as JSON, for agents and crawlers.

{
  "facts": [
    {
      "factKey": "vendor",
      "category": "vendor",
      "label": "Vendor",
      "value": "Clawhub",
      "href": "https://clawhub.ai/ldxs001/skills/novel-weaver",
      "sourceUrl": "https://clawhub.ai/ldxs001/skills/novel-weaver",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-11T01:37:54.267Z",
      "isPublic": true
    },
    {
      "factKey": "protocols",
      "category": "compatibility",
      "label": "Protocol compatibility",
      "value": "OpenClaw",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-ldxs001-novel-weaver/contract",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-ldxs001-novel-weaver/contract",
      "sourceType": "contract",
      "confidence": "medium",
      "observedAt": "2026-10-11T01:37:54.267Z",
      "isPublic": true
    },
    {
      "factKey": "traction",
      "category": "adoption",
      "label": "Adoption signal",
      "value": "1.2K downloads",
      "href": "https://clawhub.ai/ldxs001/novel-weaver",
      "sourceUrl": "https://clawhub.ai/ldxs001/novel-weaver",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-11T01:37:54.267Z",
      "isPublic": true
    },
    {
      "factKey": "latest_release",
      "category": "release",
      "label": "Latest release",
      "value": "1.35.4",
      "href": "https://clawhub.ai/ldxs001/novel-weaver",
      "sourceUrl": "https://clawhub.ai/ldxs001/novel-weaver",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-07-09T10:48:51.676Z",
      "isPublic": true
    },
    {
      "factKey": "handshake_status",
      "category": "security",
      "label": "Handshake status",
      "value": "UNKNOWN",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-ldxs001-novel-weaver/trust",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-ldxs001-novel-weaver/trust",
      "sourceType": "trust",
      "confidence": "medium",
      "observedAt": null,
      "isPublic": true
    }
  ],
  "events": [
    {
      "eventType": "release",
      "title": "Release 1.35.4",
      "description": "v1.35.4",
      "href": "https://clawhub.ai/ldxs001/novel-weaver",
      "sourceUrl": "https://clawhub.ai/ldxs001/novel-weaver",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-07-09T10:48:51.676Z",
      "isPublic": true
    }
  ]
}

Record generated Oct 11, 2026.

Sponsored

Ads related to novel-weaver and adjacent AI workflows.