wiki-docs

Wiki ドキュメント

物語の登場人物、場所、出来事、世界設定について、読者向けの正式な参照ページを作成します。洗練された百科事典風の項目として、読者、作家、批評家が参照する「信頼できる唯一の情報源」となります。

2 つのドキュメント領域

wiki/（またはプロジェクトに相当する領域） — 読者向けです。洗練された百科事典風の文体を使い、ネタバレを管理し、リンクを適切に扱います。このスキルが作成するのはこちらです。

ナレッジベース — 作家／エージェント向けです。判断の理由、出典タグ、未解決の質問、実装メモを注記します。ナレッジ保守エージェント（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>

矛盾への対処

出典同士が矛盾する場合：

• それぞれの記述を明示する
• 両方の出典を引用する
• 作者による解決が必要な旨を示す：[矛盾：第 2 章では X、第 8 章では Y と記載 — 明確化が必要]

一方の記述を黙って選んではいけません。正史は作者が決定します。

ページの作成

1. 記録が必要な内容と、適切な構成を決めます
2. 重要な内容を記述し、無関係なセクションは省きます
3. 出典を追加します（resources/citation-guide.md を参照）
4. 関連エンティティへのリンクを初出時に追加します
5. 複雑さに応じて関係図を追加します
6. 該当する場合は、ネタバレに関する frontmatter を設定します

リソース

• resources/page-patterns.md — 最小構成から複雑な構成までの例。登場人物、場所、世界設定、出来事、組織を扱います
• resources/citation-guide.md — インライン引用、参照セクション、矛盾への対処、ネタバレの引用形式