wiki-ingest

wiki-ingest

特定ファイル or 最近の git 変更から知見を抽出して claude-brain Wiki に取り込むスキル。/wiki-ingest-all の軽量版で、日常的に気になる点だけ Wiki に落とすために使う。

いつ使うか

• 特定のファイル/ディレクトリの知見だけ Wiki に追加したい時
• 最近の git 差分から設計判断やバグ修正の知見を拾いたい時
• /wiki-ingest-all ほど大掛かりにする必要がない時

プロジェクト全体を backfill したい場合は /wiki-ingest-all を使うこと。

前提

• $OBSIDIAN_VAULT が設定され、$OBSIDIAN_VAULT/wiki/ が存在すること
• 引数なしモードは git リポジトリ内で実行すること

モード判定

モード A: パス指定 (/wiki-ingest <path>)

引数に 1 つ以上のパス (ファイル or ディレクトリ) が渡されたらこのモード。

# 例
/wiki-ingest src/auth/strategy.ts
/wiki-ingest docs/architecture/
/wiki-ingest src/middleware/ src/utils/errors.ts

モード B: git 差分 (/wiki-ingest 引数なし)

引数が空ならこのモード。最近の git 変更から Claude が判断して知見を抽出する。

ワークフロー

Step 0: 環境確認

/wiki-ingest-all の Step 0 と同じ:

test -n "$OBSIDIAN_VAULT" || echo "ERROR: OBSIDIAN_VAULT not set"
test -d "$OBSIDIAN_VAULT/wiki" || echo "ERROR: wiki/ missing"

PROJECT_NAME=$(git config --get remote.origin.url 2>/dev/null | sed -E 's#.*/([^/]+)(\.git)?$#\1#' | sed 's/\.git$//')
test -n "$PROJECT_NAME" || PROJECT_NAME=$(basename "$(pwd)")

Step 1: 対象の決定

モード A (パス指定)

• 指定されたパスが存在するか test -e で確認
• ファイルなら直接読む (Read)
• ディレクトリなら ls で中身を確認し、主要なもの (README, index.*, 設計ドキュメント等) を優先して読む
• バイナリ/大きすぎるファイルはスキップ

モード B (git 差分)

最近のコミットをまず眺めて範囲を決める:

git log --oneline -10
git status

上の結果を見て Claude が範囲を判断する。固定の HEAD~N は使わない。典型的には:

• 直近 1〜3 コミットに明確なテーマがある → その範囲
• コミットが細かくバラバラ → 直近 1 コミットだけ
• 作業途中 (uncommitted) → git diff + git diff --cached のみ

決めた範囲で差分を取得:

git diff HEAD~<N>..HEAD --stat       # まず概要
git diff HEAD~<N>..HEAD              # 次に本体 (大きければファイル単位で絞る)

スキップする変更:

• lint / format / typo 修正
• 依存関係の単純なバージョンバンプ
• ファイル移動・リネームだけのコミット
• 生成物 (dist/, build/, lock ファイル)

Step 2: 既存 Wiki 監査

/wiki-ingest-all の Step 0-3 と同じ:

ls "$OBSIDIAN_VAULT/wiki/projects/"
ls "$OBSIDIAN_VAULT/wiki/concepts/"
ls "$OBSIDIAN_VAULT/wiki/patterns/"
cat "$OBSIDIAN_VAULT/wiki/index.md"

qmd MCP が利用可能ならキーワードで事前検索 (オプショナル)。