Akashic-Library 成為 marketplace akashic：列 akashic-mcp（./plugin）與 akashic-discovery（./plugins/akashic-discovery），akashic-mcp 從 psychquant 移入並遷移既有安裝，守衛涵蓋新 plugin 目錄

[kiki830621]

Problem

Original text:
「1. 讓 Akashic-Library 自己成為一個 marketplace；」
「整個搬過去」（akashic-mcp 是否一起搬進新 marketplace）
「拆成兩張」（#617 的發布結構與 skill 分開）
— Source: 使用者，2026-09-24（+08:00）對話與 #617 diagnose 的決策題

從 #617 拆出：讓 Akashic-Library 自己成為 marketplace akashic，列出 akashic-mcp 與新的 akashic-discovery，並把 akashic-mcp 從 psychquant-claude-plugins 移過來。這是 #617、#620、#622、#623 共同的前提。

分析與官方文件查證見 #617 的 Diagnosis（https://github.com/PsychQuant/Akashic-Library/issues/617#issuecomment-5806826472），本 issue 承接其中的「(A) 發布結構」。

Type

feature（發布結構／基礎設施）

已定案（2026-09-24，使用者於 #617 diagnose 選定）

項目	定案
marketplace 名稱	akashic（安裝 id：akashic-mcp@akashic、akashic-discovery@akashic）
目錄佈局	akashic-mcp 留在 plugin/；新 plugin 放 plugins/akashic-discovery/（不動約 224 處寫死的 plugin/ 路徑）
akashic-mcp	整個搬過來，從 psychquant-claude-plugins 移除
規則共用	plugins/akashic-discovery/rules/ 以 symlink 指向 plugin/rules/（官方文件：安裝時 plugin 被複製、不能引用目錄外檔案，共用用 symlink）

Expected

1. repo 根 .claude-plugin/marketplace.json：name: "akashic"、owner、plugins 列 akashic-mcp（source: "./plugin"）與 akashic-discovery（source: "./plugins/akashic-discovery"）；claude plugin validate . 通過
2. plugins/akashic-discovery/.claude-plugin/plugin.json：dependencies: ["akashic-mcp"]；rules/ symlink；先不含 skill（skill 由 新 skill akashic-work-references（akashic-discovery plugin）：往回——從一篇作品的參考文獻找出該補進 library 的論文，驗證建檔並寫入 relations.cites #617、新 skill akashic-work-cited-by（akashic-discovery plugin）：往前的引用追蹤——找出引用某篇的論文，產出候選清單由使用者勾選才建檔，絕不自動匯入 #620–搬移 akashic-venue-works 從 akashic-mcp 到 akashic-discovery plugin——守衛明確路徑、腳本測試、交叉引用、規則連結、CI 觸發一併更新 #623 各自加入）
3. 守衛涵蓋新 plugin 目錄：ProtectedInventory.swift 的 glob、rule-coverage.sh、CI 觸發路徑都納入 plugins/*/；負對照：在新目錄放一支沒接線的測試，守衛必須變紅（證明新目錄真的被看見）
4. psychquant-claude-plugins：移除 akashic-mcp 條目，加 renames: {"akashic-mcp": null}（官方文件：renames 無法跨 marketplace 轉址，null 只會讓使用者看到「已移除」）
5. 遷移說明（README 與 release note）：claude plugin marketplace add PsychQuant/Akashic-Library → claude plugin install akashic-mcp@akashic；舊 id 的設定要移除
6. 版本 tag：akashic-mcp--v<version>、akashic-discovery--v<version>（依賴版本解析用）
7. harness-devtools 的 marketplace 解析認得 akashic，plugin-update akashic-mcp 找得到它 → 已開 harness-devtools：個人設定（marketplace 位置、binary repo 路徑、組織名）改由使用者 JSON 設定檔提供（仿 .idd），工具只留通用預設 che-plugin-devtools#27（使用者要求：個人設定改由 JSON 設定檔提供，不寫死在工具裡）

Actual

akashic-mcp 由 psychquant-claude-plugins 以 git-subdir 列出；Akashic-Library 沒有 marketplace.json；守衛只看 plugin/。

Impact

五個 discovery skill（#617、#620–#623）都要住進 akashic-discovery，本 issue 不做它們全部卡住。既有 akashic-mcp 安裝會因搬移而需要重新 add／install，說明必須清楚。

Clarity Surface(idd-clarify run 2026-09-24T03:19:05Z)

Type	Source	Question for you	Status
ambiguity	"從 psychquant-claude-plugins 移除"	psychquant 的舊條目要在 #625 上線時立刻移除，還是保留一段過渡期（兩邊都能裝）再移除？	resolved @ 2026-09-24T03:22:07Z (reason: 使用者 2026-09-24：立刻移除——#625 上線時同步從 psychquant-claude-plugins 刪除條目並加 renames: {"akashic-mcp": null})
missing-context	"舊 id 的設定要移除"	你本機現有的 akashic-mcp@psychquant-claude-plugins 安裝，要由我在 #625 完成時一併遷移成 akashic-mcp@akashic 嗎？	resolved @ 2026-09-24T03:22:07Z (reason: 使用者 2026-09-24：好——#625 完成時一併把使用者本機安裝遷移成 akashic-mcp@akashic)
missing-context	"harness-devtools 的 marketplace 解析認得 akashic"	plugin-update 要認得新 marketplace，得改 harness-devtools；要在 #625 實作時順便到那邊開 issue 嗎？	resolved @ 2026-09-24T03:22:07Z (reason: 使用者 2026-09-24：要開，但 harness-devtools 是給大家用的開發工具：個人設定（marketplace 位置等）應寫成使用者的 JSON 設定檔（仿 IDD 的 .idd），不寫死在工具裡——另開於 che-plugin-devtools)

---

Current Status

Phase: closed
Last updated: 2026-09-24 by idd-close
Dashboard: #625 (comment)

Key Decisions

• 2026-09-24 結案（使用者選擇直接結案，未跑 /idd-verify）；closing summary 見本 issue 最新 comment
• tasks 6.4 驗收成立（使用者重啟後本 session 的 akashic-mcp 呼叫成功）；Spectra change 已 archive，主 spec 新增兩份
• [bug] akashic-mcp-v0.12.0 的 release binary 只支援 store format 17，而 tag 原始碼已是 18——format 18 的 store 全被拒 #630 已修正並發布 akashic-mcp-v0.12.1（plugin 0.13.2）：經 akashic-mcp@akashic 呼叫 akashic_libraries 成功，tasks 6.1 驗收成立
• 實作語言一律 Swift：新規則 .claude/rules/swift-is-the-implementation-language.md（使用者 2026-09-24）；官方驗證守衛第一版的 Python 同輪改寫成 akashic-guards official-validate
• claude plugin validate --strict 因 akashic-mcp 的 binary_version 永遠失敗 → 改 --json ＋ 只有一項的封閉允許清單（artifact 已同步）
• marketplace 條目不寫 description（實測：沒寫時回落 plugin.json、有寫時覆蓋），由 parity 守衛檢查
• 使用者 2026-09-24：push 時與另一個 session 已 verify 的 篩選式批次 apply 會升格沒人判定過的配對：淘汰而得的唯一候選、查過未決的配對 #624 commit 一起推；遇 [bug] akashic-mcp-v0.12.0 的 release binary 只支援 store format 17，而 tag 原始碼已是 18——format 18 的 store 全被拒 #630 時選「續做 6.2–6.4，[bug] akashic-mcp-v0.12.0 的 release binary 只支援 store format 17，而 tag 原始碼已是 18——format 18 的 store 全被拒 #630 另外處理」
• Complexity = Spectra；spectra-discuss A1–A5 全數確認；Expected 6（plugin 版本 tag）移除
• 跨 repo 順序：Akashic-Library push → 從 GitHub 安裝成功 → 才移除 psychquant 條目（已照做）

Scope Changes

• 移除：Expected 6（plugin 版本 tag）
• 新增：刪除 psychquant 空殘骸目錄；parity 測試改為檢查條目不帶 description；assertions-must-be-measured.md 量測列重量；兩份既有 mutations harness 的複製清單補 plugins、.claude-plugin
• 新增守衛：plugin-roots、marketplace-consistency、official-validate、plugin-roots-mutations

Blocking

• (none)

Tasks

• 1.1 實測守衛的 glob 走訪是否跟隨 symlink 目錄：在暫存樹建立 plugins/x/rules 指向 ../../plugin/rules，以 akashic-guards 的 glob 函式計數 plugins/*/rules/*.md 的成員數，決定 4.3 的去重做法。驗證：量測指令與輸出貼到 Akashic-Library 成為 marketplace akashic：列 akashic-mcp（./plugin）與 akashic-discovery（./plugins/akashic-discovery），akashic-mcp 從 psychquant 移入並遷移既有安裝，守衛涵蓋新 plugin 目錄 #625 comment，並回填 design.md 的 Open Questions 第一項。
• 2.1 [P] Repository-root marketplace manifest：新增 .claude-plugin/marketplace.json，name 為 akashic、設定 owner，列出 akashic-mcp（source ./plugin）與 akashic-discovery（source ./plugins/akashic-discovery），遵循「akashic-mcp 留在 plugin/，新 plugin 放 plugins/」。驗證：claude plugin validate --json . 的 errors 為空、warnings 恰為允許清單那一條（akashic-mcp 的 binary_version）。
• 2.2 [P] 依 Plugin directory layout 建立 discovery 骨架：manifest 位於 plugins/akashic-discovery/.claude-plugin/plugin.json、name 等於目錄名；Discovery plugin depends on akashic-mcp without a version range（dependencies 為純字串 akashic-mcp，依「依賴寫純字串、不打 plugin 版本 tag」）；Shared rules through a directory symlink（依「rules 目錄整個 symlink」建立 rules 指向 ../../plugin/rules）。驗證：claude plugin validate --strict plugins/akashic-discovery exit 0；git tag -l '*--v*' 無輸出；git ls-files -s plugins/akashic-discovery/rules 的 mode 為 120000；plugins/akashic-discovery/rules/assertions-must-be-measured.md 可讀。
• 3.1 Mutation proof that new roots are seen（RED 階段）：新增子命令 akashic-guards plugin-roots-mutations，在暫存複本逐一套用 spec 突變表六列（需要既有受保護檔的列先在複本建立探針並接受進複本的 ratchet），另加 marketplace-consistency 範例表其餘三個失敗列；原始樹不得被修改。驗證：在現行守衛上執行時 exit 非 0，輸出逐條列出未被抓到的突變名稱（證明負對照有鑑別力），並以 git status 確認原始樹無變動。
• 4.1 Single source of plugin roots，依「以檔案系統為 plugin 根目錄的權威來源，marketplace manifest 作集合核對」：新增 pluginRoots() 與子命令 akashic-guards plugin-roots，輸出排序後的 repo 相對路徑、每行一個。驗證：在含 plugins/scratch/（無 manifest）的暫存樹上輸出恰為 plugin 與 plugins/akashic-discovery；在現行樹上輸出同樣兩行。
• 4.2 Filesystem and marketplace manifest agree：新增子命令 akashic-guards marketplace-consistency，實作 spec 的五類封閉列舉，逐條指名違規；manifest 讀不到或 JSON 無法解析時 exit 非 0 並說明。驗證：現行樹 exit 0；3.1 中所有 consistency 突變列改為被抓到。
• 4.3 Protected inventory covers every plugin root：受保護清單的測試腳本與規則 pattern 改由 pluginRoots() 對每個根展開，經 rules symlink 才到達的檔案依 1.1 的結果以真實路徑去重。驗證：現行樹 akashic-guards protected-ratchet 的差異恰為本 change 新增的 3 支 Swift 守衛與 2 個 manifest（.claude-plugin/marketplace.json、discovery 的 plugin.json），且不含任何 plugins/*/rules/ 路徑（由 plugin-roots-mutations 的結構檢查釘住）；3.1 的「刪除受保護測試」「未接線測試」兩列改為被抓到。
• 4.4 Rule coverage runs per plugin root，依「bash 端經由 akashic-guards plugin-roots 取得清單」與「0 個 skill 的 plugin 視為 vacuous 通過」：plugin/tests/rule-coverage.sh 接受選填的根目錄參數（預設 plugin），守衛入口以 akashic-guards plugin-roots 的輸出逐根呼叫。驗證：bash plugin/tests/rule-coverage.sh plugins/akashic-discovery 印出 0 個 skill（vacuous）並 exit 0；不帶參數的輸出與變更前逐字相同；3.1 的「skill 未引用規則」列改為被抓到。
• 4.5 [P] CI triggers include plugin roots and the manifest：跑守衛的 workflow（.github/workflows/census-parity.yml）觸發路徑加入 plugins/** 與 .claude-plugin/**；Swift build workflow（.github/workflows/ci.yml）的 paths-ignore 加入同樣兩條。驗證：akashic-guards trigger-coverage 在現行樹通過；3.1 的「移除 plugins/** 觸發路徑」列改為被抓到。
• 4.6 Official validation where the CLI exists，依「claude plugin validate 只在 pre-push 執行，CI 印出略過」：守衛入口偵測 claude，存在時執行 claude plugin validate --json .，任何 error 或允許清單以外的 warning 即失敗，不存在時印出略過原因。驗證：本機執行 bash .githooks/run-guards.sh 可見 validate 通過行；在暫存複本的 manifest 加一個未知欄位時該步失敗並指名該欄位；以移除 claude 的 PATH 執行可見略過行。
• 4.7 Mutation proof that new roots are seen（GREEN 階段）：把 plugin-roots、marketplace-consistency、plugin-roots-mutations 接進守衛入口，新增的受保護成員以 akashic-guards protected-ratchet --accept 明示接受。驗證：akashic-guards plugin-roots-mutations exit 0 且輸出每個突變都被對應守衛抓到；bash .githooks/run-guards.sh 全綠。
• 5.1 依「marketplace 條目描述依 /plugin 回落行為決定」：以本機 marketplace 實測 marketplace 條目缺 description 時 Claude Code 顯示的描述來源，依結果增刪條目描述，並把 plugin/tests/plugin-store-format-parity.py 中「跨 repo、無法覆蓋」的說明改成實際覆蓋或單一來源的說明。驗證：parity 測試通過，且該檔不再把 repo 內的 marketplace manifest 描述為無法覆蓋。
• 6.1 依「跨 repo 發布順序：先上架、驗證可安裝、再移除外部條目」推上本 repo，接著遷移使用者本機安裝：解除安裝 akashic-mcp@psychquant-claude-plugins → claude plugin marketplace add PsychQuant/Akashic-Library → claude plugin install akashic-mcp@akashic；同時量測 clone 是否包含 submodule 與實際大小。驗證：claude plugin list --json 對 akashic-mcp@akashic 無 errors 欄位，且一個 akashic MCP 工具實際呼叫成功；任一步失敗即重新安裝舊 id 並停止，不進 6.3。 受阻於 [bug] akashic-mcp-v0.12.0 的 release binary 只支援 store format 17，而 tag 原始碼已是 18——format 18 的 store 全被拒 #630（2026-09-24）：遷移、依賴自動安裝、plugin list 無 errors、MCP 握手與 tools/list（31 個）皆成立；碰 store 的工具被拒，因 release v0.12.0 的 binary 只支援 store format 17（store 為 18）。舊安裝共用同一個 binary（SHA-256 相同），裝回舊 id 無濟於事；使用者裁決先續做 6.2–6.4，[bug] akashic-mcp-v0.12.0 的 release binary 只支援 store format 17，而 tag 原始碼已是 18——format 18 的 store 全被拒 #630 修好後補驗本項。
• 6.2 Install id migration（文件）：README 的安裝指令改為 akashic-mcp@akashic，並寫入遷移三步與 6.1 量到的 clone 內容；plugin/rules/assertions-must-be-measured.md 中「經由公開 marketplace 發布」一列依新 manifest 重新量測並改寫量法。驗證：README 與 plugin/ 的安裝指令不再使用 akashic-mcp@psychquant-claude-plugins（舊 id 只出現在 README 的遷移說明）；akashic-guards measured-claims-audit 通過。
• 6.3 Install id migration（外部 marketplace）：psychquant-claude-plugins 的 manifest 移除 akashic-mcp 條目、加入 renames 將 akashic-mcp 對應到 null，刪除其遺留的空目錄 plugins/akashic-mcp/，push。驗證：該 manifest 不含 akashic-mcp 條目且 renames 內容正確；該目錄不存在；claude plugin marketplace update psychquant-claude-plugins 無錯誤。
• 6.4 收尾驗證：使用者層設定中不再啟用舊 id，重啟 Claude Code 後 akashic MCP 工具可用。驗證：使用者層 settings.json 無 akashic-mcp@psychquant-claude-plugins；重啟後呼叫一個 akashic MCP 工具成功；結果記到 Akashic-Library 成為 marketplace akashic：列 akashic-mcp（./plugin）與 akashic-discovery（./plugins/akashic-discovery），akashic-mcp 從 psychquant 移入並遷移既有安裝，守衛涵蓋新 plugin 目錄 #625。 部分受阻於 [bug] akashic-mcp-v0.12.0 的 release binary 只支援 store format 17，而 tag 原始碼已是 18——format 18 的 store 全被拒 #630（2026-09-24）：設定檔一項已成立（uninstall 自動移除舊 id，僅剩 akashic-mcp@akashic、akashic-discovery@akashic）；工具呼叫待 [bug] akashic-mcp-v0.12.0 的 release binary 只支援 store format 17，而 tag 原始碼已是 18——format 18 的 store 全被拒 #630 發布新 binary 並由使用者重啟後補驗。

Commits

• 2ed8a679 docs: archive spectra change akashic-plugin-marketplace（本地，隨 main 下次推送）
• 5b7fdf9a／b48bd860／c316435f／c71bfc4d／4b34fdfb（[bug] akashic-mcp-v0.12.0 的 release binary 只支援 store format 17，而 tag 原始碼已是 18——format 18 的 store 全被拒 #630：發布流程與 wrapper 修正、0.12.1）
• e09f0252 feat: Akashic-Library 成為 marketplace akashic——discovery 骨架、守衛逐根涵蓋 plugin 根
• ce49ff2a docs: 安裝說明改為 akashic marketplace、遷移步驟與 clone 實測；量測斷言重量（本地，隨 main 下次推送）
• 59a951e7 docs: 實作語言一律 Swift（同輪、非本 issue 範圍）
• psychquant-claude-plugins 68378f7 chore: 移除 akashic-mcp 條目

[kiki830621]

Diagnosis

Type

feature（發布結構／基礎設施）

Root Cause / Analysis

Expected 七項逐項對照現況量測（2026-09-24，本機 Claude Code 2.1.281；官方文件 plugin-dependencies、plugin-marketplaces 當日讀取）。

1. marketplace.json（Expected 1）

• 目前 repo 根沒有 .claude-plugin/。claude plugin validate [--strict] <path> 在 2.1.281 存在，可驗 marketplace manifest，--strict 會把「runtime 容忍的未知欄位」當錯誤。
• 條目要不要帶 description，還沒量：若帶，它就是 plugin/tests/plugin-store-format-parity.py 第 38–49 行記為 UNCOVERED（「跨 repo，蓋不到」）的那一份描述的繼任者——搬進 repo 之後可以蓋到了，UNCOVERED 那一行必須改成實際覆蓋，否則那段註解變成假的。旁證：psychquant 現行條目的描述已經多出一句 plugin.json 沒有的「(multiple Zotero sources per entry)」，正是那段註解預言的分岔。

2. akashic-discovery 骨架（Expected 2）

• 官方文件：dependencies 寫成純字串 "akashic-mcp" 時，取「該 plugin 所在 marketplace 目前提供的版本」，不需要任何 git tag。
• rules/ symlink 指向 plugin/rules/：rule-coverage.sh 的 [ -f "$(dirname "$f")/$rel" ] 會跟著 symlink 解析，skill 以 ../../rules/x.md 引用即可。

3. 守衛涵蓋新目錄（Expected 3）——四個接點，缺一個就是安靜的洞

接點	現況	缺了會怎樣
Sources/akashic-guards/ProtectedInventory.swift 45–49 行	5 條 glob 全以 plugin/ 為根	plugins/ 下的測試不進 PROTECTED → protected-ratchet 與 trigger-coverage 兩道都看不見（TriggerCoverage 的檢查對象就是 PROTECTED）
plugin/tests/rule-coverage.sh	PLUGIN=$(cd "$HERE/.." && pwd)，只看 plugin/	discovery 的 skill 漏掛規則不會被抓
.github/workflows/census-parity.yml 64 行 paths	只有 plugin/**	只改 plugins/** 的 push 不觸發唯一跑 run-guards.sh 的 job（第 159 行）
.github/workflows/ci.yml 34–37 行 paths-ignore	只有 plugin/**	反方向：只改 plugins/** 會白跑整套 Swift CI（浪費，不是安靜）

• rule-coverage.sh 找不到 skills/ 就 exit 2（第 27 行）；discovery 在本 issue 上線時沒有 skill，直接接上會紅。「0 個 skill」要明確回報成 vacuous，不能靠 glob 沒展開的字面 */。
• globFiles 以 FileManager.enumerator(atPath:) 遞迴；它是否進入 symlink 目錄（rules/ 會不會被算兩次）尚未量，實作時要在 CI 的 runner 上實測，不假設。

4. psychquant 端（Expected 4）

• 條目為 git-subdir（path: plugin），無 version 欄位；目前沒有 renames；沒有任何 plugin 以 dependencies 依賴 akashic-mcp（全樹 plugin.json 量過）。
• psychquant 還留著一個只剩空子目錄的 plugins/akashic-mcp/（skills/akashic-bootstrap-workspace/，零檔案、git 不追蹤），是 psychquant 322f649 那次遷移的殘骸。它不是無害的：harness-devtools 的 find_plugin_marketplace 判準是 [ -d "$root/plugins/$plugin" ]，這個空目錄就是 plugin-update akashic-mcp 至今解析到 psychquant 的原因。條目移除後若目錄仍在，工具會對一個已刪除的條目動手。

5. 遷移說明（Expected 5）

• 目前 repo 內寫死舊安裝 id 的：README.md:84、README.md:468；plugin/rules/assertions-must-be-measured.md:295 是一列量測過的斷言（「本 plugin 經由公開的 marketplace 發布」，量法指向 psychquant 的 marketplace.json）——搬家後量法失效，要重量重寫，不是改字。
• 兩個 repo 都是 public（gh repo view --json isPrivate → false），搬家不改變可見性。
• git-subdir 只抓 plugin/；改成相對路徑 source 後，marketplace add 會 clone 整個 repo：pack 13.6 MiB，另有 3 個 submodule，會不會跟著抓尚未量。

6. 版本 tag（Expected 6）——建議從本 issue 移除

• 官方文件：{plugin}--v{version} tag 只在宣告版本範圍時才被讀；純字串依賴不需要。
• 兩個 plugin 出自同一個 repo 的同一個 commit，marketplace 更新時一起移動——版本範圍能提供的保護，同 repo 共版已經給了。
• 反面風險是具體的：binary 的 release tag 是 akashic-mcp-v0.12.0（單一連字號，跟 binary_version 走，wrapper 第 40 行以此下載），plugin 依賴 tag 是 akashic-mcp--v…（雙連字號，跟 plugin version 走）。兩者差一個字元、語意完全不同，手打錯一個會安靜地指到另一個系統。
• 日後真要加版本範圍：用 claude plugin tag --push（從 manifest 推出 tag 名、檢查 plugin.json 與 marketplace 條目版本一致），不手打。

7. harness-devtools（Expected 7） → che-plugin-devtools#27。本次量測補一條給 #27：akashic-mcp 在新 marketplace 裡位於 ./plugin 而非 plugins/akashic-mcp，所以就算 Akashic-Library 被登記，find_plugin_marketplace 的 plugins/<name> 判準仍然找不到它——解析要改讀 marketplace.json 的 source。

Impact

• 影響的檔案（Akashic-Library）：.claude-plugin/marketplace.json（新）、plugins/akashic-discovery/（新）、Sources/akashic-guards/ProtectedInventory.swift、plugin/tests/rule-coverage.sh、.githooks/run-guards.sh、.githooks/protected-ratchet.txt、.github/workflows/census-parity.yml、.github/workflows/ci.yml、plugin/tests/plugin-store-format-parity.py、plugin/rules/assertions-must-be-measured.md、README.md
• 影響的檔案（psychquant-claude-plugins）：.claude-plugin/marketplace.json（移除條目、加 renames）、空殘骸目錄 plugins/akashic-mcp/
• 影響的使用者流程：既有 akashic-mcp@psychquant-claude-plugins 安裝需要 uninstall → marketplace add PsychQuant/Akashic-Library → install akashic-mcp@akashic；/plugin 會把舊 id 顯示為已移除（renames: null 無跨 marketplace 轉址）

Strategy

• 守衛先行（TDD 的 RED）：抽出單一的「plugin 根目錄清單」（plugin ＋ plugins/*），ProtectedInventory 的五條 glob 與 rule-coverage.sh 都從它展開——第三個 plugin 出現時自動涵蓋，不必再記得改兩處
• 負對照：在 plugins/akashic-discovery/ 放一支沒接線的探針測試 → trigger-coverage 必須紅、protected-ratchet 必須要求 --accept；把 census-parity.yml 的 plugins/** 拿掉 → trigger-coverage 的 workflow-paths 檢查必須紅。三個都紅過再移除探針
• rule-coverage.sh：逐根執行；0 個 skill 明確印出 vacuous 並通過
• 實測 globFiles 對 symlink 目錄的行為，依結果決定 rules/ 是否要從 glob 排除（避免同一份規則被算成兩個受保護成員）
• census-parity.yml paths 加 plugins/**、.claude-plugin/**；ci.yml paths-ignore 加同樣兩條
• .claude-plugin/marketplace.json（name: akashic）＋ plugins/akashic-discovery/.claude-plugin/plugin.json（dependencies: ["akashic-mcp"]）＋ rules/ symlink；claude plugin validate --strict . 通過
• 量 /plugin 在 marketplace 條目缺 description 時是否回落到 plugin.json：回落 → 條目不寫描述（單一來源）；不回落 → 寫，並讓 parity 測試正式覆蓋它、刪除 UNCOVERED
• claude plugin validate 接進 run-guards.sh：本機（pre-push）有 claude 時必跑；CI 沒有 CLI 時印出「validate skipped: no claude CLI」，不靜默
• 量 claude plugin marketplace add 對 submodule 的行為與實際 clone 大小，寫進 README 遷移段
• README 兩處、assertions-must-be-measured.md:295 重量重寫；release note 寫遷移三步
• psychquant：移除條目、加 renames: {"akashic-mcp": null}、刪除空殘骸目錄；push
• 遷移使用者本機安裝（使用者已同意）：uninstall 舊 id → marketplace add → install akashic-mcp@akashic → claude plugin list --json 確認無 errors
• 把「find_plugin_marketplace 的 plugins/<name> 判準找不到 ./plugin」補到 che-plugin-devtools#27

Conflict Class

C_shared_module_coord — 共享資源：(1) psychquant-claude-plugins 的 marketplace.json（27 個 plugin 共用，另一個 session 可能同時推）；(2) Akashic-Library 的 checkout（另一個 session 共用，只 add 自己的檔案）；(3) 守衛基礎設施 ProtectedInventory.swift ＋ .githooks/protected-ratchet.txt（任何新增測試的改動都會碰）。

Complexity

Spectra

• Layer 2：對外暴露新的發布面——marketplace akashic 與安裝 id akashic-mcp@akashic、akashic-discovery@akashic，以及 plugins/<name>/ 這個之後每個 plugin 都要遵守的佈局約定。
• Layer 3：architectural decision with long-term maintenance implications——repo 從「單一 plugin 由外部 marketplace 列出」變成「自己是多 plugin 的 marketplace」，守衛涵蓋規則（plugin 根目錄清單）會被之後每個 plugin 繼承。
• Hard-gate: triggered — 同一概念（「plugin 根目錄」）散佈到 ProtectedInventory.swift、rule-coverage.sh、run-guards.sh、census-parity.yml、ci.yml、marketplace.json 六處以上（Spectra 已優先成立，硬閘僅記錄）。

Vagueness Pre-check

• V1: 2 — Expected 1–7 逐項列出產物與位置，「已定案」表把四個結構決定寫死。
• V4: 2 — 驗收條件可機械判定：validate 通過、負對照必須變紅、renames 的確切內容、plugin list --json 無 errors。
• Triggered: no — both axes ≤ 3

Risks

• 守衛的沉默方向：若新目錄沒進 PROTECTED，新測試被刪不會有人知道。負對照是唯一能證明「看得見」的方法，不能省。
• 跨 repo 順序：psychquant 先移除而 Akashic-Library 的 marketplace 還沒推上去，中間的空窗裡新使用者裝不到。順序必須是 Akashic-Library push → 驗證可安裝 → psychquant 移除。
• 使用者本機遷移：akashic-mcp 是 binary-backed，重新安裝會重跑 wrapper 的下載邏輯；遷移後要確認 MCP 工具實際可呼叫，不只看 plugin list。
• clone 大小：submodule 若被遞迴抓取，安裝成本會明顯上升。

Residue

使用者要的其實是「之後五個 discovery skill 有地方住，而且不會跟 akashic-mcp 混在一起」——marketplace 化是達成它的手段。這個目的本身不在本 issue 的驗收條件裡，要到 #617 第一個 skill 住進 akashic-discovery 並實際跑通時才算兌現。

Sister Concerns Filed (mid-diagnose, v2.47.0+ #528)

Filed: #626

• Existing issue covers: harness-devtools：個人設定（marketplace 位置、binary repo 路徑、組織名）改由使用者 JSON 設定檔提供（仿 .idd），工具只留通用預設 che-plugin-devtools#27 — find_plugin_marketplace 以 plugins/<name> 目錄判斷歸屬，找不到 ./plugin，且會被空殘骸目錄誤導（已在 known-field 路徑的 alias 展開放大無防線（pre-existing；follow-up from #23） #27 補 comment：https://github.com/PsychQuant/che-plugin-devtools/issues/27#issuecomment-5807028661）
• In-scope（已併入本 issue 的 Strategy，不另開）：psychquant 的空殘骸目錄 plugins/akashic-mcp/；psychquant 條目描述與 plugin.json 分岔

[kiki830621]

Decision（diagnose 確認，2026-09-24）

使用者確認 Diagnosis（https://github.com/PsychQuant/Akashic-Library/issues/625#issuecomment-5807015943），並對兩個待決項選定：

1. Expected 6 移除：akashic-discovery 的 dependencies 寫純字串 "akashic-mcp"，不打 {plugin}--v{version} tag。理由見 Diagnosis 第 6 點（純字串依賴不需要 tag；同 commit 共版；與 binary release tag akashic-mcp-v… 只差一個連字號）。日後需要版本範圍時，用 claude plugin tag --push 產生，不手打。
2. 路徑：/spectra-discuss（opt-out 條件「無新抽象」不成立——plugin 根目錄清單是新抽象）。

[kiki830621]

Discussion Conclusion（spectra-discuss，2026-09-24）

使用者確認以下五項假設全部成立：

#	決定	選它的理由（失效方向）
A1	「plugin 根目錄」由 Swift pluginRoots() 定義：plugin ＋ plugins/*/（含 .claude-plugin/plugin.json）；另設守衛核對它與 marketplace.json 的 plugins[].source 集合相等	只信 marketplace.json → 建了沒列的 plugin 零涵蓋（安靜）；只信檔案系統不核對 → 拼錯的 source 出貨
A2	bash 不另存清單：rule-coverage.sh [root]（預設 plugin），run-guards.sh 以 akashic-guards plugin-roots 逐根呼叫	兩份清單＝#432 那種會分岔的形狀
A3	0 個 skill 的 plugin：明確印 vacuous 並通過	否則 #625 無法先於 #617 上線
A4	claude plugin validate --strict 只在 pre-push（有 CLI）跑；CI 印出 skip；CI 必須擋的結構不變量由 A1 的 Swift 守衛負責	CI 裝 CLI＝守衛多了網路與版本漂移
A5	rules/ 整個目錄 symlink	範圍擴大時 rule-coverage 變紅（有聲）；逐檔 symlink 時新規則安靜地漏掉

介面深度：邊界在 Sources/akashic-guards/ 新檔；一個函式＋一個 CLI 轉接；刪除測試成立（刪掉即退回 plugin/-only，plugins/ 對 ratchet 與 trigger-coverage 隱形）。

下一步：/spectra-propose 建 change，本表寫入 design.md。

[kiki830621]

Spectra change 建立（spectra-propose，2026-09-24）

• change：akashic-plugin-marketplace（Feature），已 park
• artifacts：proposal、design、specs（plugin-marketplace-distribution、plugin-root-guard-coverage）、tasks（16 項，分 6 組：量測前提 → 骨架 → 負對照 RED → 守衛 GREEN → 文件 → 發布與遷移）
• spectra analyze：分析了 4 個 artifact，五個維度（Coverage／Consistency／Ambiguity／Gaps／Localization）皆 Clean；spectra validate：valid
• 16 項略超過 self-review「>15 考慮拆分」的軟門檻；唯一自然的拆法是把「發布與遷移」獨立，但那四步必須接在守衛之後依序執行，拆開不降低風險，故維持單一 change
• park 期間 artifacts 存放於 git 目錄內部（不進版本控制）；/spectra-apply akashic-plugin-marketplace 會自動 unpark 並搬回 openspec/changes/

下一步：/spectra-apply akashic-plugin-marketplace。實作完成後依 Spectra 追蹤規定，貼 ## Implementation Complete 並執行 /idd-update #625 --tasks-file openspec/changes/akashic-plugin-marketplace/tasks.md。

[kiki830621]

量測：glob 走訪與 symlink 目錄（tasks 1.1，2026-09-24）

暫存樹：plugin/rules/{r1,r2}.md，plugins/x/rules → ../../plugin/rules。以守衛 globFiles 使用的同一組 Foundation API 量測（本機 macOS 27.2、Swift 6.4；CI 為 macos-15）：

走訪	結果	對應的 glob 形狀
FileManager.enumerator(atPath: "plugins")	["x", "x/rules"]——不進入 symlink 目錄	多段萬用字元（例：plugins/*/rules/*.md）
contentsOfDirectory(atPath: "plugins/x/rules")	["r1.md", "r2.md"]——穿過 symlink	只有最後一段萬用字元（例：plugins/x/rules/*.md）
resolvingSymlinksInPath()	plugin/rules/r1.md	—

結論：逐根展開 <root>/rules/*.md 時，discovery 那一根會經由 symlink 把 plugin/rules/ 的檔再算一次。4.3 的去重做法：glob 結果一律還原為真實 repo 相對路徑後去重；以 spec 情境 "Symlinked rules are not double counted" 作為測試，在 CI 上一併驗證 macos-15 的行為。

[kiki830621]

Progress（spectra-apply，2026-09-24）：14/16，2 項受阻於 #630

已出貨

• e09f0252（已推）：marketplace akashic、akashic-discovery 骨架、守衛逐根涵蓋 plugin 根
• ce49ff2a（本地，隨 main 下次推送）：README 安裝與遷移說明、量測斷言重量、tasks 受阻註記
• psychquant-claude-plugins 68378f7（已推）：移除 akashic-mcp 條目、加 renames: {"akashic-mcp": null}、刪空殘骸目錄
• 使用者本機：akashic-mcp@psychquant-claude-plugins → akashic-mcp@akashic ＋ akashic-discovery@akashic

守衛證據

項目	結果
plugin-roots-mutations	RED 0/9 → GREEN 11/11（每格含對照組；另釘 plugin-roots 契約與 symlink 規則不重複計數，後者手動負對照驗過）
run-guards.sh 全套	rc=0（3 分 32 秒）；pre-push（build＋test＋守衛）全綠
ratchet	61 → 68（新增恰為 4 支 Swift 守衛、2 個 manifest、1 條規則檔）

實作中量到、並回寫進 artifact 的事

1. glob 與 symlink：enumerator 不進入 symlink 目錄、contentsOfDirectory 會穿過 → 受保護清單還原真實路徑後去重
2. claude plugin validate --strict 永遠失敗：akashic-mcp 的 binary_version 是 Claude Code 不認得的欄位（wrapper 需要它，refactor: Akashic-Library 自身成為 plugin——akashic-mcp shell（skills/wrapper/manifest）遷入本 repo，marketplace 改為引用 #275）→ 改 --json ＋ 只有一項的封閉允許清單（akashic-guards official-validate）
3. 條目描述：marketplace 條目沒寫 description 時 /plugin 回落到 plugin.json，有寫時覆蓋 → 條目不寫，parity 守衛檢查
4. clone 大小：marketplace add 連同 3 個 submodule，約 192 MB（submodule 約 162 MB）
5. 依賴：在 akashic-mcp 未安裝時裝 akashic-discovery@akashic，自動帶入 akashic-mcp@akashic，兩者無 errors
6. 安裝快取：discovery 的 rules symlink 在快取裡被解析成真目錄，規則可讀

受阻：#630

新安裝的 MCP 握手成功、tools/list 31 個，但碰 store 的工具被拒——release akashic-mcp-v0.12.0 的 binary 只支援 store format 17（SHA-256 與本機相同，tag 原始碼卻是 18）。舊安裝共用同一個 binary，遷移本身沒有讓行為變差。tasks 6.1、6.4 的「工具呼叫成功」待 #630 發布新 binary、使用者重啟後補驗。

同輪新開

• [refactor] 既有的 Python／shell 領域邏輯移植成 Swift（swift-is-the-implementation-language 的既有檔清單） #629：既有 Python／shell 移植成 Swift（新規則 .claude/rules/swift-is-the-implementation-language.md 的既有檔清單）
• [bug] akashic-mcp-v0.12.0 的 release binary 只支援 store format 17，而 tag 原始碼已是 18——format 18 的 store 全被拒 #630：上述 release 缺陷