关于 cw-official-docs
cw-official-docs 用于为故事中的角色、地点、事件和设定创建有来源依据的规范 wiki 页面。它面向已定稿的信息,采用灵活结构、引用和交叉链接,而非探索性工作笔记。
主要功能
- 01创建规范的故事参考页面
- 02要求事实主张注明来源
- 03按主题调整页面结构
- 04支持页面间交叉引用
- 05可通过网页搜索开展研究
适用场景
- 01记录已定稿的角色档案
- 02创建带引用的地点页面
- 03起草后记录已确定的事件
- 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.mdexample-pages.mdpage-patterns.md详细介绍
官方文档
为故事中的角色、地点、事件和背景设定创建权威且有来源依据的 Wiki 页面。
目的
编写权威的文档(Wiki 风格页面),作为虚构世界的“唯一可信来源”。这些页面经过润色、标注引用,采用百科全书式的风格,适合读者阅读——而不是工作笔记或头脑风暴内容。
可以在写作之前或写作期间创建,用于世界构建、背景设定,以及不会全部出现在故事本身中的参考资料。
文档与头脑风暴笔记
**关键区别:**文档 = 已经做出决定,并且润色到可以展示给他人。头脑风暴 = 仍在探索和斟酌。
| 文档 | 头脑风暴 |
|---|---|
| 单一版本 | 多个选项并存 |
| 经过润色 | 只有粗略框架 |
| 不含 [TBD] 标记 | 到处都有来源标签 |
| 可供读者阅读 | 作者的工作笔记 |
| 已敲定的决定 | 探索性内容 |
核心原则
1. 只收录正史内容
Wiki 页面只包含已确认的信息:
- 来自已写章节或最终确定的世界构建内容的事实
- 作者已经确定的细节
- 唯一权威版本
2. 必须注明来源
每项陈述都需要来源:
- 故事事实需引用章节
- 写作前创建的背景设定需标注“世界构建文档:[文件名]”
- 尽可能引用具体场景
3. 采用百科全书式语气
写作时应像参考资料一样:
- 使用第三人称
- 已发生的事件用过去时,当前状态用现在时
- 语气中立、客观
灵活的结构
文档页面不是待填写的模板——结构应与内容相匹配。
有些角色页面需要详细的背景故事,有些则不需要。有些地点只是“首都的一家酒馆”——写成一段就够了,不需要分成 12 个章节。有些魔法体系需要复杂的规则,有些则刻意保持神秘。
**只写重要的内容,跳过无关部分。**相信自己的判断。
参见 references/page-patterns.md,了解常见模式和示例——这些并非强制结构。
创建文档页面
- 确定需要记录的内容——角色?地点?体系?事件?
- 选择相关结构——参见 references/page-patterns.md,了解常见模式
- 写下重要内容——跳过无关章节,根据内容调整结构
- 添加引用——参见 references/citation-guide.md,了解格式
- 交叉引用——链接相关页面,方便读者发现
结构应根据内容调整——并非每个页面都需要包含所有章节。
使用网络搜索
在以下情况下,可按需搜索:
- 核实故事引用的现实世界事实
- 研究世界构建元素
- 寻找类似的虚构文档或 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)
- 查看项目文档,了解文件组织方式
- 常见位置:
docs/、wiki/、docs/reference/、reference/ - 遵循现有的命名惯例
- 不确定时请询问
资源
参见:
references/page-patterns.md- 常见模式和示例(非模板)references/citation-guide.md- 如何引用来源references/example-pages.md- 不同复杂程度的完整示例页面