wiki-sync

Wiki 同期

調査メモを構造化された Wiki ナレッジベースに整理します。

Wiki の規約

• スラッグ：小文字のケバブケース（protein-folding、hypothesis-1）
• Wiki リンク：内部リンクには [[slug]]、カスタムラベルには [[slug|Display Text]]
• インデックス：すべてのページを一覧にした表を含む index.md を常に維持します
• 1 ページにつき 1 つの概念：各ページは、単一のエンティティ、概念、またはトピックに焦点を当てます
• ソースセクション：すべてのページの末尾に、情報の出典を記載した ## Sources セクションを設けます

ワークフロー

1. 既存のメモを監査する — すべてのファイルを一覧表示し、すでに Wiki の構造になっているものを特定します
2. 概念を特定する — 構造化されていないメモから、主要なエンティティ、トピック、関係を抽出します
3. ページを作成／更新する — 概念ごとに 1 ページを作成し、相互リンクを追加します
4. インデックスを作成する — index.md を生成または更新します
5. 報告する — 作成した新規ページ、更新したページ、追加したリンクを一覧表示します

ページテンプレート

# [Page Title]

[1–2 sentence summary of this concept]

## Overview
[Detailed content about this concept]

## Related Concepts
- [[related-slug-1]] — [brief description of relationship]
- [[related-slug-2]] — [brief description of relationship]

## Sources
- [Source name/file]
- [Source URL if applicable]

*Last updated: [date]*

インデックステンプレート

# Wiki Index

> Auto-maintained index of all wiki pages.

| Page | Summary | Updated |
|------|---------|---------|
| [[slug-1]] Page Title | One-line summary | YYYY-MM-DD |
| [[slug-2]] Page Title | One-line summary | YYYY-MM-DD |

設定

メモのディレクトリに wiki-sync.config.md ファイルを追加すると、デフォルト設定を上書きできます。

# Wiki Sync Config

maxPages: 20
outputDir: wiki/
indexFile: index.md
language: en

オプション	デフォルト	説明
maxPages	8	同期 1 回につき作成するページの最大数です。メモが大量にある場合は増やしてください。
outputDir	.（メモと同じディレクトリ）	Wiki ページを書き込むサブディレクトリ
indexFile	index.md	自動生成されるインデックスのファイル名
language	en	生成テキストの出力言語（en、ko、ja など）

設定ファイルがない場合は、すべてのデフォルト設定が適用されます。

ルール

• 同期 1 回につき最大 8 ページをデフォルトとします。設定の maxPages で上書きできます（ユーザーに負担をかけないようにしてください）
• 差分同期では、新しいページの作成より既存のページの更新を優先します
• 既存の内容は削除しないでください。セクションを追加または更新します
• ページを追加した後は、必ずインデックスを再構築します
• 設定で outputDir が指定されている場合は、それに従ってすべての新規ページを書き込みます