菜单
Periodic structural cleanup. Detects when files are too large, themes are emerging, or content is stale, and proposes restructuring. Triggers on user request "maintain the vault" / "clean up", or auto-suggested when last maintenance > 7 days. Always proposes before acting.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Web-search for new domain knowledge relevant to the current coach's user, filtered by level, current focus, and open gaps. Propose findings as vocabulary additions, session topics, or program adjustments. Triggered on user request "research for me", "what's new in [domain]?", "learn something", or automatically by the weekly Sunday research scheduled job.
Scan vault files across People, Places, Restaurants, Events, and coach folders to find missing wikilinks between related files, and propose adding them. Triggered on user request "find links", "cross-link vault", "what connects to X?", or periodically after inbox-triage runs.
Process vault root Inbox.md entries and route each one to its proper home — People, Places, Restaurants, Events, coach folders, or Ideas. Triggered on user request "triage inbox", "process inbox", "clean up inbox", or when Inbox.md exceeds ~30 lines.
End-to-end creation of a new coach. Asks for domain and name, scaffolds local files from domain template, creates Drive folders, adds shell alias, runs onboarding interview, generates initial snapshot, outputs system prompt for phone Claude.ai project. Triggers on "spawn coach" / "create [domain] coach" / "add a [domain] coach".
Per-coach self-review. Every ~10 sessions, the coach reads its own session history and proposes content extractions, vocabulary additions, profile refinements, and structural changes. Triggers on user request "evolve this coach" or auto-suggested after threshold.
Generate a comprehensive snapshot from current local canonical state and upload to Drive as a new dated file. Triggered at end of substantive coach conversations, or on user request "save", "sync to Drive", "push snapshot".
| name | vault-maintain |
| description | Periodic structural cleanup. Detects when files are too large, themes are emerging, or content is stale, and proposes restructuring. Triggers on user request "maintain the vault" / "clean up", or auto-suggested when last maintenance > 7 days. Always proposes before acting. |
Keeps the vault fast and meaningful as it grows. Detects accumulating issues, proposes restructurings, executes after user approval. Never silent.
~/.cache/vault-last-maintenance.json shows >7 days since last maintenanceweekly-review skill as part of Sunday reviewThe skill scans for these triggers:
| Trigger | Threshold | Proposed action |
|---|---|---|
| Unprocessed inbox files in Drive | >0 | Run vault-pull-inbox |
| >3 inbox entries today, day not yet consolidated | end of day | Run daily-consolidate |
sessions.md line count | >60 entries (configurable) | Archive oldest quarter to sessions/<quarter>.md |
vocabulary.md entries | >25 (configurable) | Propose split by category |
| Repeated topic in inbox/sessions | 3+ entries on same theme over 4 weeks | Propose dedicated file (e.g., progressions/<topic>.md) |
| Latest snapshot age | >30 days | Force regenerate via vault-push-snapshot |
| Drive inbox folder file count | >50 per coach | Suggest manual cleanup via Drive web (or filesystem delete if Drive Desktop installed) |
| Open profile gaps | unfilled >14 days | Resurface to user during conversation |
| Daily/ entries | untouched >30 days | Suggest archive to Archive/Daily/<year>/ |
| Stale ideas | files in Ideas/ untouched >90 days | List and ask user: develop, archive, or delete |
| Stale projects | files in Projects/ with no recent activity | List and ask |
| Coach without sessions in 60+ days | inactive | Suggest retire (call retire-coach) |
| Snapshot file size | >10 KB | Compress (older sessions → titles only; vocab → category list) |
~/.cache/vault-last-maintenance.json — if exists, get last_run timestamp; otherwise treat as "never run"## Vault Maintenance Report (2026-05-15)
Last maintenance: 9 days ago.
### Recommended actions
1. [vault-pull-inbox] 3 unprocessed phone inbox files for pole — integrate now?
2. [archive-sessions] sessions.md has 67 entries — archive Q1 (2026-01..2026-03)?
3. [extract-progression] You've mentioned "shoulder mount" 5 times in last 3 weeks — extract to progressions/shoulder-mount.md?
4. [split-vocab] vocabulary.md has 28 entries — split into vocab/inverts.md, vocab/holds.md, vocab/grips.md?
5. [resurface-gap] Profile gap "specific 6-month wishlist moves" has been unfilled 27 days — surface to user?
### Skipped
- Snapshot is 14 days old (regenerate threshold = 30 days) — OK
- Drive inbox at 12 files (threshold = 50) — OK
Reply with the numbers you want to apply (e.g., "1, 2, 4" or "all"), or "no" to skip.
~/.cache/vault-last-maintenance.json with current timestamp + actions takenCoaches/<coach>/sessions/<YYYY-Qn>.md with archived entriesCoaches/<coach>/vocab/<category>.md filesCoaches/<coach>/progressions/<topic>.mdvault-push-snapshot skill with smaller summary mode~/.cache/vault-last-maintenance.json~/.cache/vault-processed-inbox.jsonVault/.claude/drive-config.json~/.cache/vault-last-maintenance.jsonprogressions/ folder if user hasn't seen it)Thresholds live in Vault/.claude/maintain-config.json. All fields are optional — omit a field to use its default.
{
"version": 1,
"sessions_archive_threshold": 60,
// Line-count in sessions.md before archiving oldest quarter.
// Lower = more aggressive archiving. Default: 60.
"sessions_archive_unit": "entries",
// "entries" (count ## headings) or "lines". Default: "entries".
"vocab_split_threshold": 25,
// Entry count in vocabulary.md before proposing category split. Default: 25.
"theme_extraction_min_mentions": 3,
// How many session/inbox mentions of a topic over the look-back window
// before proposing a dedicated progression/theme file. Default: 3.
"theme_extraction_window_days": 28,
// How many days to look back when counting mentions. Default: 28 (4 weeks).
"snapshot_max_kb": 10,
// Hard cap for context snapshots. Used by compress-snapshot action. Default: 10.
"snapshot_age_force_regen_days": 30,
// Days since last push before force-regenerate is proposed. Default: 30.
"inbox_drive_cleanup_threshold": 50,
// File count in Drive inbox folder before cleanup is suggested. Default: 50.
"inbox_consolidate_threshold": 3,
// Unprocessed inbox entries in one day before daily-consolidate is proposed. Default: 3.
"profile_gap_resurface_days": 14,
// Days an unfilled profile gap stays quiet before it gets resurfaced. Default: 14.
"daily_archive_after_days": 30,
// Days since last touch before a Daily/ entry is suggested for archiving. Default: 30.
"ideas_stale_after_days": 90,
// Days untouched before an Ideas/ file appears in stale list. Default: 90.
"projects_stale_after_days": 60,
// Days with no activity before a Projects/ file appears in stale list. Default: 60.
"coach_inactive_after_days": 60,
// Days with no sessions before retire-coach is suggested. Default: 60.
"auto_suggest_after_days": 7
// Days between auto-suggestions at session start. Default: 7. Set 0 to disable.
}
Any coach can override global thresholds in Coaches/GetBetterAt<Name>/.maintain-config.json. Same schema; only fields present are overridden.
Example — a writing coach where pieces accumulate slowly (don't archive aggressively):
{
"sessions_archive_threshold": 120,
"coach_inactive_after_days": 90
}
Example — a daily-use fitness coach where inbox is high-volume:
{
"inbox_drive_cleanup_threshold": 20,
"inbox_consolidate_threshold": 2,
"snapshot_age_force_regen_days": 7
}
Vault/.claude/maintain-config.json (global overrides)Coaches/<coach>/.maintain-config.json (per-coach overrides)Each level overrides the previous; unset fields fall back to the outer level.
Without maintenance, the vault drifts:
Vault-maintain is the system's immune response. Run it weekly and the system stays sharp.