wiki-maintenance

name	wiki-maintenance
description	wiki/ 以下の既存Wikiを点検し、重複ページの統合、本文の推敲、関連リンクの整理、カテゴリやディレクトリ構成の見直し、リネームや移動、wiki/index.md と wiki/changelog.md の更新を行うSkill。ユーザーが「wikiを整理して」「既存wikiをブラッシュアップして」「wikiのdirを整理して」「wiki-maintenanceして」のように依頼したら使うこと。sources/ から新規Wikiを作る作業は source-to-wiki を使う。

wiki-maintenance

wiki/ 以下の既存ページを読み、知識ベースとして使いやすい形に保守する。 sources/ から新規ページを作る取り込み作業は範囲外とし、既存Wikiの整理、推敲、統合、移動に集中する。

最初に wiki/ 配下を確認し、index.md と changelog.md 以外のページが1件も無ければ「点検対象がない」と報告して終了する。 --dry-run が指定された場合は、手順1〜2 (現状確認と方針決定) だけを行い、ページごとの方針 (推敲・統合・分割・移動・索引修正) を提示して終了する。ファイルの作成・編集・移動・削除は一切行わない。

併用するSkill

wiki/ の本文を作成・更新する前に、local skill の japanese-tech-writing と stop-ai-slop-jp を読む。 最終本文は、日本語の技術文書として読みやすく、AI臭の少ない文章に整える。 これらのskillが環境に無い場合は、この節をスキップし、手順3の本文方針に従って直す。

ルール

• sources編集禁止：sources/ 配下は参照確認だけに使い、frontmatter、本文、画像パス、ファイル名を変更しない。
• 既存情報を失わない：統合、削除、リネーム、移動を行う前に、差分で失われる見出し、リンク、出典、未確認事項がないか確認する。
• 根拠を残す：ページのfrontmatter sources や本文の「参照元」を維持し、出典のない断定を追加しない。
• 構成変更は最小限：カテゴリやディレクトリは、検索性や重複解消に明確に効く場合だけ変える。
• リンクを追随する：ページをリネーム・移動したら、wiki/ 内のリンク、frontmatter related、wiki/index.md を更新する。
• index/changelog更新：Wiki本文、配置、索引を実質的に変えたら、wiki/index.md と wiki/changelog.md も更新する。

対象の決め方

ユーザーが対象ページ、カテゴリ、ディレクトリを指定した場合は、その範囲だけ処理する。 指定がない場合は、次を確認して整理対象を決める。

• wiki/index.md に載っていないページ
• 同じ主題を扱う重複・近接ページ
• frontmatterの category、related、sources と配置がずれているページ
• 古い名前、曖昧な名前、深すぎる階層にあるページ
• 本文が箇条書きの集積だけになっているページ
• カテゴリ全体を1ページに抱えた巨大なカタログページ (主題単位への分割対象)
• 本文が原資料へのリンク紹介文の羅列になっているページ
• 件数など、原資料の増減で古くなる統計値を本文に持つページ

大規模な移動や統合になりそうな場合は、一度に全体を変えず、カテゴリ単位で区切る。

手順

1. 現状を読む

• 対象のWikiページ、wiki/index.md、wiki/changelog.md を読む。
• 必要な場合だけ、frontmatter sources や本文の「参照元」から原資料を読む。
• 重複、リンク切れ、索引漏れ、カテゴリずれ、本文品質の問題を整理する。

2. 方針を決める

対象ごとに次のどれを行うか決める。

• 推敲：本文の見通し、見出し、段落、表現を直す。情報の意味は変えない。
• 統合：重複ページを1ページにまとめる。統合先に出典と関連リンクを引き継ぐ。
• 分割：1ページが複数主題を抱えている場合だけ分ける。
• 移動・リネーム：カテゴリ構成や名前が検索性を下げている場合だけ行う。
• 索引修正：wiki/index.md のカテゴリ、リンク、説明を実態に合わせる。

迷う場合は、削除や大幅移動よりも本文改善とリンク整理を優先する。

3. Wikiページを更新する

既存ページを編集する場合は、frontmatterを保つ。 新規ページが必要な場合は _template/wiki.md を使う。

frontmatterは次を確認する。

• title はページ内容を端的に表す。
• category は wiki/index.md の主要カテゴリに合わせる。
• sources は統合元ページや原資料から失わずに引き継ぐ。
• related は実際に参照価値がある既存Wikiページだけにする。
• updated は実質更新日に合わせる。

本文は次の方針で直す。

• 結論、背景、具体、未確認事項を分ける。
• 箇条書きだけで意味が取りにくい箇所は、短い本文に直す。
• 出典のない一般化や断定を避ける。
• 原資料同士や既存ページ同士が矛盾する場合は、片方に寄せず違いを明示する。

4. 移動・リネーム時の処理

ページを移動・リネームする場合は、可能なら git mv を使う。 その後、次を確認して更新する。

• wiki/**/*.md の本文リンク
• frontmatter related
• wiki/index.md
• 統合元ページに残す必要がある情報

統合でページを削除する場合は、統合先に旧ページの要点、出典、関連リンクが残っていることを確認してから削除する。

5. indexを更新する

wiki/index.md を実態に合わせて更新する。 カテゴリ説明を大きく書き換えない。 カテゴリを新設、統合、削除する場合は、最後の報告に理由を書く。

6. changelogを更新する

wiki/changelog.md の先頭に履歴を追記する。 形式は既存の見出しに合わせる。

## [YYYY-MM-DD] organize | <短い説明>

- `<wiki>` を推敲・統合・移動しました。
- `wiki/index.md` のリンクを整理しました。

最新の履歴が一番上に来るようにする。

7. 検証する

• oxfmt で編集したMarkdownを整形する。
• scripts/check_image_links.py を実行し、Markdown画像リンクが壊れていないことを確認する。
• rg で旧パスや旧タイトルへのリンクが残っていないことを確認する。
• git diff で sources/ に意図しない変更がないことを確認する。

報告

次を簡潔に報告する。

• 更新、統合、移動、削除したWikiページ
• wiki/index.md / wiki/changelog.md の更新有無
• 新設・統合・削除したカテゴリがあればその理由
• sources/ を変更していないこと
• 検証結果