| name | knowledge-base |
| description | ローカルMarkdownファイルによる個人ナレッジベースを管理する。メモ・記録・ノートの保存、検索・参照、会議メモの構造化、既存ファイルの取り込みに使用する。Do NOT use for プロジェクトのソースコードやSDDドキュメントの管理。 |
| metadata | {"version":"1.0.0"} |
Knowledge Base スキル
トリガー条件（descriptionの補足詳細）
descriptionはスキル発火判定用の簡潔な概要。以下はスキル実行時に参照する詳細なトリガーパターン。
以下のような場面で必ず使用すること：
- 「メモして」「記録して」「ノートに追加して」「保存して」などの保存・追記リクエスト
- 「〜について調べて（自分のナレッジから）」「〜に関する過去の情報は？」などの検索・参照リクエスト
- 「会議メモ」「議事録」「MTGまとめ」などを渡されたとき（構造化して保存）
- 「〜を整理して」「〜を要約してまとめて」などの整理リクエスト
- 「既存のファイルを取り込んで」「〜をナレッジベースに入れて」などの取り込みリクエスト
- ワークスペース（案件・カテゴリ）の作成・一覧・切り替えリクエスト
情報が混在しないよう、必ずワークスペースを明示または確認してから操作すること。
ローカルMarkdownファイルによるナレッジベースを管理する。Git（ローカルのみ）で履歴管理し、VS Codeで閲覧可能な構成を維持する。
Inputs
- ユーザーのメモ本文、会議メモ、生テキスト、既存Markdownファイル
- 操作種別（保存 / 追記 / 検索 / 要約 / 取り込み）
- 対象ワークスペース名（未指定時は確認）
Outputs
- 作成・更新されたMarkdownノート
- 更新された
INDEX.md / _index/MASTER.md / _index/tags.md
- 実行内容を反映したローカルGitコミット
KB_ROOTの決定方法
KB_ROOT = Claude Codeが実行されているカレントディレクトリ（pwd）
設定ファイルは不要。操作前に必ず以下で確認する：
pwd
初回判定: Gitリポジトリとして初期化済みかを確認し、さらにKB必須ファイルの存在を検証する。
git rev-parse --is-inside-work-tree 2>/dev/null && echo "git: initialized" || echo "git: not initialized"
test -f _index/MASTER.md && test -f _index/tags.md && echo "kb: ready" || echo "kb: not ready"
git: not initialized → 初回セットアップを提案git: initialized かつ kb: not ready → KB必須ファイルのみ作成を提案（既存リポジトリへの追加）- 両方OK → 通常操作可能
既存リポジトリの安全確認: リモートが設定されている場合、KB操作で意図しないpushが発生しないよう警告する。
git remote -v
リモートが存在する場合は、ユーザーに以下を確認する：
- このリポジトリにKBファイルをコミットしてよいか
- KB専用ディレクトリでの運用を推奨する旨を案内
ディレクトリ構造
{KB_ROOT}/ ← Claude Codeのカレントディレクトリ（pwd）
├── .git/ # ローカルGit（remoteなし）
├── _index/
│ ├── MASTER.md # 全ワークスペース横断インデックス
│ └── tags.md # 全タグ一覧と件数
├── {workspace-name}/
│ ├── INDEX.md # ワークスペース別インデックス（自動更新）
│ └── {note-slug}.md # 個別ノート
└── ...
ワークスペース命名規則
- 英小文字・ハイフン区切り（例:
project-alpha, internal, general）
- 予約済みディレクトリ:
_index（インデックス専用、ノート不可）
ノートのフォーマット
すべてのノートはYAMLフロントマターを持つ：
---
title: ノートのタイトル
workspace: project-alpha
tags: [tag1, tag2, tag3]
created: 2026-03-13
updated: 2026-03-13
---
# ノートのタイトル
本文...
ファイル名規則
{YYYY-MM-DD}-{slug}.md（例: 2026-03-13-api-design-notes.md）- 会議メモ:
{YYYY-MM-DD}-meeting-{topic}.md
- 参照情報（日付に依存しないもの）:
{slug}.md（例: aws-s3-tips.md）
操作フロー
1. ノートの保存・追記
ユーザーの入力 → ワークスペース確認 → ノート作成/追記 → INDEX更新 → MASTER更新 → git commit
手順:
pwd でKB_ROOTを確認し、git rev-parse --is-inside-work-tree で初期化済みか確認する- ワークスペースが未指定なら確認する
- 既存の関連ノートを検索（
grep -r）し、追記か新規作成かを判断
- ノートを書き込む（新規ならフロントマターを付与）
updated フィールドを今日の日付に更新- ワークスペースの
INDEX.md を更新
_index/MASTER.md を更新_index/tags.md を更新git add "{workspace}/" "_index/" && git commit -m "{type}: {概要}"
2. 検索・参照
ワークスペース内検索:
grep -r "キーワード" {KB_ROOT}/{workspace}/ --include="*.md" -l
横断検索（全ワークスペース）:
grep -r "キーワード" {KB_ROOT}/ --include="*.md" \
--exclude-dir=".git" -l
タグ検索:
grep -r "tags:.*{tag}" {KB_ROOT}/ --include="*.md" -l
検索後: ヒットしたファイルを読み込み、関連情報を整理して回答する。
3. 会議メモの構造化
ユーザーから生のメモ・テキストを受け取ったら、以下の構造に整形してから保存する：
---
title: MTG: {トピック}
workspace: {workspace}
tags: [meeting, {関連タグ}]
created: {date}
updated: {date}
---
# MTG: {トピック}
**日時**: {date}
**参加者**: {もしあれば}
## 議題
{箇条書き}
## 決定事項
{箇条書き}
## アクションアイテム
- [ ] {担当者}: {タスク}（{期限}）
## メモ・背景
{その他情報}
4. 整理・要約
特定のワークスペースまたはテーマについて情報を整理する場合：
- 関連ノートをすべて収集（grep or INDEXを参照）
- 重複・古い情報を特定
- 統合案をユーザーに提示してから実行
- 整理後はgit commit
5. 既存ファイルの取り込み
ユーザーが既存のMarkdownやテキストを渡した場合：
- フロントマターが未付与なら付与する
- ワークスペースを確認・設定
- ファイル名をルール通りにリネーム
{KB_ROOT}/{workspace}/ に配置- INDEX・MASTER・tagsを更新
- git commit
インデックスファイルの仕様
_index/MASTER.md
# Knowledge Base マスターインデックス
最終更新: {date}
## ワークスペース一覧
| ワークスペース | ノート数 | 最終更新 | 説明 |
|---|---|---|---|
| [project-alpha](../project-alpha/INDEX.md) | 12 | 2026-03-13 | クライアントAのプロジェクト |
| [internal](../internal/INDEX.md) | 5 | 2026-03-10 | 社内情報 |
## 最近更新されたノート（全体）
- 2026-03-13 [タイトル](../workspace/note.md) `workspace` #tag1 #tag2
{workspace}/INDEX.md
# {Workspace} インデックス
最終更新: {date}
## ノート一覧
| ファイル | タイトル | 更新日 | タグ |
|---|---|---|---|
| [note.md](./note.md) | タイトル | 2026-03-13 | #tag1 #tag2 |
_index/tags.md
# タグ一覧
| タグ | 件数 | 関連ノート |
|---|---|---|
| meeting | 8 | [リスト] |
| aws | 3 | [リスト] |
Git運用ルール
- commit message形式:
{type}: {概要}
feat: 新規ノート作成update: ノート追記・編集refactor: 整理・統合index: インデックスのみ更新import: 既存ファイル取り込み
- remoteはなし:
git remote は設定しない。既存リポジトリにリモートがある場合は、KB操作後に意図しない git push が行われないよう注意すること
- 毎操作後にcommit: ユーザーが明示的に「まとめてcommitして」と言わない限り、操作ごとにcommitする
- ステージング範囲の限定:
git add -A は使用せず、git add "{workspace}/" "_index/" のようにKB関連ディレクトリのみをステージングする
初回セットアップ手順
Gitリポジトリが未初期化の場合（git rev-parse --is-inside-work-tree が失敗）:
- ユーザーに「現在のディレクトリ（
{pwd}）をナレッジベースとして初期化しますか？」と確認する
- 確認が取れたら以下を実行:
mkdir -p _index
git init
git commit --allow-empty -m "init: knowledge base"
_index/MASTER.md と _index/tags.md の初期ファイルを作成- 完了をユーザーに報告し、最初のワークスペース名を確認する
既存Gitリポジトリ内で使用する場合（git: initialized かつ kb: not ready）:
- リモートの有無を確認し、リモートがある場合はKBファイルをコミットしてよいかユーザーに確認する
_index/MASTER.md と _index/tags.md を作成- KB関連ファイルのみをステージングしてcommit
注意事項
- 情報の混在防止: ワークスペースが未指定の操作は必ず確認してから実行する
- 破壊的操作の確認: ノートの削除・大幅な書き換えは事前にユーザーに確認する
- ファイルサイズ: 1ノートが500行を超えたら分割を提案する
- 機密情報: ローカルのみで完結しているが、スクリーンショット等での漏洩リスクをユーザーが認識していることを前提とする
