新 skill akashic-work-connected（akashic-discovery plugin）：依書目耦合與共被引找相似作品，庫內計算優先，產出附連結理由的候選清單、勾選才建檔

[kiki830621]

Blocked by #617
Blocked by #620

Problem

Original text:
「然後還要有一個找connected 的skill如何」
「兩張 issue 都開」
— Source: 使用者，2026-09-24（+08:00）對話

新增 skill akashic-work-connected（akashic-discovery plugin 的第三個）：找出和種子論文相似的論文——彼此不一定直接引用，但在文獻網路上相連（Connected Papers 這類工具做的事）。

Type

feature（plugin skill）

與往回／往前的差別：第三種契約

akashic-work-references（#617）與 akashic-work-cited-by（#620）走的是直接引用；本 skill 走的是相似度，兩種經典度量各建立在前兩個 skill 的資料上：

度量	意思	需要的資料
書目耦合（bibliographic coupling）	和種子共享很多參考文獻	種子的參考文獻（#617）
共被引（co-citation）	常和種子一起被引用	引用種子的論文的參考文獻（#620）

所以 blocked by #617 與 #620。

量測（2026-09-24，Hamaker, Kuiper & Grasman 2015，10.1037/a0038889，OpenAlex）

項目	數量
OpenAlex 預算好的 related_works	10
種子的 referenced_works	68
引用這 68 條中前 50 條任一的論文（書目耦合的候選池）	16,454
引用種子的論文（共被引的起點，見 #620）	3,918

含意：外部計算的候選池很大，必須先收斂（例如只取共享 ≥ k 條參考文獻者、只取被引次數前 N 的引用論文）。related_works 便宜但只有 10 條，且它的計算方式未量測，不能直接當相似度。

Expected（設計草案，待 diagnose／plan 定案）

1. 庫內版本優先：新 skill akashic-work-references（akashic-discovery plugin）：往回——從一篇作品的參考文獻找出該補進 library 的論文，驗證建檔並寫入 relations.cites #617／新 skill akashic-work-cited-by（akashic-discovery plugin）：往前的引用追蹤——找出引用某篇的論文，產出候選清單由使用者勾選才建檔，絕不自動匯入 #620 把 cites 累積進 store 後，書目耦合與共被引可以完全在庫內計算——不打 API，結果只涵蓋已收的文獻。現有 akashic_graph 只畫以某篇為中心的關係圖，沒有相似度計分。
2. 外部版本：OpenAlex，先收斂候選池再計分；收斂規則與上限寫在 SKILL.md 並於回報中列出被截掉多少（不靜默截斷）。
3. 產出：候選清單，每筆附連結理由（「與種子共享 12 條參考文獻」「被 47 篇同時引用」），不寫 store。
4. 使用者勾選後才交 akashic-bootstrap 驗證建檔。相似不是引用——不寫 cites；是否寫 related 待定（見 Clarity）。
5. 絕不自動匯入，同 新 skill akashic-work-cited-by（akashic-discovery plugin）：往前的引用追蹤——找出引用某篇的論文，產出候選清單由使用者勾選才建檔，絕不自動匯入 #620。

Actual

目前沒有任何入口能依文獻網路的相似度找論文；akashic_graph 只能呈現已記錄的關係。

Impact

文獻回顧除了直接引用鏈，還需要找「同一群文獻裡、但彼此沒直接引用」的論文（同一問題的平行研究、不同學派的同題論文）；只靠往回／往前會漏掉這一類。

Clarity Surface(idd-clarify run 2026-09-24T02:49:00Z)

Type	Source	Question for you	Status
ambiguity	"庫內版本優先"	第一版只做庫內計算，外部 OpenAlex 版本留到下一張 issue，可以嗎？	surfaced
ambiguity	"兩種經典度量"	書目耦合與共被引要一起做，還是先做一種？（書目耦合只需要 #617 的資料，可以較早開始）	surfaced
ambiguity	"是否寫 related 待定"	勾選建檔的相似論文，要用 akashic_link 寫 related 關係，還是只建檔、不記關係？	surfaced
missing-context	"只取共享 ≥ k 條參考文獻者、只取被引次數前 N 的引用論文"	k 與 N 由你每次給，還是 skill 給預設值、你可以覆寫？	surfaced