| name | do.teach-me |
| description | Export DeepOrbit vault knowledge into the user's Teach Me learner vault with provenance tagging. Use when the user wants to import/sync vault knowledge into teach-me, grow their knowledge tree from existing notes, or asks about 联动 teach-me / 导入知识库 / learner portrait from vault content. |
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
-
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.
-
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.
-
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.
-
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).
-
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.
