Leo/Arcrun

Files

T

uncle6me-web 558e80b4da 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>

2026-06-27 17:53:37 +08:00

1.9 KiB

Raw Permalink Blame History

tags, gloss

工作流是 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。

工作流（workflow／YAML 串接）— 用 HTTP + 流程控制 primitive 串服務的資料產物，arcrun 的預設開發單位。
零件（component／WASM component）— 編譯成 .wasm 的可重用能力單元，獨立部署成 Worker，稀有例外。
必要重用（全生態重用）— 「全 arcrun 生態的人都會打同一服務」這個門檻，是建零件的唯一正當理由。

關聯

內文知識關係

零件 >> 對立於 >> 工作流
必要重用 >> 是建零件的前提 >> 零件

卡片關係

工作流是default零件是例外 >> 是其特例 >> 自力救濟階梯-缺能力怎麼補
工作流是default零件是例外 >> 共享世界觀 >> 薄殼原則-能力長在API

1.9 KiB Raw Permalink Blame History Unescape Escape

工作流是 default 零件是例外

摘要

重點

實體

關聯

內文知識關係

卡片關係

1.9 KiB

Raw Permalink Blame History