SungFeng-Huang
UserLearn research the Hung-yi Lee way 📚 Teaching-style research-card automation — plain .md / Obsidian / Heptabase backends (bidirectional sync), driveable by Claude Code or Codex
Categories
Indexed Skills (17)
overview-graph
Maintain the study/overview knowledge graph in Heptabase: the hierarchy (📚 root index → topic hubs → comparison cards, Level property = tree depth), the lateral edges (相關主題（橫向連結） mention sections, ↔/→ direction semantics), the knowledge-map whiteboard, hub creation, and hung-yi-lee narrative-act card re-splits when a card nears the 100K cap or its taxonomy stops matching the story. Use when the user asks to 新增/調整 hub、拆卡/重分 overview、加/改 graph 邊 or 橫向連結、調 Level/目錄/知識地圖 whiteboard、或稽核 knowledge graph 一致性.
project-card-log
From a project-wise session, find THIS project's Heptabase card and log progress as SELF-CONTAINED log cards — weekly reports to the project lead/mentor: each log event becomes its own card (前情提要 recap that needs no back-reading, what was done, results with explained metrics, what it means, decisions pending — no unexplained abbreviations), and the project chain only gains one human-readable timeline line (📎 date [[card]] one-sentence summary) — the chain stays a readable project timeline for handoff (to the user, to the Mac, to the paper side). Auto-resolves which card via a per-repo .heptabase-card marker, then a registry (projects.json), then search. Use when the user says 補卡 / 記實驗 / log progress / 記進度 / handoff 實驗進度 / update my Heptabase project card / 把進度寫進 Heptabase. Transport: local `heptabase` CLI when available (Mac), else the `hb` bridge (remote over SSH).
project-card-merge
Consolidate a Heptabase research-project card on the Mac into a STANDALONE full report for the project lead (前情提要 + evolution story + current state — readable without session memory): fold the cluster's append-only `📥 cluster 補充/進度` blocks (and any `📝 待補成 paper 級參考` brief) into ONE focused, paper-grade, coherent card — update 現狀 to the latest state, supersede stale info, keep all paper-grade detail + figures + file citations + card-links, and remove the dated append shells. Also folds tail-appended `🔍` research-gap analysis sections (from overview-graph Operation 5) into the body after Findings, promoting actionable 發想 into 下一步 and verification-type 洞 into 待補. Chain-aware: collapses a continuation chain (entry→續卡, from append-side overflow) back into the merge, and when the merged result itself exceeds the card cap it spills whole sections into a fresh chain instead of condensing (finalize_chain) — paper-grade content is never trimmed to fit 100K. This is the Mac-only "final merge" that pairs with the clus
heptabase-sync
(formerly obsidian-sync) The heptabase segment engine of note-sync: block-level level-2 BIDIRECTIONAL sync between Heptabase and the local .md store (vault) — incremental forward mirror, block-level write-back against a ProseMirror snapshot (all-or-nothing per card), three-way property sync, adoption of hand-made .md files, deletion propagation into .trash/, and a conflict ledger (Sync Conflicts.md). Prefer invoking via note-sync (--mode heptabase); run standalone for cron or engine-level debugging. Use when the user asks to sync Heptabase cards to the vault/Obsidian, 同步卡片到 obsidian／vault, push paper/overview cards, or after batch edits in either app.
project-card-canvas
Generate and refresh the VISUAL views of a research-project card chain as Obsidian JSON Canvas files: the timeline canvas (git-graph style — log cards as a commit column, the entry card as the HEAD pointer riding beside the newest distilled log with the 📎 backlog stacking above it, colored by origin machine by default) and the context mind map (three decomposition modes: logs = per-log-card subtrees hung on the 前情提要 citation graph; chain = the chain body's H2/H3 sections; story = the research NARRATIVE as a staged, multi-row DAG — the agent reads the chain and authors a story graph JSON of ideas→experiments→results→pivots with causal edges, the script renders it deterministically). Use when the user asks to 畫/更新/刷新 project canvas、心智圖、脈絡圖、敘事圖、研究故事圖、 mind map、story graph、timeline 圖, or after project-card-log / project-card-merge runs (refresh the views). Mac-only (heptabase CLI + local vault; backend=both).
project-card-repair
Repair broken card links in Heptabase project + project/progress cards — the dead plain-text `[[card:UUID]]` literals left by a `hb` bridge append (remote cluster) or a bare CLI append, which the heptabase CLI never renders into a real, clickable card-mention. Seals three header/timeline shapes back into live mentions: a log/progress card's `專案：[[card:…]]` back-ref to its project, a project card's `📎 date [[card:…]]` timeline line to a log, and a continuation child's `母卡：[[card:…]]` back-ref to its entry. Given card id(s) it repairs just those; given nothing it sweeps every project + progress card. Use when the user says 修卡片 link / 卡片連結斷了 / log 卡指回 project 斷了 / timeline 連結壞掉 / repair/seal project card links / 專案回指 變成純文字 / 掃全部修卡片連結. Mac-only (local heptabase CLI). Sentinels (▶續卡 chain edges) are left to project-card-log/repair_chain.py --seal unless --include-sentinel is passed.
card-rewrite
Rewrite a Heptabase paper card into the "teaching-style" format — written to onboard the reader configured at config profile.reader — assumed NOT an expert in that paper's subfield: a one-line essence + why-you-should-read framing, a 先備知識 glossary that defines the jargon in plain language, teaching prose that explains the WHY (not just the what), bilingual terms (English kept alongside Chinese), a filled-in 快速摘要, preserved figures, and re-applied colorization. Use when the user asks to rewrite / 重寫 / 教學式 / upgrade a paper card, or to retrofit existing cards in batches. The gold reference is the card configured at config `gold_cards.card_rewrite`（未設定時以本 skill 的 teaching_spec.md 為準）.
obsidian-sync
Level-1 Heptabase → Obsidian sync for the Study vault: one-way incremental body sync (Heptabase is source of truth) plus bidirectional property sync (Status/Tasks/Topics/Note/...) for the study/paper (Source Type=alphaXiv) and study/overview collections. Card links between synced cards become [[wikilinks]]; links to non-synced cards keep Heptabase URLs. Use when the user asks to sync Heptabase cards to Obsidian, 同步卡片到 obsidian, push paper/overview cards to the vault, or after batch edits in either app.
overview
Maintain ALL Heptabase comparison-overview card families with one skill — tokenizer/codec, spoken-LM/speech-LLM (nesting the auditory 聽覺理解・推理 sub-topic: audio understanding/reasoning/audio-LM 驗收), duplex S2S, 語音生成 (TTS family), ASR (non-LLM), and speech frontend/security. Find newly Tasks-tagged papers an overview is missing, route each to the right topic and act card, author a hung-yi-lee-style section + dimension row + paradigm/synthesis updates, re-sort by arxiv ID, refresh the 導讀, and keep the knowledge graph bookkeeping green. Use when the user asks to update/sync/補/re-sort ANY comparison overview card (任何主題的 overview 卡).
scholar-inbox-clip
Read all unread Scholar Inbox emails from Mac Mail.app (Scholar Alert Digests and Trending Papers), fetch each paper's AI overview from alphaXiv (or fall back to the raw paper), translate to the configured output language (default Traditional Chinese), apply color highlights, and create Heptabase cards. Use when the user asks to process Scholar Inbox papers, clip papers from alphaXiv, or update Heptabase with new research. Invoked with NO paper URL, it instead runs a BACKFILL maintenance pass: find existing alphaXiv cards whose Tasks property is empty (an automated run may have skipped semantic tagging), annotate them, and re-sync the affected comparison-overview cards. An explicit "re-audit" / 「重審 Tasks」 ask runs the RE-AUDIT pass instead: semantic review of already-set Tasks values, proposing mis-tag removals for user approval.
hackmd-sync
Mirror research-cards collections to HackMD (the plugin's third note surface, aimed at sharing/publishing): incremental forward sync from the active backend (heptabase/obsidian/both) into HackMD folders with real note-to-note links, plus OPTIONAL level-2 write-back (config hackmd.write_back) — HackMD-side edits on owner-writable notes merge back into the vault paragraph-by-paragraph; shared-writable notes and two-sided edits stay conflicts. Use when the user asks to sync/publish cards to HackMD, 同步到 HackMD、把總覽卡發到 HackMD、鏡像到 hackmd、雙向同步 hackmd、check HackMD drift, or set up the hackmd section of the config.
setup
Interactive config wizard for research-cards: create, inspect, or adjust ~/.config/research-cards/config.json by interviewing the user against config.example.json's inline docs. Use when the user asks to set up / configure / initialize research-cards, 建立 config、設定 research-cards、調整設定、初始化、幫我設定、check my config, enable a backend (backends list: local/heptabase/hackmd), change the output language, or turn features on/off.
project-card-cleanup
Re-scope a project card CHAIN to its handoff role — 最高指導原則 + 實驗現狀紀錄 + 待辦 handoff — against an external authority layer (paper draft, .private/chapter-plan & evidence-map, or the axis card). Unlike project-card-merge (which FOLDS appends into the body), cleanup DISTILLS writing-phase appends, SUPERSEDES history pile-ups, and POINTERIZES content that now lives in the draft/plan/axis card, while preserving every experiment number, method record, figure, and card-link. Use when the user says 清理卡鏈 / cleanup 專案卡 / 卡鏈瘦身 / 讓卡回到指導原則 / handoff 化, typically during paper-writing periods when cards accumulate both cluster experiment appends and Mac-side planning appends. Consolidated (needs_merge=false) chains are VALID targets — this is a re-scoping, not a marker-driven merge.
bib-export
Export official BibTeX for all papers a Heptabase/Obsidian card links to — read the anchor card's card-links, resolve each linked paper card's arxiv ID property, and fetch entries from official sources only (Semantic Scholar / arxiv.org/bibtex / ACL Anthology .bib / OpenReview). Never fabricates an entry: unresolved papers become TODO comments. Use when the user asks to 匯出 BibTeX / 產生 .bib / export references / citations for an overview card, a project card, or a set of paper ids.
overview-daodu
Add or refresh a Hung-Yi-Lee-style teaching 導讀 (narrative intro) at the top of a Heptabase comparison/overview card — weaving the papers the card lists into ONE evolution thread with a punchline, grounded ONLY in the card's own content. Idempotent: re-running updates the existing 導讀 in place instead of duplicating. Use when the user asks to add/update/refresh a 導讀 / 教學導讀 / 導言 / teaching intro on an overview card (Tokenizer/Codec, Spoken LM, Reasoning, Duplex S2S, Audio Understanding, …).
research-campaign
Scaffold and drive autonomous research-experiment campaigns: a MISSION.md brief that lives IN the target repo (runs/auto_research/), a persistent experiment ladder (queue.json) and results ledger (ledger.jsonl), hard measurement discipline (significance gating, representative eval slices, one change per rerun), and research-cards integration (project card bootstrap + Op5 gap-analysis pre-read + per-job progress append). Use when the user wants to 開/設定一個研究實驗 campaign for a repo, 接續/continue a campaign job, or asks campaign 進度/status. This skill owns the FORMAT and BOOKKEEPING — the agent executes experiments by following the repo's MISSION.md, and hyperparameter decisions defer to an alchemist-playbook style source-cited advisor when available.
note-sync
ONE entry point for the note-surface STAR: local (plain .md) is always the hub, every enabled surface (Heptabase, HackMD, …) syncs over its own local↔surface segment per the config backends list (first = canonical). Converges HackMD write-backs onto Heptabase in the same run and aggregates all segments' conflicts into one report. --mode heptabase|hackmd runs a single segment (obsidian is the accepted legacy alias). Use when the user asks to sync notes / sync everything / 同步筆記、全部同步、跑同步、note sync、把三方筆記收斂, or any request naming the legacy obsidian-sync / hackmd-sync engines.
Bio shown is the top-scored skill's repo description as a fallback — real GitHub bios land in a future update.