关于 wiki-docs
wiki-docs 指导创作故事角色、地点、事件和设定的规范性参考页面，面向读者并强调只记录已确认信息。它提供引用、实体链接、防剧透和关系图示等写作规则。
主要功能
- 01编写规范性故事百科页面
- 02仅记录已确认设定
- 03为事实添加来源引用
- 04首次提及实体时添加链接
- 05处理剧透与矛盾信息
- 06按需加入关系图
适用场景
- 01整理角色与地点资料
- 02记录故事事件和世界设定
- 03为读者编写可导航的故事 Wiki
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/wiki-docs确认已加载。
附带文件resources/citation-guide.mdresources/page-patterns.md
详细介绍
Wiki 文档
为故事中的角色、地点、事件和背景设定创建权威的读者参考页面。这些页面是经过润色的百科全书式条目，是读者、作者和评论者查阅的“唯一真实来源”。
两个文档空间
wiki/（或项目中的对应目录）——面向读者。文风经过润色、具有百科全书风格、管理剧透，并遵循链接规范。本技能生成的内容。
知识库——面向作者和 Agent。包含决策理由、来源标签、未解决的问题和实现说明，由知识维护 Agent（session-miner、chronicler、graph-maintainer）维护。不属于本技能的范围。
区分这两者很重要，因为面向读者的文档和面向作者的文档用途不同。Wiki 页面呈现角色的正典状态。知识库中的角色条目则会说明为什么做出某些选择、考虑过哪些替代方案，以及哪些内容已规划但尚未揭晓。
核心原则
仅收录正典内容
Wiki 页面只包含已确认的信息——已写章节中的事实、已定稿的世界观设定，以及作者已决定的细节。如果某件事尚未决定，就应记在头脑风暴笔记中，而不是 Wiki 中。
百科全书式文风
以参考资料的风格写作：
- 使用第三人称和中性语气
- 已完成的事件用过去时，当前状态用现在时
- 以事实为主，而非叙事（描述发生了什么，而不是感受如何）
- 不加入作者评论或推测
引用
每项主张都需要来源。详细格式请参阅 resources/citation-guide.md：
- 故事事实引用章节
- 写作前创作的背景设定引用世界观文档
- 需要精确定位时，引用具体场景
链接规范
每个实体在页面中首次出现时都要添加链接。这意味着：
- 角色、地点、事件、系统——首次提及时添加链接
- 使用 Wiki 链接（
[[Entity Name]]）或 Markdown 链接（[Entity Name](entity-name.md)）——遵循项目惯例 - 不要反复链接同一实体——每个章节首次出现时链接即可
- 链接到已存在或应当存在的页面（标记缺失页面：
[[Entity Name]](需要创建页面)）
链接规范有助于导航——读者应能沿着实体间的关联进行浏览，而无需搜索。
关系图
对于涉及复杂关系的页面（关联众多的角色页面、派系页面、涉及多方的事件页面），请嵌入 mermaid 图，展示关系结构。
## Relationships
```mermaid
graph LR
A[Character A] -->|mentors| B[Character B]
A -->|rivals| C[Character C]
B -->|allied with| D[Character D]
C -->|manipulates| D
Use diagrams when relationships are complex enough that a list alone would be hard to follow. Simple pages with one or two relationships don't need diagrams.
## Structure
Structure should fit the content. See [`resources/page-patterns.md`](resources/page-patterns.md) for examples ranging from minimal (3 lines) to complex (full article with sections, diagrams, and detailed citations). Don't force complex structure onto simple content.
**Include what matters, skip what doesn't.** A minor supporting character might be a name, role, and chapter reference. A protagonist might need sections on background, personality, abilities, relationships, and arc progression.
Trust your judgment on what each page needs.
## Spoiler Management
Wiki pages that contain information revealed later in the story need spoiler handling:
**YAML frontmatter:**
```yaml
spoilers: true
spoiler_level: major # or minor
行内剧透（用于隐藏在交互之后的细节）：
<details>
<summary>Major Spoilers — Chapter 15+</summary>
Content revealed in later chapters...
</details>
矛盾处理
来源之间存在矛盾时：
- 明确注明两个版本
- 引用两个来源
- 标记为待作者裁定：
[Contradiction: Chapter 2 says X, Chapter 8 says Y — clarification needed]
不要默默选取其中一个版本。由作者决定正典内容。
创建页面
- 确定需要记录的内容，以及适合的结构
- 撰写重要内容——跳过无关章节
- 添加引用（参阅
resources/citation-guide.md） - 首次提及相关实体时添加链接
- 在复杂程度需要时添加关系图
- 如适用，设置剧透 frontmatter
资源
resources/page-patterns.md— 从简约到复杂的示例，涵盖角色、地点、背景设定、事件和组织resources/citation-guide.md— 引用格式：行内引用、参考资料章节、矛盾处理、剧透引用