Communityコーディング&開発github.com

BorjaGM1/kb-template

ヴォールトのリンク切れ、孤立ノート、重複、古いノート、タグ、MOCをリント・整理し、レポートを生成します。削除は所有者の承認が必要です。

kb-template とは?

このスキルは、個人知識ベース(通称「ガーデン」)のメンテナンスを自動化するためのエージェント向けツールです。ユーザーが抱える「リンク切れ」「孤立ノート」「重複」「古いノート」「タグの乱れ」「MOCの未更新」といった問題を検出・修正し、最終的にレポートを生成します。対応プラットフォームは特に指定されていませんが、CLIツール(git、rg、python)を前提としており、Gitで管理されたMarkdownベースのヴォールトであれば適用可能です。動作の流れは、まずlint.pyによる全体スキャンで問題を洗い出し、その後各問題を順次修正(リンク修復、孤立ノートの関連付け、重複のマージ、古いノートのアーカイブ提案、タグの正規化、フロントマターの補完、Inboxの整理、MOCの更新)します。特に重要な点として、ファイルの削除や内容を削るマージは所有者の承認を得るまでは行わず、提案のみ行います。これにより、安全かつ継続的に知識ベースの健全性を保つことができます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/BorjaGM1/kb-template/tree/HEAD/skills/gardening

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

ガーデニング

  1. リポジトリルートで git pull --rebase を実行。
  2. python3 scripts/lint.py を実行(すべてのヴォールト)し、出力を収集。
  3. 壊れたリンク: 既存のノートを指すようにタイプミスやリネームを修正。ターゲットが本当に存在しない場合は、有用な場合のみスタブを作成し、それ以外はリンクを解除。内容を捏造しないこと。
  4. 孤立ノート: 各孤立ノートを関連するノートまたはMOCからリンク。適切な場所がない場合は Inbox/ に移動。
  5. 重複: 類似タイトル/エイリアス/内容を検索(rg、比較)。より良いノートに統合(全事実を保持、ソースを統合、エイリアスを追加、リンクをリダイレクト)。内容を削るまたはファイルを削除するマージは提案のみ行い、実行しない。
  6. 古いノート: updated が6ヶ月以上前、空のスタブ、完了したプロジェクトは status: archived または削除を提案。
  7. タグ: ケース/ケバブケースを正規化、同義語を統合(#ideas → #idea)、一回限りのノイズタグを削除。
  8. フロントマター: created/updated/source/tags が存在し、有効であることを確認。
  9. Inbox: Inbox/ 内のノートを、明確な場合は適切な場所に整理。
  10. MOC: Home.md およびトピックMOCを最新に保つ。トピックが約5つになったらMOCを作成。
  11. lintを再実行。論理的な変更ごとにコミット(garden(<v>): ...)。各コミット後すぐにプッシュ。
  12. 所有者へのレポート: 修正内容と、承認が必要な削除/マージ/アーカイブの提案を報告。所有者の承認なしに削除してはいけません。

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

関連スキル