mcpField
C
cw-official-docs

cw-official-docs

github.com/haowjy创意与媒体54995 次安装今天更新
代码仓库

关于 cw-official-docs

cw-official-docs 用于为故事中的角色、地点、事件和设定创建有来源依据的规范 wiki 页面。它面向已定稿的信息,采用灵活结构、引用和交叉链接,而非探索性工作笔记。

主要功能

  1. 01创建规范的故事参考页面
  2. 02要求事实主张注明来源
  3. 03按主题调整页面结构
  4. 04支持页面间交叉引用
  5. 05可通过网页搜索开展研究

适用场景

  1. 01记录已定稿的角色档案
  2. 02创建带引用的地点页面
  3. 03起草后记录已确定的事件
  4. 04写作前整理设定参考资料

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/haowjy/creative-writing-skills --skill cw-official-docs

安装后在 Claude Code 中输入/cw-official-docs确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
citation-guide.md
example-pages.md
page-patterns.md

详细介绍

官方文档

为故事中的角色、地点、事件和背景设定创建权威且有来源依据的 Wiki 页面。

目的

编写权威的文档(Wiki 风格页面),作为虚构世界的“唯一可信来源”。这些页面经过润色、标注引用,采用百科全书式的风格,适合读者阅读——而不是工作笔记或头脑风暴内容。

可以在写作之前或写作期间创建,用于世界构建、背景设定,以及不会全部出现在故事本身中的参考资料。

文档与头脑风暴笔记

**关键区别:**文档 = 已经做出决定,并且润色到可以展示给他人。头脑风暴 = 仍在探索和斟酌。

文档头脑风暴
单一版本多个选项并存
经过润色只有粗略框架
不含 [TBD] 标记到处都有来源标签
可供读者阅读作者的工作笔记
已敲定的决定探索性内容

核心原则

1. 只收录正史内容

Wiki 页面只包含已确认的信息:

  • 来自已写章节或最终确定的世界构建内容的事实
  • 作者已经确定的细节
  • 唯一权威版本
2. 必须注明来源

每项陈述都需要来源:

  • 故事事实需引用章节
  • 写作前创建的背景设定需标注“世界构建文档:[文件名]”
  • 尽可能引用具体场景
3. 采用百科全书式语气

写作时应像参考资料一样:

  • 使用第三人称
  • 已发生的事件用过去时,当前状态用现在时
  • 语气中立、客观

灵活的结构

文档页面不是待填写的模板——结构应与内容相匹配。

有些角色页面需要详细的背景故事,有些则不需要。有些地点只是“首都的一家酒馆”——写成一段就够了,不需要分成 12 个章节。有些魔法体系需要复杂的规则,有些则刻意保持神秘。

**只写重要的内容,跳过无关部分。**相信自己的判断。

参见 references/page-patterns.md,了解常见模式和示例——这些并非强制结构。

创建文档页面

  1. 确定需要记录的内容——角色?地点?体系?事件?
  2. 选择相关结构——参见 references/page-patterns.md,了解常见模式
  3. 写下重要内容——跳过无关章节,根据内容调整结构
  4. 添加引用——参见 references/citation-guide.md,了解格式
  5. 交叉引用——链接相关页面,方便读者发现

结构应根据内容调整——并非每个页面都需要包含所有章节。

使用网络搜索

在以下情况下,可按需搜索:

  • 核实故事引用的现实世界事实
  • 研究世界构建元素
  • 寻找类似的虚构文档或 Wiki 以获取灵感
  • 检查命名惯例或术语

时机

可以在写故事章节之前编写文档页面——只需确保内容已经确定,并且经过润色、可供展示,而不是探索性内容。

**对于世界构建和背景设定:**敲定概念 → 创建文档页面 → 写作时参考

**对于故事事件:**写章节 → 记录发生的事 → 创建文档页面

教学示例:简单与复杂

并非每个页面都需要复杂的结构:

简单地点(完全没问题):

---
title: The Broken Wheel Tavern
type: location
---

# The Broken Wheel Tavern

A run-down tavern in the merchant quarter of Kingsport. Known for cheap ale and cheaper rooms.

The protagonist meets their contact here in Chapter 3.

**References:**
- Chapter 3: First meeting scene

复杂角色(需要时):

---
title: Marcus Webb
type: character
status: alive
---

# Marcus Webb

Former military intelligence officer turned information broker in Kingsport.

## Background
Served 15 years in the Royal Intelligence Service before a scandal forced his resignation. Now operates independently, selling information to whoever can pay.

## Appearance
Mid-40s, graying hair, military bearing despite civilian clothes. Distinctive scar across left eyebrow from field injury.

## Role in Story
Acts as information source for the protagonist. Provides critical intelligence about the conspiracy in Chapter 3, then becomes recurring ally throughout Arc 1.

## Key Relationships
- **Sarah Chen**: Former colleague, maintains uneasy trust
- **The protagonist**: Professional relationship, provides information for payment

**References:**
- Chapter 3: First introduction, provides intel
- Chapter 7: Warns protagonist about surveillance  
- Chapter 12: Reveals his own involvement in the conspiracy

两者都没问题——结构应符合需要记录的内容。

技能可以组合使用

需要时,可随意与其他技能组合使用(例如,在探索世界构建内容并将其整理成文档页面之前,使用 cw-brainstorming)。

文件放置位置(Claude Code)

  1. 查看项目文档,了解文件组织方式
  2. 常见位置:docs/、wiki/、docs/reference/、reference/
  3. 遵循现有的命名惯例
  4. 不确定时请询问

资源

参见:

  • references/page-patterns.md - 常见模式和示例(非模板)
  • references/citation-guide.md - 如何引用来源
  • references/example-pages.md - 不同复杂程度的完整示例页面

评论

支持 Markdown