LayeredKB

Personal Knowledge Base（PKB）のワークスペースを，役割ごとの レイヤー に分けて表示する VS Code 拡張機能です．

PKB を CLI エージェント（Claude Code など）と一緒に運用すると，ワークスペースには性質の異なるファイルが混在します． LayeredKB は開いているフォルダはそのままに，ユーザーが設定した層分けに従ってファイルやフォルダを 層ごとの独立したパネル に振り分けて表示します． フォルダ構成を変える必要はありません．

┌ LayeredKB ───────────────┐
│ ▾ スキーマ層          12  │  .claude/, CLAUDE.md, AGENTS.md ...
│ ▾ オントロジー層       3  │  *.csv
│ ▾ ナレッジベース層   148  │  *.md
│ ▾ Raw データ層       902  │  ~/Google Drive/PKB-raw（Git 管理外）
│ ▾ その他               7  │  上記以外
└──────────────────────────┘

機能

• レイヤーごとのパネル: アクティビティバーの LayeredKB アイコンを開くと，各レイヤーが独立したパネル（ビュー）として並びます．パネルのタイトルにファイル数を表示します． パネルはドラッグで並べ替え・エクスプローラーへの移動ができます．
• ワークスペース外フォルダ: レイヤーに roots を指定すると，Google Drive など Git 管理外のフォルダを走査してそのパネルに表示します．
• 標準エクスプローラーの装飾: 各ファイルに所属レイヤーのバッジ（S / O / K）と色を付けます（layeredkb.decorateExplorer で無効化可）．
• コンパクトフォルダー: 子が 1 つしかないフォルダーは a/b/c のように 1 行にまとめます．
• 自動更新: ファイルの追加・削除・設定変更を検知して再走査します（roots のフォルダも監視します）．
• ファイル操作: クリックで開く，右クリックで「横に開く」「エクスプローラーで表示」「OS で表示」「パスをコピー」．
• マルチルート対応: 複数のワークスペースフォルダはルート名を先頭に付けて表示します．

レイヤーのカスタマイズ

レイヤーは layeredkb.layers 設定で自由に定義できます（最大 8 個）．上から順に評価され，最初に一致したレイヤーが採用されます（first-match-wins）． roots を持つレイヤーは指定フォルダだけを走査し，ワークスペース内ファイルの分類には参加しません．

.vscode/settings.json の例（Raw データ層に Google Drive のフォルダを割り当てる）:

{
  "layeredkb.layers": [
    {
      "id": "schema",
      "label": "スキーマ層",
      "icon": "law",
      "badge": "S",
      "color": "charts.purple",
      "patterns": [".claude/**", "**/CLAUDE.md", "**/AGENTS.md", ".mcp.json"]
    },
    {
      "id": "ontology",
      "label": "オントロジー層",
      "icon": "type-hierarchy",
      "badge": "O",
      "color": "charts.orange",
      "patterns": ["ontology/**", "**/*.csv"]
    },
    {
      "id": "knowledge",
      "label": "ナレッジベース層",
      "icon": "book",
      "badge": "K",
      "color": "charts.blue",
      "patterns": ["**/*.md"]
    },
    {
      "id": "raw",
      "label": "Raw データ層",
      "icon": "database",
      "patterns": ["**/*"],
      "roots": ["~/Google Drive/PKB-raw", "../raw-data"]
    }
  ]
}

各レイヤーのフィールド:

その他の設定:

開発

npm install

VS Code でこのフォルダを開き，F5（Run Extension）で拡張機能ホストが起動します．

ディレクトリ構成

src/
├── extension.ts            # エントリポイント（ビュー枠・コマンド・装飾の登録）
├── layers.ts               # レイヤー定義・分類・ツリー構築（VS Code API 非依存）
├── config.ts               # 設定の読み込みと検証
├── workspaceIndex.ts       # ワークスペースと roots の走査，分類結果の保持
├── layerTreeProvider.ts    # 1 レイヤー分の TreeDataProvider
├── explorerDecorations.ts  # FileDecorationProvider
└── test/
    ├── extension.test.ts   # 統合テスト
    └── unit/               # 単体テスト

ビューは動的に追加できないため，package.json に 8 個のビュー枠（layeredkb.slot0〜slot7）を静的に宣言し，設定に応じてタイトルと表示/非表示を切り替えています．

公開

初回のみ: publisher と Personal Access Token の準備

1. Azure DevOps にサインインし，組織を 1 つ作ります（無ければ）．
2. 右上のユーザー設定から Personal access tokens を開き，次の設定でトークンを作ります．
   • Organization: All accessible organizations
   • Scopes: Custom defined → Marketplace: Manage
3. Marketplace の管理ページ で publisher を作ります． ID は package.json の publisher（del-taiseiozaki）と一致させてください．
4. GitHub リポジトリの Settings → Secrets and variables → Actions に，2 で作ったトークンを VSCE_PAT という名前で登録します．

リリース手順

package.json の version を上げて main にマージし，同じ番号のタグを push します． Release ワークフローがビルド・テスト・パッケージ・Marketplace 公開・GitHub Release 作成まで行います．

npm version patch          # 0.1.0 → 0.1.1（package.json を更新しコミットとタグを作る）
git push origin main --follow-tags

手元から直接公開する場合:

npx @vscode/vsce login del-taiseiozaki   # トークンを入力
npx @vscode/vsce package                 # .vsix を生成（内容確認用）
npx @vscode/vsce publish                 # Marketplace へ公開

公開後，Marketplace に反映されるまで数分かかります．