project-card-loglisted

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).
SungFeng-Huang/research-cards · ★ 3 · Data & Documents · score 77

Install: claude install-skill SungFeng-Huang/research-cards

# Project Card Log — enrich THIS project's card from its codebase ## Transport（先確認用哪條路） ```bash command -v heptabase && heptabase --version # 本機有 CLI（Mac + desktop app）→ 直連 command -v hb # 否則走 hb bridge（遠端 session） ``` 指令對應（下文以 `hb` 示例；本機直連時換用右欄）： | bridge | 本機 CLI | |---|---| | `hb read <ID>` | `heptabase note read <ID>` | | `hb append <ID> "<md>"` | `heptabase note append <ID> -c "<md>"` | | `hb search "<q>"` | `heptabase card list -q "<q>" --limit 5` | | `hb log-exp …` | （bridge 專屬離線佇列；直連時用一般 append） | > ⚠️ 表中的 `append`／`log-exp --to` 都是**單卡低階指令**：卡片有續卡鏈時 > 它們直寫你給的那張卡（通常是 entry），內容會錯落在 sentinel 之後。 > 對專案卡寫進度**一律走 `append_card.py`**（自動 tail-walk）；已經錯落 > 的卡用 `repair_chain.py --card <ENTRY_ID>` 修（Mac-only，先 `--dry-run`）。兩條路都是 **append-only 的用法**：即使 CLI 支援 overwrite 也不要用—— enrichment 一律附加帶日期的新段落，合併整理交給 project-card-merge。 Each cluster session lives in one project's repo. This skill resolves the **matching Heptabase card** and appends codebase-grounded content to it via the `hb` bridge. The card is the synthesis/ideation + paper-reference layer; the raw logs stay in the repo (`CHANGELOG.md` / `NOTES.md` / sweep docs / wandb). > **`hb` is append-only** (the bridge exposes read + append/create, NOT overwrite > or todo-checking). So enrichment = **append a dated section**, never edit the > existing brief in place. The user tidies/merges later on the Mac. ## Step 1 — Resolve which card this project maps to ```bash python3 <此 skill 目錄>/re