project-card-merge

Solid

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

Code & Development 3 stars 0 forks Updated today MIT

Install

View on GitHub

Quality Score: 79/100

Stars 20%
20
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# Project Card Merge — consolidate cluster-appended progress (Mac-side) ## Backend 卡片讀寫經由 rewrite_lib 路由(obsidian 模式可用),但 Research-Projects hub 的 card id 為 Heptabase UUID——obsidian 模式需改用 vault 內對應卡的 id。主要工作流仍以 heptabase/both 為準。 The cluster session appends dated `📥 cluster 補充/進度 YYYY-MM-DD` blocks to a project card via the `hb` bridge (append-only — it cannot overwrite). This skill is the **Mac-side counterpart**: it merges those blocks (and any leftover `📝 待補成 paper 級參考` brief) back into one coherent, focused, paper-reference-grade card. Three-layer principle (same as the cards already follow): **card = synthesis + 發想; raw logs stay in the codebase; keep paper-grade detail but no append sprawl.** Mechanics live in `card-rewrite`'s `rewrite_lib` (builders + `finalize`); this skill's `merge_lib` adds the Research-Projects index, a merge-readiness scan, and a table builder. ```python import sys, os; sys.path.insert(0, os.environ.get("CLAUDE_PLUGIN_ROOT", os.path.expanduser("~/.claude/skills/research-cards")) + "/skills/project-card-merge") import merge_lib as M # M.L is rewrite_lib ``` ## Step 1 — Pick the target card(s) ```bash python3 ${CLAUDE_PLUGIN_ROOT:-$HOME/.claude/skills/research-cards}/skills/project-card-merge/merge_lib.py # list project cards + which NEED MERGE python3 ${CLAUDE_PLUGIN_ROOT:-$HOME/.claude/skills/research-cards}/skills/project-card-merge/merge_lib.py <cardId> # scan one (appended blocks, brief, size, figs) ``` - If the user n...

Details

Author
SungFeng-Huang
Repository
SungFeng-Huang/research-cards
Created
3 weeks ago
Last Updated
today
Language
Python
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Listed

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.

3 Updated today
SungFeng-Huang
Data & Documents Solid

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).

3 Updated today
SungFeng-Huang
AI & Automation Solid

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.

3 Updated today
SungFeng-Huang