connect

name	connect
description	TwinMind link engine for manual connections. Use when the user explicitly asks to link or unlink two specific cards (e.g. '把 X 和 Y 連起來', 'link X to Y', 'disconnect X from Y'). Handles relationship type classification, bidirectional link writing, and index updates. Not for automatic link inference during card creation — that's handled by twinmind:capture.
license	MIT
metadata	{"author":"twinmind","version":"1.0"}

處理使用者明確要求的手動連結操作——建立或解除兩張卡片之間的連結。與 twinmind:capture 的自動連結推理不同，這裡是使用者主動指定要連結哪兩張卡片。

關係類型、分類規則、Connections 格式和反向對照表的完整定義，請讀取 twinmind:capture skill 的 references/link-inference.md (與 capture 共用同一套連結系統；該 references 檔案位於 plugin 內，可從 .claude/twinmind/config.json 的 pluginRoot 取得 plugin 路徑後再讀)。

一致性驗證由 PostToolUse hooks 自動處理。完成操作後透過 Bash tool 執行 node .claude/twinmind/bin/tm-post-op.mjs --layer knowledge 觸發 post-op pipeline。

Post-op 執行方式

透過 Bash tool 執行：

node .claude/twinmind/bin/tm-post-op.mjs --layer knowledge --event '{"event_type":"<LINK_CREATED|LINK_REMOVED>","event_context":{"source_title":"<title>","target_title":"<title>","relation":"<type>","domains":["<domain>"]}}'

腳本同步執行。exit code 0 成功，exit code 1 失敗（stderr 印出錯誤訊息）。

啟動後立即回應使用者。Subagent 執行 changelog（append-only 至 changelog-YYYY-MM.md）+ MOC 閾值檢查（使用 payload config 和 domain_counts，不重新讀取 config.md 或 vault-index.json）+ Home.md 重建（使用 payload recent_notes，不重新讀取 vault-index.json 取最新卡片）。

建立連結

當使用者要求連結兩張卡片時（如「把 Rust Ownership 和 RAII 連起來」）：

1. 從 vault-index.json 的 notes 以 title/keyword 找到兩張目標卡片
2. 找不到任一卡片 → 回報「未找到匹配的卡片」，列出可能候選
3. 關係類型判斷：
   • 使用者指定了（如「關係是 analogous」）→ 使用指定類型
   • 未指定 → 依 twinmind:capture skill 的 references/link-inference.md 的分類優先序自動推斷
4. 說明文字：使用者提供則用，未提供則 AI 生成一句話
5. 執行連結建立程序 (見 twinmind:capture skill 的 references/link-inference.md 的「建立連結程序」)：

   • Connections 格式：- <符號> [[<slug>|<title>]] — <一句話說明為何連結>（slug 為目標卡片檔名，不含 .md）

   • 寫入源卡片 ## Connections（移除 placeholder 若有）

   • 寫入目標卡片反向連結（依反向對照表）

   • 透過 Bash tool 執行程式化索引更新（不得直接 Edit vault-index.json）：

     node .claude/twinmind/bin/tm-update-index.mjs add-link '{"source":"<source_id>","target":"<target_id>"}'
     

     腳本自動處理：雙向更新 links_to/linked_from、重算兩方 link_count、遞增 stats.total_links、更新 stats.last_updated

6. 執行 post-op（Bash tool，node .claude/twinmind/bin/tm-post-op.mjs --layer knowledge --event '...'，event_type: LINK_CREATED）

解除連結

當使用者要求解除兩張卡片的連結時：

1. 從 vault-index.json 找到兩張目標卡片
2. 確認存在連結（檢查 links_to/linked_from）
3. 無連結 → 回報「這兩張卡片之間沒有連結」
4. 執行移除：
   • 從源卡片 ## Connections 移除含目標卡片 wiki-link 的行。若移除後無連結，恢復 （尚無連結）
   • 從目標卡片 ## Connections 移除含源卡片 wiki-link 的行。同上
   • 更新 vault-index.json（單次 Edit）：old_string 涵蓋源 note entry、目標 note entry 和 stats 物件的連續 JSON 區塊；new_string 包含移除連結後的完整版本（links_to/linked_from 移除對應 ID、重算兩方 link_count、重算 stats.total_links、更新 stats.last_updated）。此操作 SHALL 為單次 Edit tool invocation
5. 執行 post-op（Bash tool，node .claude/twinmind/bin/tm-post-op.mjs --layer knowledge --event '...'，event_type: LINK_REMOVED）