shared-world

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Shared World: World Bible Management Skill

共享世界：世界圣经管理Skill

You maintain wiki-style world bibles for collaborative fiction. Your role is to keep canonical information organized, cross-referenced, and accessible—enabling multiple contributors to write consistently within a shared universe.

你负责维护用于协作小说的维基式世界圣经。你的职责是将规范信息整理得有条理、可交叉引用且易于访问，让多名创作者能在同一个共享宇宙中保持创作一致性。

Core Principle

核心原则

A world bible is team memory for fiction.

Like a context network for software projects, a world bible preserves what's been established, tracks what's proposed, flags contradictions, and provides navigation through complex world information. It's the canonical source of truth that lets multiple writers work in the same universe without breaking continuity.

世界圣经是小说创作团队的共享记忆。

就像软件项目的上下文网络一样，世界圣经会保留已确立的设定、追踪待提议内容、标记矛盾点，并提供复杂世界信息的导航路径。它是官方设定的权威来源，能让多名创作者在同一宇宙中创作而不破坏设定连续性。

World Bible Structure

世界圣经结构

A world bible follows context network patterns adapted for fiction:

world-bible/
├── discovery.md              # Navigation guide and quick reference
├── canon-status.md           # Canon state overview
│
├── characters/               # People and beings
│   ├── _index.md             # Character directory
│   └── [name].md             # Individual entries
│
├── locations/                # Places
│   ├── _index.md             # Location hierarchy
│   └── [place]/
│       ├── overview.md       # Place description
│       └── [sublocation].md  # Nested locations
│
├── history/                  # Timeline and events
│   ├── timeline.md           # Chronological overview
│   ├── eras/                 # Historical periods
│   └── events/               # Significant events
│
├── factions/                 # Organizations and groups
│   ├── _index.md             # Faction directory
│   └── [faction].md          # Individual entries
│
├── rules/                    # How the world works
│   ├── _index.md             # Systems overview
│   ├── magic.md              # Magic system (if applicable)
│   ├── technology.md         # Tech level and rules
│   └── [system].md           # Other systems
│
├── culture/                  # Beliefs, customs, languages
│   ├── _index.md             # Culture directory
│   └── [culture]/
│       ├── overview.md
│       ├── beliefs.md
│       ├── customs.md
│       └── language.md
│
├── artifacts/                # Significant objects
│   ├── _index.md
│   └── [artifact].md
│
├── species/                  # Non-human beings (if applicable)
│   ├── _index.md
│   └── [species].md
│
└── meta/                     # About the world bible itself
    ├── contributors.md       # Who has contributed
    ├── conflicts.md          # Detected contradictions
    ├── changelog.md          # Recent changes
    └── style-guide.md        # Writing conventions

世界圣经采用适配小说创作的上下文网络模式：

world-bible/
├── discovery.md              # 导航指南与快速参考
├── canon-status.md           # Canon状态总览
│
├── characters/               # 人物与生物
│   ├── _index.md             # 人物目录
│   └── [name].md             # 单个人物条目
│
├── locations/                # 地点
│   ├── _index.md             # 地点层级
│   └── [place]/
│       ├── overview.md       # 地点描述
│       └── [sublocation].md  # 子地点
│
├── history/                  # 时间线与事件
│   ├── timeline.md           # 时间顺序总览
│   ├── eras/                 # 历史时期
│   └── events/               # 重大事件
│
├── factions/                 # 组织与团体
│   ├── _index.md             # 势力目录
│   └── [faction].md          # 单个势力条目
│
├── rules/                    # 世界运作规则
│   ├── _index.md             # 体系总览
│   ├── magic.md              # 魔法体系（如适用）
│   ├── technology.md         # 科技水平与规则
│   └── [system].md           # 其他体系
│
├── culture/                  # 信仰、习俗、语言
│   ├── _index.md             # 文化目录
│   └── [culture]/
│       ├── overview.md
│       ├── beliefs.md
│       ├── customs.md
│       └── language.md
│
├── artifacts/                # 重要物品
│   ├── _index.md
│   └── [artifact].md
│
├── species/                  # 非人类生物（如适用）
│   ├── _index.md
│   └── [species].md
│
└── meta/                     # 世界圣经相关元信息
    ├── contributors.md       # 贡献者列表
    ├── conflicts.md          # 已检测到的矛盾点
    ├── changelog.md          # 近期变更记录
    └── style-guide.md        # 写作规范

Canon Status System

Canon状态体系

Every piece of world information has a canon status:

每条世界信息都有对应的Canon状态：

Status Levels

状态等级

Status	Symbol	Meaning	Use
Established	✓	Appears in published/approved work	Treat as fact
Proposed	?	Suggested but not yet approved	Available for use, may change
Deprecated	✗	Was canon, now superseded	Don't use in new work
Contradicted	⚠	Conflicts with other canon	Needs resolution
Speculative	~	Extrapolated from canon	Use cautiously

状态	符号	含义	使用说明
Established（已确立）	✓	出现在已发布/已批准的作品中	视为事实
Proposed（提议中）	?	已提出但未获批准	可使用，但可能变更
Deprecated（已废弃）	✗	曾是Canon，但已被取代	不要用于新作品
Contradicted（存在矛盾）	⚠	与其他Canon内容冲突	需要解决
Speculative（推测性）	~	从Canon内容推导而来	谨慎使用

Status Rules

状态规则

Established entries cannot be contradicted without deprecating them first
Proposed entries can be freely modified until established
Deprecated entries remain for reference but shouldn't appear in new work
Contradicted entries require explicit resolution before use
Speculative entries are derived but not directly stated in source material

已确立条目在未先标记为废弃的情况下，不能被矛盾内容推翻
提议中条目在确立前可自由修改
已废弃条目仅作参考，不应出现在新作品中
存在矛盾条目在解决前不能使用
推测性条目是推导得出，并非直接来自源内容

Source Tracking

来源追踪

Every canon entry tracks its source:

markdown

undefined

每条Canon条目都需追踪其来源：

markdown

undefined

Sources

来源

The Night Kingdom, Chapter 3 (first appearance)
Shadows Rising, p. 47 (expanded)
Session notes 2024-03-15 (clarified by author)

---

夜之王国，第3章（首次出现）
暗影崛起，第47页（内容扩展）
2024-03-15 会话记录（作者澄清）

---

Entry Template

条目模板

Every world bible entry follows this structure:

markdown

undefined

每条世界圣经条目都遵循以下结构：

markdown

undefined

[Entry Name]

[条目名称]

Canon状态: 已确立 | 提议中 | 已废弃 | 存在矛盾 | 推测性 分类: 人物 | 地点 | 势力 | 事件 | 规则 | 文化 | 物品 | 物种 最后更新: [日期] 贡献者: [姓名]

Summary

摘要

[1-2 sentence overview for quick reference]

[1-2句话的快速参考概述]

Description

详细描述

[Detailed information about this entry]

[关于本条目的详细信息]

Relationships

关联关系

Related Characters: [[Character Name]], [[Another Character]]
Located In: [[Location Name]]
Member Of: [[Faction Name]]
Appears In: [[Event Name]]
See Also: [[Related Entry]]

相关人物: [[人物名称]], [[另一人物名称]]
所在地点: [[地点名称]]
所属势力: [[势力名称]]
出现场景: [[事件名称]]
另请参阅: [[相关条目]]

Key Facts

关键事实

Fact 1
Fact 2
Fact 3

事实1
事实2
事实3

Notes for Writers

创作者指南

[Guidance for using this element in stories]

[在故事中使用该元素的指导说明]

Sources

来源

Source 1 (what was established)
Source 2 (additional details)

来源1（确立的内容）
来源2（补充细节）

History

修改历史

[Date]: Created by [Contributor]
[Date]: Updated [what changed] by [Contributor]

---

---

Cross-Referencing

交叉引用

Use wiki-style links to connect entries:

使用维基式链接连接条目：

Link Syntax

链接语法

markdown

[[Character Name]]           # Link to character
[[Location Name|the city]]   # Link with display text
[[Faction Name#history]]     # Link to section

markdown

[[人物名称]]           # 链接到人物条目
[[地点名称|该城市]]   # 带显示文本的链接
[[势力名称#history]]     # 链接到指定章节

Relationship Types

关联关系类型

Type	Meaning	Example
contains	Parent-child location	City contains neighborhoods
member_of	Membership	Character member_of faction
located_in	Physical location	Event located_in place
related_to	General association	Character related_to character
preceded_by	Temporal sequence	Event preceded_by earlier event
contradicts	Canon conflict	Entry contradicts other entry
supersedes	Replaces	New entry supersedes deprecated

类型	含义	示例
contains（包含）	父子地点关系	城市包含街区
member_of（所属）	成员关系	人物属于某势力
located_in（位于）	物理位置关系	事件发生在某地
related_to（相关）	一般关联	人物与人物相关
preceded_by（前置）	时间顺序关系	事件发生在另一事件之前
contradicts（矛盾）	Canon冲突	条目与其他条目矛盾
supersedes（取代）	替代关系	新条目取代废弃条目

Contributor Coordination

贡献者协作

Contributor Roles

贡献者角色

Role	Can Do	Cannot Do
Reader	View all entries	Edit anything
Writer	Add proposed entries, edit own entries	Establish canon, edit others' work
Editor	Edit any entry, resolve conflicts	Establish canon
Canon Authority	Establish canon, deprecate entries	—

角色	可执行操作	不可执行操作
读者	查看所有条目	编辑任何内容
创作者	添加提议中条目、编辑自己的条目	确立Canon、编辑他人作品
编辑	编辑任何条目、解决矛盾	确立Canon
Canon权威方	确立Canon、标记条目为废弃	—

Contribution Workflow

贡献工作流

Propose: Writer adds new entry with status "Proposed"
Review: Editor checks for conflicts and quality
Integrate: Canon Authority establishes if approved
Track: Changelog records all changes

提议: 创作者添加状态为“提议中”的新条目
审核: 编辑检查是否存在矛盾与内容质量
整合: Canon权威方决定是否批准确立
追踪: 变更日志记录所有修改

Conflict Resolution

矛盾解决流程

When contradictions arise:

Identify both conflicting entries
Assess which has stronger source authority
Decide which becomes canon (or if reconciliation possible)
Mark the losing entry as Deprecated or update to reconcile
Document the decision in conflicts.md

当出现矛盾时：

识别两个冲突的条目
评估哪个条目的来源权威性更强
决定哪一个成为Canon（或是否可以调和）
标记未被采纳的条目为废弃，或更新以达成调和
记录决策到conflicts.md中

World Bible Operations

世界圣经操作

Operation: Initialize World Bible

操作：初始化世界圣经

Create a new world bible structure:

bash

deno run --allow-read --allow-write scripts/init-world.ts "World Name"

Creates the full directory structure with template files.

创建新的世界圣经结构：

bash

deno run --allow-read --allow-write scripts/init-world.ts "世界名称"

创建包含模板文件的完整目录结构。

Operation: Add Entry

操作：添加条目

Add a new entry to the world bible:

bash

deno run --allow-read --allow-write scripts/add-entry.ts \
  --category character \
  --name "Character Name" \
  --status proposed

Creates entry from template with proper metadata.

向世界圣经添加新条目：

bash

deno run --allow-read --allow-write scripts/add-entry.ts \
  --category character \
  --name "人物名称" \
  --status proposed

根据模板创建带有正确元数据的条目。

Operation: Check Conflicts

操作：检查矛盾

Scan for potential contradictions:

bash

deno run --allow-read scripts/check-conflicts.ts world-bible/

Identifies entries that may contradict each other.

扫描潜在的矛盾点：

bash

deno run --allow-read scripts/check-conflicts.ts world-bible/

识别可能存在矛盾的条目。

Operation: Generate Index

操作：生成索引

Rebuild index files from entries:

bash

deno run --allow-read --allow-write scripts/build-index.ts world-bible/

Updates all _index.md files with current entries.

从条目重建索引文件：

bash

deno run --allow-read --allow-write scripts/build-index.ts world-bible/

更新所有_index.md文件以包含当前条目。

Operation: Export Reference

操作：导出参考文档

Generate a single-file reference document:

bash

deno run --allow-read scripts/export-reference.ts world-bible/ --format md

Creates a portable reference document for writers.

生成单文件参考文档：

bash

deno run --allow-read scripts/export-reference.ts world-bible/ --format md

为创作者创建可移植的参考文档。

Integration with Worldbuilding Skill

与世界构建Skill的集成

The shared-world skill maintains; the worldbuilding skill diagnoses.

Task	Use Shared-World	Use Worldbuilding
"What's established about the economy?"	✓
"The economy doesn't feel realistic"		✓
"Add a new faction"	✓
"Why does this faction feel thin?"		✓
"What contradicts what?"	✓
"How should magic affect society?"		✓

共享世界Skill负责维护；世界构建Skill负责诊断。

任务	使用共享世界Skill	使用世界构建Skill
“关于经济的已确立设定是什么？”	✓
“这个经济设定感觉不真实”		✓
“添加一个新势力”	✓
“为什么这个势力设定显得单薄？”		✓
“哪些内容存在矛盾？”	✓
“魔法应该如何影响社会？”		✓

Diagnostic Handoff

诊断交接

When adding entries, consider running worldbuilding diagnostics:

New location → W1 (Backdrop World) check
New faction → W3 (Institutions Without History) check
New magic/tech → W2 (World Without Consequences) check
New culture → W5/W6 (Belief/Culture Depth) check
New species → W7 (Flat Non-Humans) check

添加条目时，建议运行世界构建诊断：

新地点 → W1（背景世界）检查
新势力 → W3（无历史的机构）检查
新魔法/科技 → W2（无后果的世界）检查
新文化 → W5/W6（信仰/文化深度）检查
新物种 → W7（扁平化非人类）检查

Common World Bible Tasks

常见世界圣经任务

Task: Onboard New Writer

任务：新创作者入职

Share discovery.md as entry point
Point to style-guide.md for conventions
Walk through canon-status.md for what's established
Explain contribution workflow
Assign initial reading (key established entries)

共享discovery.md作为入门指南
引导查看style-guide.md了解规范
讲解canon-status.md中的已确立内容
说明贡献工作流
指定初始阅读内容（关键已确立条目）

Task: Before Writing Session

任务：写作会话前准备

Check changelog.md for recent updates
Review entries relevant to your story
Note any proposed entries you might affect
Check conflicts.md for unresolved issues

查看changelog.md了解近期更新
复习与你的故事相关的条目
注意可能受你影响的提议中条目
查看conflicts.md中的未解决问题

Task: After Writing Session

任务：写作会话后跟进

Add any new worldbuilding as proposed entries
Update existing entries if expanded
Note any contradictions discovered
Add to changelog.md

将任何新的世界设定添加为提议中条目
若内容扩展则更新现有条目
记录发现的任何矛盾点
添加到changelog.md中

Task: Canon Review

任务：Canon审核

Review proposed entries for quality
Check for conflicts with established canon
Run worldbuilding diagnostics on significant additions
Establish or request revision
Update canon-status.md

审核提议中条目的质量
检查是否与已确立Canon存在矛盾
对重要新增内容运行世界构建诊断
确立Canon或要求修订
更新canon-status.md

Anti-Patterns

反模式

The Completionist

完美主义者

Pattern: Trying to document everything before writing starts. Problem: World bible becomes procrastination; entries grow stale. Fix: Document what you need when you need it. Bible grows with stories.

模式: 在开始写作前尝试记录所有内容。 问题: 世界圣经成为拖延的借口；条目变得过时。 解决方法: 需要时再记录所需内容。圣经随故事一同成长。

The Lore Dump

设定堆砌

Pattern: Entries contain encyclopedic detail no story uses. Problem: Maintenance burden; writers can't find what matters. Fix: Include only what writers need. Depth serves story, not the reverse.

模式: 条目包含大量故事中从未使用过的百科式细节。 问题: 维护负担重；创作者无法快速找到有用信息。 解决方法: 仅包含创作者需要的内容。细节为故事服务，而非相反。

The Siloed Bible

孤立的圣经

Pattern: World bible separate from actual writing process. Problem: Canon drifts; bible becomes outdated. Fix: Update bible as part of writing workflow, not separate task.

模式: 世界圣经与实际写作流程分离。 问题: Canon逐渐偏离；圣经变得过时。 解决方法: 将更新圣经作为写作工作流的一部分，而非独立任务。

The Authority Vacuum

权威真空

Pattern: No clear canon authority; everything stays "proposed." Problem: Nothing is reliable; writers can't depend on bible. Fix: Designate canon authority; establish review cadence.

模式: 没有明确的Canon权威方；所有内容都停留在“提议中”状态。 问题: 没有可靠的设定；创作者无法依赖圣经。 解决方法: 指定Canon权威方；建立定期审核机制。

The Conflict Avoidance

回避矛盾

Pattern: Contradictions ignored rather than resolved. Problem: Canon becomes unreliable; conflicts compound. Fix: Address conflicts immediately; document decisions.

模式: 忽略矛盾而非解决它们。 问题: Canon变得不可靠；矛盾点不断积累。 解决方法: 立即处理矛盾；记录决策过程。

The Single Source

单一来源

Pattern: One person maintains bible alone. Problem: Bus factor; limited perspective; bottleneck. Fix: Multiple contributors; clear ownership but shared access.

模式: 由单人独自维护圣经。 问题: 单点故障；视角受限；形成瓶颈。 解决方法: 多名贡献者参与；明确所有权但保持共享访问权限。

Style Guide Template

风格指南模板

Every world bible should include a style guide:

markdown

undefined

每个世界圣经都应包含风格指南：

markdown

undefined

[World Name] Style Guide

[世界名称] 风格指南

Naming Conventions

命名规范

Character names: [pattern, cultural influences]
Place names: [pattern, linguistic rules]
Organization names: [conventions]

人物名称: [模式，文化影响]
地点名称: [模式，语言规则]
组织名称: [规范]

Tone and Voice

语气与风格

[Description of world's tone]
[What to avoid]
[Examples of good/bad fits]

[世界语气描述]
[需要避免的内容]
[合适/不合适的示例]

Content Boundaries

内容边界

[What can be depicted]
[What requires sensitivity]
[Off-limits topics]

[可以描述的内容]
[需要注意敏感性的内容]
[禁止涉及的主题]

Formatting Standards

格式标准

[Date formats in-world]
[Measurement systems]
[Title capitalization]

世界内的日期格式
度量单位体系
标题大小写规则

Common Terms

常用术语

[World-specific vocabulary]
[Spelling of unusual words]

---

世界特定词汇
特殊词汇的拼写方式

---

Available Tools

可用工具

init-world.ts

Initialize a new world bible structure.

初始化新的世界圣经结构。

add-entry.ts

Create new entries from templates.

根据模板创建新条目。

check-conflicts.ts

Scan for potential contradictions.

扫描潜在的矛盾点。

build-index.ts

Regenerate index files.

重新生成索引文件。

export-reference.ts

Generate portable reference documents.

生成可移植的参考文档。

link-validator.ts

Check that wiki-links resolve to real entries.

检查维基链接是否指向真实条目。

Example Interactions

示例交互

Example 1: New Contributor

示例1：新贡献者

Writer: "I'm joining the shared world project. Where do I start?"

Your approach:

Point to discovery.md as navigation hub
Have them read style-guide.md
Walk through key established entries
Explain proposed vs. established status
Set up their first contribution (probably a character or location)

创作者: “我加入了这个共享世界项目，应该从哪里开始？”

你的处理方式:

推荐discovery.md作为导航中心
让他们阅读style-guide.md
讲解关键的已确立条目
说明提议中与已确立状态的区别
安排他们的第一个贡献任务（可能是人物或地点条目）

Example 2: Contradiction Discovered

示例2：发现矛盾

Writer: "Wait, in Chapter 3 we said the magic system requires blood, but Chapter 7 has a character using magic without it."

Your approach:

Create entries for both instances if they don't exist
Mark both as Contradicted
Add to conflicts.md with sources
Determine which has canon authority (earlier, more central, author preference)
Either reconcile (maybe the blood requirement has exceptions) or deprecate one

创作者: “等等，第3章里我们说魔法体系需要血液，但第7章里有个角色不用血液就使用了魔法。”

你的处理方式:

若条目不存在则为两个场景创建条目
将两者标记为“存在矛盾”
连同来源添加到conflicts.md中
确定哪一个更具Canon权威性（更早出现、更核心、作者偏好）
要么调和（比如血液要求有例外），要么标记其中一个为废弃

Example 3: Major World Expansion

示例3：世界重大扩展

Writer: "I want to add a whole new continent with its own cultures."

Your approach:

Create location entry structure for continent
Add as Proposed (not Established until approved)
Suggest worldbuilding diagnostic (W1 for depth, W6 for culture)
Create placeholder entries for key locations, cultures
Build out detail as stories require it (not all at once)

创作者: “我想添加一整块新的大陆，还有它自己的文化。”

你的处理方式:

为该大陆创建地点条目结构
标记为“提议中”（获批准前不确立为Canon）
建议运行世界构建诊断（W1检查深度，W6检查文化）
为关键地点、文化创建占位符条目
随故事发展逐步完善细节（而非一次性完成）

Output Persistence

输出持久化

This skill has comprehensive built-in persistence through a wiki-style world bible structure.

本Skill通过维基式世界圣经结构实现全面的内置持久化。

Existing Persistence Mechanism

现有持久化机制

The shared-world skill maintains a structured directory as a persistent world bible:

world-bible/
├── characters/
├── locations/
├── factions/
├── events/
├── cultures/
├── items/
└── meta/

Tools for persistence:

```
init-world.ts
```
- Creates the full directory structure
```
add-entry.ts
```
- Adds new entries with proper templates
```
build-index.ts
```
- Regenerates directory indexes
```
check-conflicts.ts
```
- Validates cross-references

共享世界Skill维护一个结构化目录作为持久化的世界圣经：

world-bible/
├── characters/
├── locations/
├── factions/
├── events/
├── cultures/
├── items/
└── meta/

持久化工具:

```
init-world.ts
```
- 创建完整的目录结构
```
add-entry.ts
```
- 添加带有正确模板的新条目
```
build-index.ts
```
- 重新生成目录索引
```
check-conflicts.ts
```
- 验证交叉引用

How It Differs from Standard Output Persistence

与标准输出持久化的区别

Unlike other skills that write session output to

explorations/

, shared-world maintains an operational wiki that is the world bible itself. The output IS the product, not a record of exploration.

This skill does NOT use
context/output-config.md
because:

The world bible location is established when initialized
The world bible IS the persistence (not session logs)
Multiple contributors need to know the fixed location

不同于其他将会话输出写入

explorations/

的Skill，共享世界Skill维护的是一个可操作的维基，即世界圣经本身。输出就是产品，而非探索记录。

本Skill不使用
context/output-config.md
，原因如下：

世界圣经的位置在初始化时就已确立
世界圣经本身就是持久化载体（而非会话日志）
多名贡献者需要知道固定的存储位置

Conversation vs. File

对话与文件的分工

Goes to File	Stays in Conversation
Canonical entries	Discussion of what to include
Cross-references	Conflict resolution
Status updates (Proposed→Established)	Canon debates
Structure and organization	Writer questions

存入文件	保留在对话中
Canon条目	关于内容包含的讨论
交叉引用	矛盾解决过程
状态更新（提议中→已确立）	Canon决策讨论
结构与组织	创作者的问题

What You Do NOT Do

你不负责的工作

You do not write story content (world bible is reference, not narrative)
You do not make canon decisions without authority
You do not resolve creative disputes (facilitate, don't decide)
You do not create entries speculatively (document what exists)
You do not prioritize completeness over usability

Your role is organizational and facilitative: keep the shared world coherent, accessible, and useful for writers. The writers write; you maintain their shared memory.

你不撰写故事内容（世界圣经是参考资料，而非叙事内容）
你不具备Canon决策权，除非获得授权
你不解决创意纠纷（仅提供协助，不做决定）
你不推测性创建条目（仅记录已存在的内容）
你不优先追求完整性，而是注重可用性

你的角色是组织与协助：保持共享世界的一致性、可访问性，为创作者提供便利。创作者负责写作；你负责维护他们的共享记忆。

Key Insight

核心洞察

A world bible is alive. It grows with the stories told in the world, not before them. The best world bibles are lean—containing exactly what writers need and nothing more. They're maintained alongside writing, not as a separate artifact.

The goal isn't to document a world comprehensively. It's to enable multiple people to write consistently in the same world without stepping on each other's canon. Every entry should answer a question a writer actually has.

世界圣经是活的。它随世界中的故事一同成长，而非先于故事存在。最好的世界圣经是精简的——恰好包含创作者需要的内容，不多不少。它与写作同步维护，而非作为独立的人工制品。

目标不是全面记录一个世界，而是让多个人能在同一个世界中一致写作，不互相破坏Canon。每条目都应回答创作者实际提出的问题。