Leo/system-dev-template
1
0
Fork 0
Code Issues 6 Pull Requests Actions Packages Projects Releases Wiki Activity
47 Commits 2 Branches 0 Tags
2f5d9f3bb2f31ac2d6022d4278f680bdf96b2d49
Commit Graph

8 Commits

Author SHA1 Message Date
Leo 6a49f25aef feat(W2 Phase 0-1): 雙 profile 地基＋JDD 兩軸身分＋兩支防炸閘 
SDD: docs/3-specs/jdd-dual-profile（draft → active，leo 2026-08-05 回「開工」）
範圍：總管指定的「防炸兩件 → Phase 0 → Phase 1」，Phase 2 以後未開工。

■ 防炸（排在所有 task 之前，因為它們炸的是既有的東西）
- check-no-instance-names.sh ＋ instance-names.txt：框架範本不得混入實例專名
  基線實測 22 行命中（非先前誤報的 20）→ 9 行無損泛化改寫、13 行檔級豁免記帳待 W3 搬走
  拒絕假性清理（把專名換成模糊詞＝資訊消失、分層問題還在）
- check-legacy-paths.sh：已發佈腳本引用的 35 條遠端路徑只增不移
  舊實例跑的是舊腳本、路徑寫死；搬檔＝整排 404 且不會有下一次更新來修它（1.16.0 前科）

■ Phase 0 地基
- template/manifest/{common,repo,orchestrator}.tsv：安裝清單單一真相源
  修好 install/update 兩份硬編清單的既有漂移——install 從不裝 wiki-first-search /
  subagent-wiki-guard / publish-lag-check / decisions-summary，但 update 會
  ⇒ 乾淨安裝反而拿不到 1.16/1.17/1.18 的招牌功能
- .claude/hooks/lib/role-lib.sh：scope×role 兩軸機械判定，零自陳
  身分矩陣六組實測全通過，含「成員 repo × orchestrator」不存在的格子擋下
- .sdt-framework-dev：框架開發標記（官方沒有 --framework-dev 這個參數，實查非記憶）

■ Phase 1 雙 profile
- profiles/{repo,orchestrator}/CLAUDE.md 兩部憲法
- install.sh：--profile ＋ 自動偵測＋寫檔前確認、manifest 驅動、
  CLAUDE.md 三段組裝（框架區/本地補充區界標＋sha256）、.profile、.template-manifest、
  settings.json 寫入 env.AGENT_ROLE 預設
- update.sh：漂移偵測（不覆蓋手改檔、另存 .new、白話清單）＋ 基準快照隨更新前進
- template/CLAUDE.md 原路徑凍結留底（相容）

■ 順手修掉兩個舊 bug（都在本次要動的函式裡）
- add_if_missing 少了 mkdir -p ⇒ 新目錄的檔 curl 失敗但 VERSION 照升（2026-07 記「待回報」至今未修）
- 下載健全性只用 [ -s ]＝非空即接受 ⇒ 404 頁面會無聲覆寫好檔
  （SKILL.md 260→1 行的機制；同一支腳本的版本號那條路早就防了，檔案這條沒防）

■ 實測（非推論）
- G4 憲法分流：兩個乾淨環境各裝一次，orchestrator 版含 SDD 三件式關鍵字 0 次、
  repo 版含上游指針 8 次；界標 4/4；sha 宣告與實算相符
- G7 CI 擋實例名：注入違規行 → fail 並指出 sdd-check.md:77，exit 1；還原後 exit 0
- 漂移偵測：手改兩支 hook → 正確報 2 支、手改內容保住、產 .new；
  解掉後歸零；連跑三輪冪等

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-05 23:56:48 +08:00
Leo 7b83465acf feat: SDD 生命週期鐵律——單一活性 SDD＋pending-changes 緩衝＋雙層硬約束（issue #6）+ bump 1.15.0 
leo 2026-07-17 拍板：任何時刻每 repo 只有一份現行 SDD（status: active）。

- 新增 3-specs/SDD-LIFECYCLE.md：frontmatter 狀態標記（active|draft|paused|closed + superseded_by）＋五條鐵律（單一活性／禁 CC 自建 SDD／規格變更走 pending-changes.md 等 confirm／開新 SDD 先逐條搬舊任務才准寫 code／session 開始回報三數字）
- 新增 3-specs/pending-changes.md：規格變更緩衝區骨架（待裁決／已裁決留底）
- TEMPLATE-sdd/design.md 掛 frontmatter（status: draft），移除舊「> 狀態」blockquote
- sdd-guard.sh 升級：active>1 不論寫什麼檔一律 exit 2；寫 code 檔需恰好 1 份 active；老 repo 無 frontmatter 退回舊行為（統計排除 archive/ 與 TEMPLATE）
- 新增 template/scripts/sdd-active-check.sh：獨立檢查，pre-commit/CI 可掛，>1 exit 1
- /sdd-check 加生命週期段（五鐵律摘要＋三數字回報格式）；template/CLAUDE.md 鐵律指向 SDD-LIFECYCLE.md
- install.sh/update.sh 鋪齊新檔（issue #13 教訓：update 不補新檔＝結構斷層）
- 三情境 pipe-test 真跑通過：兩份 active 擋(2)／一份放行(0)／零 frontmatter 退舊行為(0)
- 版號：遠端已被 issue #5（vault 萃取）佔走 1.14.0，本案改記 1.15.0

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-17 16:53:18 +08:00
Claude 989a6fbfed docs: 校正殘留舊路徑 .claude/wiki → system-dev/wiki（總管裁定路徑筆誤） 
wiki 於 1.9.x 已遷出 .claude/、真實慣例為 system-dev/wiki/；把描述當前架構
卻仍寫舊路徑的 doc 一併校正，讓 template 路徑故事一致、避免未來 install 被誤導。

- docs/why.md：雙空間說明的 wiki 路徑。
- docs/wishlist.md：三層機敏防護 L1/L3 的 .wikiignore 與 hook 掃描路徑。
- skills/llm-wiki/SKILL.md：架構圖、L1、維護規則。
- skills/llm-wiki/references/templates.md：CLAUDE.md/INDEX/mistakes/decisions 範本全部路徑。
- template/system-dev/docs/README.md：wiki 記憶空間標題。
- template/system-dev/wiki/.wikiignore：L3 註解。
- CHANGELOG 1.14.0 條目自身用語清乾淨。

保留（刻意不改）：install.sh/update.sh/session-start-recall.sh 的舊路徑「遷移偵測」、
CHANGELOG 歷史版本記錄、.gitignore 根目錄自裝忽略——這些本就該指舊路徑。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-07-06 03:06:04 +00:00
Claude 9a5219d8bd feat: vault 萃取能力 /wiki-extract（raw Logseq → system-dev/wiki，冪等）+ bump 1.14.0（issue #5） 
vault repo（Logseq/Obsidian 只有原文）需要萃，萃取歸 template。新增可重跑、
content_hash 冪等的增量萃取，把原始筆記萃成 system-dev/wiki 精耕卡＋[[wikilink]]，
供下游 Arcrun ingest 機械拉三元組。AI 只產卡片，不寫 KBDB、不拉三元組。

- 新增 /wiki-extract 命令：vault 增量重萃入口（給 Routine 反覆跑，不需 token）。
  content_hash 冪等（.extract-manifest.json，hash 沒變＝零 AI 呼叫）；卡片格式沿用
  wiki-init 第五步不重造；原文唯讀 + D16 精耕非 RAG。
- 新增 Logseq 任務 marker 解析單一真相源 docs/4-guides/logseq-markers.md：
  大寫 marker（非 GFM checkbox），TODO/LATER→todo、DOING/NOW→in-progress、
  WAITING→blocked、DONE→done、CANCELED/CANCELLED→closed；跳過 LOGBOOK/屬性行。
  與 template#4 tasks 投影共用同一套，不各寫一份。
- install/update 帶下新命令與 guide；wiki-init 加增量重萃指針。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-07-06 02:54:39 +00:00
Leo 93420cea4e feat: 採集規範升級三元組抓內文實體+## 實體 區塊(issue #11)+ bump 1.11.0 
Logseq 183 卡落地暴露:現行三元組只示範卡對卡(既有雙鏈加動詞、資訊量沒增加);
gloss 只描述卡標題一個 node,內文實體無處放描述。只談採集端,ingest 另立。

- 三元組改抓內文實體關係(原子筆記>>對立於>>傳統筆記,A/B 是內文概念)
- 卡片新增 ## 實體 區塊:正規名(同義詞)— 描述,供 embedding normalize,集中不重複
- ## 關聯 拆兩層:內文知識關係(端點裸文字)+卡片關係(卡對卡 [[]])
- ★端點硬自檢★:端點須與 ## 實體 一字不差,逐條比對。實證 Haiku 對不齊 14→0
- 謂詞限定動詞禁名詞(否則 Haiku 寫 >> 存儲格式 >> 讀不通)
- 兩路徑同步 SKILL(Cowork)+wiki-init(CC)

對應 SDD: wiki-architecture(內部,不推)。Closes #11

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-26 18:02:25 +08:00
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