OpenWiki / Code Wiki

概要

リポジトリのコードから Wiki を生成し、チャットがコードではなく 生成済み Wiki を読む 構造を作るツール群。LLM Wiki パターン の実装にあたる。「毎回読み直す」RAG 的なアプローチをやめ、常設の Wiki 層を置くのが共通の設計思想。

主要な実装

OpenWiki を GitHub Actions で回す

エージェント本体は CLI に同梱されているため、自分で用意するのは推論プロバイダと認証情報だけ。

設定の3層

設定は 3 層に分かれており、どこに何を置くかを決めるのが構成作業の中心になる。

OIDC キーレス認証

長期の API キーをリポジトリシークレットに置かず、OIDC でキーレス化できる。

fetch-depth: 0 の落とし穴

actions/checkout の既定は浅いクローンで、履歴が必要な解析が動かない。fetch-depth: 0 の指定が要る。

mkdocs との運用モデルの違い

Code Wiki が「チャットの読み先」として Wiki を持つのに対し、OpenWiki は mkdocs のように CI で定期生成する モデル。前者はサービス、後者はパイプラインとして組む。

関連ページ

• LLM Wiki パターン — 設計思想の元
• GitHub Actions のセキュリティ — OIDC 認証の背景
• RAG — 対比される方式

ソース記事

• OpenWiki を GitHub Actions で定期実行する — 設定と API キーをどこに置くか — 2026-08-16
• Google Code Wiki を設計として読む — 「毎回読み直す」をやめた常設 Wiki 層 — 2026-08-16