do.teach-me

Teach Me — Vault Knowledge Export

DeepOrbit and teach-me are siblings: DeepOrbit manages the knowledge vault; teach-me turns work into a learner portrait and knowledge tree. This skill exports vault knowledge into teach-me with provenance — imported notes carry an origin block so they never mix with knowledge teach-me accumulates natively.

Workflow

1. Check teach-me is installed. The bridge needs teach_me.py. Resolution order: --script flag → $TEACH_ME_SCRIPT → common install locations (~/.claude/skills/teach-me/…, ~/.agents/…, ~/.codex/…, ~/.omp/…). If missing, tell the user to install teach-me-skill first.

1. Confirm scope with the user. Default export dirs are knowledge-only: 40_Wiki, 60_Notes, 30_Research. Opt-in additions: 15_Writings, 20_Projects. 70_Family is private — export it only on explicit request. Read-only zones (e.g. 60_Notes/微信读书) are always skipped: the upstream sync owns them.

2. Run the export:

   deeporbit --vault . teach-me export [--dirs 40_Wiki 60_Notes 30_Research 15_Writings]
   

   The command stages the notes, runs teach_me.py import --source obsidian, and returns JSON: origin (provenance block), prompt_for_ai (distillation instructions), deeporbit.exported_notes, and teach-me's note_paths/text_preview.

3. Distill into teach-me. Follow prompt_for_ai: for each important knowledge point, call teach-me's capture or assess — and pass the origin object verbatim at the top level of every payload. This is what keeps imported knowledge distinguishable (note frontmatter gets origin: import, imported_from, import_id; concept state and knowledge-tree nodes store the block; provenance is first-wins).

4. Report. Summarize: how many notes were exported, which dirs, the import_id, and how many knowledge points were captured/assessed. Suggest a re-export cadence (e.g. monthly, or after big research pushes) — repeat imports are safe because teach-me skips its own type: teach-me/* notes and merges concepts by title.

Guardrails

• NEVER drop the origin block from capture/assess payloads after an export.
• NEVER export read-only zones or 70_Family unless the user explicitly asks.
• The export reads the vault; it writes nothing into it.