Leo/system-dev-template
1
0
Fork 0
Code Issues 1 Pull Requests Actions Packages Projects Releases Wiki Activity
27 Commits 1 Branch 0 Tags
671503fd703e2d2d0308cb57a88bed4bbd26620f
Commit Graph

11 Commits

Author SHA1 Message Date
Leo 671503fd70 feat: wiki 資訊架構 push/pull 判準 + principles 原則 push 檔 + bump 1.10.0 
從「用戶所有檔案一律改寫成 wiki」前提,用 push(行動前必看見)vs pull(按需查)
重新推導 wiki/ 每個檔存廢——wiki 主要給 AI 看,判準是 CC 做事會不會被動看見。
對應 SDD: wiki-architecture(內部,依原則不推)。

- 新增 principles.md(push 全文):收跨全局原則(不污染根目錄、low-code…),
  原則是會被遺忘的盲區,沒推到眼前 CC 設計時不服從。一行一條 ≤15。
- mistakes 改 push 摘要(標題+症狀,全文按需展開,量大不撐爆 context)
- decisions-summary 降級為 cards + INDEX 決策視圖(既有相容)
- INDEX 升級多角度視圖的家:新增角度只改 INDEX,不開檔不問用戶
- session-start hook 三類 push:principles 全文→status→mistakes 標題;>15 警告
- install 補 principles download;update 加 add_if_missing(補範本/已有則保留)
- push/pull 判準寫進 wiki-init + SKILL,CC/Cowork 共用
- 沙盒驗證:三類注入順序與量受控、add_if_missing 不覆蓋用戶內容、全 bash -n 過

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-26 17:34:26 +08:00
Leo c24c42c99f fix: 修 SKILL.md typed-edge 三元組整節重複貼兩次(issue #10)+ bump 1.9.2 
加 gloss 節時複製貼上沒清掉舊段,### 使用 typed-edge 三元組 在 SKILL.md
出現兩次、byte-identical(KB 端讀 skill 時發現)。

- 刪重複第二份,保留第一份(順序合理,gloss 節緊接其後)
- 兩來源檔同步:docs/SKILL.md + template/system-dev/docs/SKILL.md

Closes #10

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-26 15:35:22 +08:00
Leo ecf1f882c6 feat: 安裝結構收進 system-dev/(不污染用戶根目錄)+ 舊版自動遷移 + bump 1.9.0 
工具產物原散在用戶根目錄(docs 七層、scripts),又把 wiki/VERSION 寄生在 CC 原生
.claude/ 裡,用戶分不清哪個 docs 是工具的。這版徹底收斂:除 .claude/(settings/
commands/hooks)與 CLAUDE.md 留根,工具所有資料收進 system-dev/。

對應 SDD: system-dev/docs/3-specs/install-layout/(內部記錄,依原則不推)。

- 新結構 system-dev/{VERSION,wiki/,docs/,scripts/};.claude/ 只剩 CC 機制檔
- wiki 改寫產物落點正式化:install 建 system-dev/wiki/cards/(.gitkeep)
- docs 雙語義拆開:工具文件→system-dev/docs/;用戶 raw source 維持原處只讀
- scripts 一開始就裝進 system-dev/scripts/
- 舊版自動遷移雙保險:update.sh 冪等搬移(wiki 含 .git、docs 白名單)
  + session-start hook 偵測舊結構未遷移時提示(low-code 用戶兜底)
- wiki-secret-scan 觸發路徑改 system-dev/wiki/**(否則新結構防護失效)
- 全套路徑引用同步:CLAUDE/SKILL/wiki-*/sdd-*/hooks/INDEX/README(中英)
- 沙盒驗證:遷移含 .git commit 一致、冪等、用戶自填 docs 保留;全 bash -n 過

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-26 15:13:43 +08:00
Leo f2c048c79f feat: wiki 採集加「萃 gloss」（node 一句說明，供下游語義 normalize）+ bump 1.8.0 
issue #9：下游 KBDB 語義 normalize 要對「entity 名 + gloss」一起 embedding 自動
歸一同義詞，但採集只萃三元組沒萃 gloss。原則：gloss 在知識生產當下由 local
CC/Cowork 建，不留給下游 ingest 臨時補（下游視角編不出好 gloss）。

- 卡片 frontmatter 加 gloss: 欄位（選填、deep tier 才產）
- gloss ≠ 摘要：gloss 給機器 normalize，## 摘要 給人讀
- 對齊下游 envelope nodes[].gloss
- wiki-init.md（CC）與 docs/SKILL.md（Cowork）兩路徑同步

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-26 13:47:07 +08:00
Leo bc0fe3f01c docs: 釐清 taxonomy 是受控擴充非凍結（先查重再登記）+ bump 1.6.1 
1.6.0「禁止自創」措辭過嚴，碰到新軸會逼 AI 硬塞或偷創。改成：
禁的是繞過字典直接冒新標籤，不是禁新增——遇裝不下的內容先查重
（非同義詞？）、確認是新軸才登記進該 repo 的 TAXONOMY.md 再用。
字典 per-repo，跨 repo 不共用。新增領域軸要慎，形態軸較安全。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-26 01:28:21 +08:00
Leo dccb97a6df feat: wiki 完整規劃方式（183 卡實證）三層架構+frontmatter標籤+多層索引（issue #8/#6/#7） 
在 Logseq vault（234 篇 → 183 卡、571 typed-edge）完整跑一輪後定案的
「對 AI 最優」規劃方式，一次納入 wiki-init.md 與 docs/SKILL.md：

- 三層架構：INDEX（標籤視圖）→ cards/<bucket>/00-INDEX → 原子卡。
- frontmatter tags 分類（非行內 #tag、非資料夾），TAXONOMY.md 當字典禁自創。
- 桶子索引固定名 00-INDEX.md（#6）；指它帶路徑 [[bucket/00-INDEX]]（#7）。
- 新檔 TAXONOMY.md：install download_if_missing、update keep_file。
- 踩坑警語：subagent 絕不寫 raw source（git 驗證）、檔名全形字元一致、量大用 Haiku。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-26 01:20:40 +08:00
Leo 331e4d56a7 feat: wiki 連結升級成 typed-edge 三元組 A >> 謂詞 >> B（issue #5） 
裸 [[wikilink]] 是弱連結——只說「有關」，沒說關係是什麼，下游要建
knowledge graph 還得回讀兩張卡。改寫成帶語義的三元組，下游 ingest 直接
parse 出帶類型的有向邊，把關係也預編譯。

- wiki-init.md + docs/SKILL.md 的 ## 關聯 改用 [[A]] >> 謂詞 >> [[B]]。
- 規則：方向性、謂詞用動詞、自由詞彙、向後相容（裸 [[A]] 仍合法）。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 23:11:31 +08:00
Leo d10659bd2d feat: install.sh 偵測 vault 類型寫入 raw source + Cowork 整理 skill 
- install.sh：建立 CLAUDE.md 前偵測資料夾類型，寫入對應 raw source
  - logseq/ → pages/, journals/
  - .obsidian/ → 根目錄 .md
  - 都沒有 → docs/（維持原行為）
  宣告區塊對 vault 明令不得搬動/改名 .md，整理只寫進 .claude/wiki/。
  已有 CLAUDE.md 一律不覆蓋，改列提醒手動補。
- docs/SKILL.md：給 claude.ai Cowork 的 wiki-cowork-scan skill，
  與 CC 共用同一套偵測與整理規則。
- README：新增 vault 支援、Cowork 整理兩節，更新目錄樹。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 20:01:21 +08:00
Leo 9dcbe38021 feat: install.sh 模組化安裝（--wiki / --sdd / --all） 
有時只需要 wiki 不需要 SDD。不 fork，改用同一入口模組選單：
- --wiki / --sdd / --all（預設），無參數 + 有 tty 則互動詢問
- curl|bash 無 tty 安全預設 --all
- settings.json 的 hooks 依選的模組自動組裝（不再下載單一靜態檔）

不 fork 的理由：使用者多半非工程背景，一個入口最友善；維護成本不翻倍。
模組邊界先劃好，未來功能達 3+ 個再演進成「模板組合器」。

同步 wishlist：§1 接關 / §2 hook 標記已完成（commit 39783cc），
新增 §3 機敏防護 / §4 模組化安裝並標完成。README 補三層防護與模組安裝說明。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-20 12:45:53 +08:00
Leo 39783cccc8 feat: 接關 hook + SDD 強制 hook（實作 wishlist 兩項） 
§1 接關機制（雙保險）：
- session-start-recall.sh：SessionStart 自動注入 status 重點 + 快照核實提醒
- /wiki-recall：fallback 命令，hook 失效時手動接關

§2 軟規範 → 硬攔截：
- sdd-guard.sh：動 code 檔但無 SDD → exit 2 擋（/sdd-check 自動版）
- pre-write-guard.sh：專案自訂禁令骨架（預設停用）
- settings.json：掛 SessionStart + PreToolUse

配套：install.sh 下載 hooks/settings（settings 比照 CLAUDE.md 不覆蓋）；
README/CLAUDE.md 補文件 + 誠實限制聲明。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-15 16:04:58 +08:00
Leo 8aa1b68ca0 Initial commit 2026-06-08 16:06:18 +08:00