KnowledgeLedgerUpdater｜AI知見をxlsx台帳に自動追記

KnowledgeLedgerUpdater — AI知見を xlsx 台帳に自動追記

markdown／text ファイル末尾の KNOWLEDGE_ENTRY_V1 ブロックを抽出し、ジャンル別の xlsx 台帳の該当シート末尾へ自動追記します。ID による重複検出（何度実行しても冪等）＋非破壊書込（既定は新ファイル出力・--in-place で上書き）。AIセッションを横断して、研究ノート／チャット要約／ビジネスアイデアを蓄積する knowledge worker 向けです。ローカル処理のみ・LLM呼び出しゼロ・ネットワーク不要。

こんな方に

• セッション横断の知見蓄積を管理する AI エージェント開発者
• 複数の LLM セッションから構造化ノートを集める研究者／ライター
• 長期プロジェクトで検証済アイデア・手順・ツールを記録するソロ創業者
• 「あとで整理する」と言って .md が50個散らかった経験のある方

解決する課題

• ノートが大量の .md に散らばり検索困難 → 構造化列を持つ１つの xlsx 台帳
• 手作業コピペで一貫性が崩れる → KNOWLEDGE_ENTRY_V1 スキーマで定義
• 再実行で重複が増える → ID ベースの重複検出（冪等）
• 既存台帳を壊すリスク → 非破壊が既定（新ファイル）
• LLM ベースの知識グラフは再索引ごとに課金 → エントリ毎の課金ゼロ

クイックスタート

pip install openpyxl
python3 scripts/knowledge_ledger_updater.py --source sample/input/sample_entries.md --ledger sample/input/sample_ledger.xlsx --output sample/output/sample_ledger_updated.xlsx

特長

• Python＋openpyxl・LLM API 呼び出しゼロ・ネットワーク不要
• ID重複検出で冪等・非破壊書込が既定
• 対応：Claude Code / OpenClaw / Codex / Anthropic Claude Agent SDK

English summary

Extract KNOWLEDGE_ENTRY_V1 blocks from markdown / text files and auto-append them to a genre-classified xlsx ledger. ID-based dedup (idempotent), non-destructive (new file by default; --in-place to overwrite). For AI knowledge workers managing research notes, chat summaries, and business ideas across long sessions. Local processing only — zero LLM API, zero network.