obsidian
/obsidian — Vault週次整理コマンド
ユーザー(大串)の入力:$ARGUMENTS
このコマンドの目的
Vault は自動更新でどんどん情報が溜まる。溜まるほど 整理の重要性が上がる。
第二の脳として機能させる=「見やすく・必要な情報をすぐ取り出せる」状態を保つこと。
このコマンドは 週1で Vault を棚卸し し、以下を一気に整える:
- 移動(場所が不適切なノートを適材適所へ)
- 削除/アーカイブ(重複・完了済み一時ファイル・競合コピー)
- 統合(同テーマで分散したノートを1つにまとめる)
- 追記・補完(情報が足りないノートを充実)
- MOC/Hub リンク追加(新ノートが索引から辿れるように)
絶対原則:スキャン → 提案 → 大串が意思決定 → 一気に実行
勝手に移動・削除しない。必ず提案して大串の承認を得てから実行する。
[/obsidian]
↓
① スキャン(読み取り専用・一切変更しない)
↓
② 提案を番号付きで提示(移動/削除/統合/追記/MOC追加 をカテゴリ別)
各項目に「現在 → 提案先」「理由」「推奨」を明記
↓
③ 大串が意思決定(「全部OK」「A1 A2 B3 だけ」「C1は却下」「修正して」等)
↓
④ バックアップ(tar.gz)してから、承認分だけ一気に実行
↓
⑤ 完了レポート + Daily にログ + MOC/Hub 更新
① スキャン手順
- まず機械スキャンを実行(読み取り専用):
bash bash ~/Obsidian/scripts/vault_audit_scan.sh - 出力の 9カテゴリ(v2) を読む:
- [1]ゴミ・競合コピー / [2]🆕孤児ノート(索引から辿れない)/ [3]🆕古い情報シグナル(要確認/TBD/仮)/ [4]🆕使い捨て成果物(メール文面等)/ [5]🆕曖昧名リネーム候補 / [6]Inbox滞留 / [7]フォルダ密度 / [8]古い作業ログ / [9]FM欠如 - 疑わしい候補だけ を実際に Read して中身を精査(全1900ファイルは読まない)。特に [3]古い情報は「未入力チェックリストの"要確認"」など正当なケースを除外する
- 必要なら
Exploreサブエージェントで「同テーマの意味的重複」を広く探す(thoroughモード時) - 配置の正解判断には 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回):
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整理"でも復元点を作れる。 - 承認された項目を カテゴリ順に一気に実行:
- 移動:mv(移動先フォルダが無ければmkdir -p)
- 削除→Archive:50_Archive/_整理アーカイブ/YYYY-MM-DD/にmv
- 完全削除:rm(大串が明示的に「完全削除」と言った項目のみ)
- 統合:統合先に全内容マージ(Edit/Write)→ 元ファイルを Archive へ
- 追記:Read → Edit
- MOC/Hub:該当 MOC・SCALE_Hub に wikilink 追加 - 移動・統合したらリンク切れチェック:
bash # 移動したファイル名が他ノートから <span class="wikilink-dead">旧パス</span> で参照されてないか grep -rl "\[\[旧ファイル名" ~/Obsidian/SCALE-Brain --include="*.md"
参照があれば新パスに更新する(リンク切れを残さない)。 - 同期:
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)を移動・削除
- リンク切れを放置する(移動後に必ず参照チェック)
- 一度に大量を勝手に進める(提案→承認のループを守る)
関連
- スキャンスクリプト:
~/Obsidian/scripts/vault_audit_scan.sh - 詳細仕様: 90_Meta/Vault週次整理システム
- 配置の正解: 31_システム開発部/_SCALE_全システム配置マップ
- 整理先候補: SCALE_Hub / 90_Meta/MOC_マニュアル
- バックアップ先:
~/scale-vault-backups/