StoryForge 写作框架

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install storyforge-writing
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 storyforge-writing。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

StoryForge Writing 是一个 Openclaw Skills 框架，将 StoryForge 数据契约、写作 SOP、上下文治理和证据规范整合为一套生产流程。它帮助智能体对请求分类、加载正确的产品契约、生成结构化创作成果，并引导作者完成审阅与采纳。
该技能支持长篇与短篇小说、剧本改编、角色档案、AVG 与互动小说、TTRPG 世界、漫画、动态剧前期制作以及后期制作提示词包。输出旨在与 StoryForge 目录保持一致，同时将 AI 生成内容保留为可审阅的候选内容，而不是悄然写入 Canon。

应用场景

生成结构化长篇或短篇小说，包含世界观、故事核心、角色、大纲、详细大纲和章节。
使用改编简报、节拍规划、场景卡、场景 AST、连续性检查和带版本的导出，将小说改编为剧本。
创建角色卡，包含对话风格、记忆、角色信息和受限知识领域。
设计 AVG、文字冒险或 TTRPG 内容，包含场景树、分支、对话、结局、物品、规则和状态机。
制作漫画脚本、页面与分格拆解，以及视觉主体卡。
准备动态剧材料，包括系列圣经、分集计划、故事板和 Image/Video Prompt IR。
创建世界引擎导出内容，包含 worldCode、WorldRelease 元数据、能力配置文件和可共享数据包。
续写现有分集或章节，同时核查上一时间戳、场景快照、角色状态和可能的画面重复。
为已有 Markdown 设定和知识证据库的项目生成可导入 StoryForge 的框架数据。

工作原理

按产品类型对请求分类，并路由至相关的 A、B 或 C 契约，例如长篇写作、互动内容、漫画、动态剧或后期制作。
核实项目范围和授权，包括项目是否在允许列表中，以及是否提供世界或作品引用。
通过受治理的上下文流程读取项目 Markdown 设定和 knowledge/ 证据库，而非依赖记忆或固定前缀搜索。
组装 Context Manifest，记录所选来源、修订、哈希、token 预算、遗漏和证据缺口，并区分 missing、omitted 和 partial-selection 状态。
生成内容前，确定目标字段、所有者、范围、修订版本和当前 schema。
执行写作 SOP：保留用户输入，选择 create、expand、rewrite 或 polish，并生成持久的 CreativeArtifact 候选内容。
展示候选内容及其支持性运行证据，供作者编辑、拒绝或批准。
采纳前执行过期验证和 adopt() 检查，核查字段、schema、外键、所有者、范围和来源变更。
成果获采纳后，更新连续性索引、事实、伏笔、时间线、角色状态和下游引用。
交付或由用户主导导入前，验证框架 JSON、sidecar 来源信息、证据等级、契约版本和一致性检查。

配置指南

该技能不需要二进制文件、环境变量、凭据、浏览器自动化或 API 密钥。它面向使用现有项目结构的 Openclaw 兼容智能体。
放置或访问包含 Markdown 设定和 knowledge/ 证据库的项目目录。
确保 StoryForge 契约文件可用，尤其是 contracts/S-data-envelope.md 以及适用的 A、B 或 C 产品契约。
确认项目使用经过审计的 StoryForge 数据契约基线；若源文件冲突，则暂停并请用户澄清。
在项目目录下生成输出，通常为 projects/
/storyforge-framework.json 及其 provenance sidecar。
交付前运行一致性验证器：
python scripts/check_consistency.py
确认验证器报告零失败，并由用户在 StoryForge ／long 工作库中执行导入。智能体不会操作浏览器 IndexedDB，也不会代用户执行导入。
当前技能版本为 0.2.1。源技能未指定单独的软件包安装命令；配置由项目契约、Markdown 资源、知识来源和 schema 基线决定。
StoryForge 写作框架 数据架构与分类体系
核心成果文件
文件 用途
projects/
/storyforge-framework.json 可导入的框架 JSON，仅包含精确的契约字段集。
projects/
/storyforge-framework.provenance.json 为每个生成区块提供来源信息和证据元数据的 sidecar。
Context Manifest 运行时记录所选来源、哈希、修订、token 估算、遗漏和缺失证据。
ProductSourceManifest 记录特定制作或发布所用来源的产品级清单。
WorldRelease 不可变的世界引用，包含代码、版本、哈希和能力信息。
所有权层级
projectId 标识工作区外壳以及当前世界或作品指针。
worldId 或 worldGroupId 标识世界范围及其发布边界。
workId 标识独立创作作品。
产品实例、制作、构建、发布和会话保存执行专属状态。
项目记录不得重复 World 或 Work 的语义，导入也不得复活已废弃的 Project 对象。
长篇 schema 范围
范围 代表性记录和字段
作品与设定 works：id、projectId、worldId、code、status、activeNarrativeModuleId；worldviews：id、projectId
故事设计 storyCores、powerSystems、storyArcs、outlineNodes、chapters、detailedOutlines
角色 characters，含姓名、角色权重、道德轴、秩序轴和状态证据；characterRelations 用于有向关系
连续性 foreshadows、stateCards、storyTimelineEvents、emotionBeatCards 和 narrativeSummaryNodes
知识与编年录 codexCategories、codexEntries、temporalFacts、knowledgeLedger 和 itemLedger
治理元数据
每个上下文来源都应标明稳定键、所有者、允许范围、修订或版本来源、预算类别、加载器和可见性。
每个被采纳字段都必须通过字段身份、schema、外键、所有者、范围和过期状态验证。
证据等级为 OBSERVED、INFERRED 或 UNKNOWN；无依据的主张必须保持为 UNKNOWN 或留空。
来源记录逐区块标明源 Markdown 文件、修订版本和内容哈希。
基于世界的制作遵循 S1 世界归档、S2 产品方向和 S3 产品执行。产品执行读取冻结的 WorldRelease，不会将运行结果写回世界引擎。
候选内容与 Canon 分离，直至作者明确批准采纳。

高级特性

在长篇、角色、互动、漫画、动态剧、剧本、世界引擎和后期制作工作流之间进行契约路由。
Context Gateway 支持来源清单、token 预算保护、修订跟踪、哈希和明确的证据缺口状态。
CreativeArtifact
候选内容和
adopt()
验证实现人在环路的采纳，而非直接写入数据库。
当目标字段或来源上下文变更时拒绝过期候选，避免静默重新生成或采纳过时内容。
OBSERVED
、
INFERRED
UNKNOWN
来源等级及可审计推理链，支持证据感知写作。
通过不可变的 WorldRelease 代码、版本、哈希和能力配置文件冻结世界引用。
对时间戳、场景快照、角色状况、时间推进和重复视觉场景进行连续性约束。
结构化支持场景卡 AST、分支叙事状态机、漫画分格、故事板计划和提示词中间表示。
明确区分创意数据生成与 StoryForge 运行时、构建、发布、会话或浏览器 IndexedDB 操作。
跨产品数据生命周期治理涵盖所有权、导入/导出、删除、迁移、引用、可空关系、外部 blob、冻结版本和会话保留。
scripts/check_consistency.py
自动验证一致性；源技能记录了 13 项断言。

name: storyforge-writing description: >- StoryForge 叙事写作框架（蒸馏自 github.com/yuanbw2025/storyforge 数据契约 + 写作 SOP）。
用于生成框架性语料并受控写作：长篇/短篇/AVG/文字冒险/角色人设/跑团世界（A 类）、
漫画分镜/漫剧 prompt 包（B 类）、漫剧后期对接生成管线（C 类）。
使用场景（含「小说转剧本/剧本改编」「世界封存/世界引擎/世界出口包」「生成可导入语料」）：用户要求"按 StoryForge 框架写长篇/短篇/剧本/漫画/漫剧/AVG/跑团"、
"生成框架语料"、"按写作 SOP 推进"、"对齐 StoryForge 数据契约"。
version: 0.2.1
license: MIT
compatibility: >-
电影大师 agent 专属 H 类知识资产。依赖 projects// 已有 md 设定资产与
knowledge/ 考据库。产物为 JSON 框架语料（可导入 StoryForge /long 作品库）+
结构化 md。不操作浏览器 IndexedDB，导入动作由用户执行。