🤖 AI運用ルール

obsidian

最終更新 2026年06月30日 / 22_AI運用ルール/コマンド集/obsidian/obsidian.md

/obsidian — Vault週次整理コマンド

ユーザー(大串)の入力:$ARGUMENTS


このコマンドの目的

Vault は自動更新でどんどん情報が溜まる。溜まるほど 整理の重要性が上がる
第二の脳として機能させる=「見やすく・必要な情報をすぐ取り出せる」状態を保つこと。

このコマンドは 週1で Vault を棚卸し し、以下を一気に整える:
- 移動(場所が不適切なノートを適材適所へ)
- 削除/アーカイブ(重複・完了済み一時ファイル・競合コピー)
- 統合(同テーマで分散したノートを1つにまとめる)
- 追記・補完(情報が足りないノートを充実)
- MOC/Hub リンク追加(新ノートが索引から辿れるように)


絶対原則:スキャン → 提案 → 大串が意思決定 → 一気に実行

勝手に移動・削除しない。必ず提案して大串の承認を得てから実行する。

[/obsidian]
   ↓
① スキャン(読み取り専用・一切変更しない)
   ↓
② 提案を番号付きで提示(移動/削除/統合/追記/MOC追加 をカテゴリ別)
   各項目に「現在 → 提案先」「理由」「推奨」を明記
   ↓
③ 大串が意思決定(「全部OK」「A1 A2 B3 だけ」「C1は却下」「修正して」等)
   ↓
④ バックアップ(tar.gz)してから、承認分だけ一気に実行
   ↓
⑤ 完了レポート + Daily にログ + MOC/Hub 更新

① スキャン手順

  1. まず機械スキャンを実行(読み取り専用):
    bash bash ~/Obsidian/scripts/vault_audit_scan.sh
  2. 出力の 9カテゴリ(v2) を読む:
    - [1]ゴミ・競合コピー / [2]🆕孤児ノート(索引から辿れない)/ [3]🆕古い情報シグナル(要確認/TBD/仮)/ [4]🆕使い捨て成果物(メール文面等)/ [5]🆕曖昧名リネーム候補 / [6]Inbox滞留 / [7]フォルダ密度 / [8]古い作業ログ / [9]FM欠如
  3. 疑わしい候補だけ を実際に Read して中身を精査(全1900ファイルは読まない)。特に [3]古い情報は「未入力チェックリストの"要確認"」など正当なケースを除外する
  4. 必要なら Explore サブエージェントで「同テーマの意味的重複」を広く探す(thoroughモード時)
  5. 配置の正解判断には 31_システム開発部/_SCALE_全システム配置マップ や各部署の構造を参照

引数モード

引数 動作
なし 標準スキャン(機械スキャン + 主要カテゴリ精査)
quick 競合コピー・Inbox滞留・極小ファイルだけ(軽量・5分)
deep / thorough Explore agent も使い意味的重複・統合候補まで深掘り
<フォルダ名> そのフォルダ/部署だけを集中整理(例:/obsidian 31_システム開発部

② 提案フォーマット(必ずこの形で提示)

カテゴリ別・番号付き(A/B/C/D/E + 連番)。各項目に推奨マークを付ける

##  A. 移動(場所が不適切)
| # | ファイル | 現在地 → 提案先 | 理由 | 推奨 |
|---|---|---|---|---|
| A1 | xxx.md | 00_Inbox/ → 31_システム開発部/ | システム作業ログ |  |

##  B. 削除/アーカイブ候補
| # | ファイル | 理由 | 推奨 |
|---|---|---|---|
| B1 | xxx 2.md | Drive競合コピー(本体と重複)|  削除 |
| B2 | yyy.md | 完了済み一時メモ・統合済み |  Archive |

##  C. 統合候補(重複→1つにまとめる)
| # | 統合対象 | 統合先 | 理由 | 推奨 |
|---|---|---|---|---|
| C1 | a.md + b.md + c.md | → a.md に集約 | 同テーマが3分散 |  |

##  D. 追記・補完
| # | ノート | 追記する内容 | 推奨 |
|---|---|---|---|
| D1 | xxx.md | 古い数字を最新化 |  |

##  E. MOC/Hub リンク漏れ
| # | ノート | 追加先 | 推奨 |
|---|---|---|---|
| E1 | xxx.md | SCALE_Hub + MOC_マニュアル |  |

##  F. 孤児ノート(索引から辿れない=Claudeが見つけられない)
| # | ノート | 対処 | 推奨 |
|---|---|---|---|
| F1 | xxx.md | SCALE_Hub or 該当_READMEにリンク追加 / 不要ならArchive |  索引追加 |

##  G. 古い情報シグナル(更新漏れ・事故の元)
| # | ノート | 何が古い | 推奨 |
|---|---|---|---|
| G1 | xxx.md | 「要確認/仮/TBD」が放置 / 値上げ・改名の反映漏れ |  最新化 or 確認 |

G(古い情報)は精査必須。「未入力チェックリストの"要確認"」「設計中ノートの"TBD"」など正当なものは除外し、本当に更新漏れ・矛盾してるものだけ挙げる。ここが「間違った情報を自信満々に言う」事故を防ぐ最重要カテゴリ。

最後に必ず:

どう進めますか?
「全部OK」「A1 A2 B1 だけやって」「C1は却下」「B2はArchiveじゃなく完全削除で」「修正指示」など自由に。
承認分だけ、バックアップ取ってから一気に実行します。

提案を出す時の判断基準

  • 削除はデフォルト「50_Archive へ移動」(復元可能)。Drive競合コピー・明らかなゴミだけ「完全削除」を推奨してよい
  • 移動先は配置マップ・部署構造に厳密に従う(迷ったら提案に「?」を付けて大串に聞く)
  • 統合は元ノートの情報を1文字も失わない前提(統合先に全内容マージ → 元を Archive)
  • 保護対象は触らない_ 始まりの基準ノート / CLAUDE.md / 動き方ガイド / 配置マップ / 各 _README は移動・削除提案しない(追記提案はOK)
  • 件数が多い時は 重要度・効果の高い順 に並べ、上位20件程度に絞って提示(残りは「他N件あり」と明示)

④ 実行手順(承認後)

不可逆操作の前に必ずバックアップ。

  1. バックアップ作成(必須・最初に1回):
    bash TS=$(date +%Y-%m-%d_%H%M) mkdir -p ~/scale-vault-backups # 実体は ~/dev/scale-brain(~/Obsidian/SCALE-Brain はシンボリックリンク) tar -czf ~/scale-vault-backups/scale-brain_${TS}.tar.gz \ --exclude='.obsidian/workspace*' --exclude='.smart-env' --exclude='.git' \ -C ~/dev scale-brain
    ※ Vaultはgit管理(~/dev/scale-brain)なので、不安なら実行前に git -C ~/dev/scale-brain add -A && git commit -m "pre-obsidian整理" でも復元点を作れる。
  2. 承認された項目を カテゴリ順に一気に実行
    - 移動:mv(移動先フォルダが無ければ mkdir -p
    - 削除→Archive:50_Archive/_整理アーカイブ/YYYY-MM-DD/mv
    - 完全削除:rm(大串が明示的に「完全削除」と言った項目のみ)
    - 統合:統合先に全内容マージ(Edit/Write)→ 元ファイルを Archive へ
    - 追記:Read → Edit
    - MOC/Hub:該当 MOC・SCALE_Hub に wikilink 追加
  3. 移動・統合したらリンク切れチェック
    bash # 移動したファイル名が他ノートから <span class="wikilink-dead">旧パス</span> で参照されてないか grep -rl "\[\[旧ファイル名" ~/Obsidian/SCALE-Brain --include="*.md"
    参照があれば新パスに更新する(リンク切れを残さない)。
  4. 同期bash ~/Obsidian/scripts/sync_to_drive.sh(Drive反映)

⑤ 完了レポート + ログ

実行後:
1. 結果サマリを提示(移動N件 / 削除N件 / 統合N件 / 追記N件 / MOC追加N件)
2. 10_Daily/YYYY-MM-DD.md に「Vault整理ログ(/obsidian)」セクションを追記
3. バックアップ ID を明示(復元したい時のため)
4. 「次回 /obsidian は来週推奨」と一言


安全ルール(NG集)

やってはいけないこと
- スキャン中にファイルを変更する(①は完全読み取り専用)
- 大串の承認なしに移動・削除・統合を実行する
- バックアップ前に不可逆操作する
- 統合で元ノートの情報を削る(全マージしてから元をArchive)
- 保護ノート(_基準ノート/CLAUDE.md/配置マップ/動き方ガイド/各_README)を移動・削除
- リンク切れを放置する(移動後に必ず参照チェック)
- 一度に大量を勝手に進める(提案→承認のループを守る)


関連