chore(wiki): wiki-init 補骨架 + system-dev-template 安裝/更新腳本

wiki 已初始化過(push 檔活躍維護),本次補從沒建的 pull 層 + arcrun 化範本:
- cards/decisions/ 14 張決策原子卡(含 gloss/實體/typed-edge 三元組):
  從 decisions-summary 全量改寫 13 + 新增「薄殼規則晚於實作-MCP漂移是歷史債」1
- TAXONOMY 從 PKM 範本換成 arcrun 軸(子系統 零件架構/cypher/credential/recipe/kbdb/
  薄殼/部署/平台原則 + 形態 架構決策/踩坑/機制說明/禁令/案例經驗)
- principles 填 13 條跨全局原則(從 rules/ + mindset 蒸餾)
- INDEX 真實視圖(子系統角度 + 決策角度,指向 cards)
- system-dev/scripts/ + scripts/ install/update 安裝腳本(template 接入)

純基建/文檔,無業務 code(功能 code 見前一 commit)。
raw source(docs/)0 異動、wiki 卡際連結無斷鏈。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
uncle6me-web
2026-06-27 17:53:37 +08:00
parent 934b9265d9
commit 558e80b4da
28 changed files with 3147 additions and 0 deletions
@@ -0,0 +1,33 @@
---
tags: [平台原則, 零件架構, 架構決策]
gloss: arcrun 的開發預設順序——串服務先寫工作流,只有「全生態必須重用」才把能力編譯成 WASM 零件。
---
# 工作流是 default 零件是例外
← [[decisions/00-INDEX]]
**來源**`system-dev/wiki/decisions-summary.md`(零件 vs 工作流)、`.claude/rules/06-mindset.md §1`
**最後更新**2026-06-27
## 摘要
新需求的預設解是寫工作流(YAML 串 HTTP);零件是稀有例外,只在「全 arcrun 生態必須重用」時才建。
## 重點
- AI 的典型走歪=把「需要一個能力」直接翻成「做一個零件」,把「能包」當成「該包」。
- 工作流構建成本低(YAML)、生命週期短(項目級);零件成本高(TinyGo/AS + WASI)、生命週期長(平台級)。
- 判準口訣:「他人會重複打這個服務嗎?」否→工作流;是且必要重用→才考慮零件。
- 反例:mira 的 `claude_api``km_writer``kbdb_upsert_block` 本是自用膠水,卻被錯做成零件。
## 實體
> 本卡內文關鍵實體(也是 graph node)。名+描述供下游 normalize。
- **工作流**workflowYAML 串接)— 用 HTTP + 流程控制 primitive 串服務的資料產物,arcrun 的預設開發單位。
- **零件**componentWASM component)— 編譯成 .wasm 的可重用能力單元,獨立部署成 Worker,稀有例外。
- **必要重用**(全生態重用)— 「全 arcrun 生態的人都會打同一服務」這個門檻,是建零件的唯一正當理由。
## 關聯
### 內文知識關係
- 零件 >> 對立於 >> 工作流
- 必要重用 >> 是建零件的前提 >> 零件
### 卡片關係
- [[工作流是default零件是例外]] >> 是其特例 >> [[自力救濟階梯-缺能力怎麼補]]
- [[工作流是default零件是例外]] >> 共享世界觀 >> [[薄殼原則-能力長在API]]