Vibe Coding 全貌

Vibe Coding 團隊規範 的 19 atomic entities + 視覺化關係圖。

來源:Appleboy 整理 Erik Schluntz 在 Anthropic「Vibe coding in prod | Code w/ Claude」演講。

核心命題:在享受 AI 加速的同時,不犧牲程式品質、可維護性、系統穩定性與資安。


🗺 圖 1:四法則 → 工作流 → 工具 鏈

flowchart TB
    VC([Vibe Coding<br/>忘記程式碼存在])

    subgraph 四大黃金法則
        L1[法則一<br/>Be Claude's PM<br/>提供完整 context]
        L2[法則二<br/>聚焦 Leaf Nodes<br/>遠離核心架構]
        L3[法則三<br/>核心由人嚴格 Review<br/>2 reviewer 逐行]
        L4[法則四<br/>建立可驗證檢查點<br/>不讀實作可信任]
    end

    subgraph 工作流程 SOP
        S1[Plan-then-Execute SOP<br/>7 step]
        S2[Compact 與 Session 管理]
        S3[陌生 Codebase 探索 SOP]
    end

    subgraph 設計與驗證
        D1[Leaf Node vs Core Code<br/>分類標準]
        D2[可驗證性設計三支柱<br/>介面/測試/可觀測性]
        D3[Vibe Coding TDD<br/>3 條 e2e 測試]
    end

    subgraph Prompt 規範
        P1[Prompt 必備六元素]
        P2[過度約束反效應<br/>不要綁太死]
    end

    subgraph 治理工具
        G1[AI 編程 PR 模板]
        G2[Code Review 準則]
        G3[Vibe Coding Anti-Patterns<br/>11 條禁止]
        G4[常見情境決策表]
        G5[AI 編程角色責任矩陣]
    end

    VC --> L1 & L2 & L3 & L4
    L1 --> S1 & P1 & P2
    L2 --> D1 & G4
    L3 --> G1 & G2 & G5
    L4 --> D2 & D3
    S1 --> S2 & S3
    G1 --> G2
    G3 -.違反退回.-> G2

    classDef law fill:#fef3c7,stroke:#d97706,color:#000
    classDef sop fill:#dbeafe,stroke:#2563eb,color:#000
    classDef design fill:#dcfce7,stroke:#16a34a,color:#000
    classDef prompt fill:#f3e8ff,stroke:#9333ea,color:#000
    classDef gov fill:#fee2e2,stroke:#dc2626,color:#000

    class L1,L2,L3,L4 law
    class S1,S2,S3 sop
    class D1,D2,D3 design
    class P1,P2 prompt
    class G1,G2,G3,G4,G5 gov

    click VC "Vibe Coding"
    click L1 "Be Claude's PM 法則"
    click L2 "聚焦 Leaf Nodes 法則"
    click L3 "核心由人嚴格 Review 法則"
    click L4 "建立可驗證檢查點 法則"
    click S1 "Plan-then-Execute SOP"
    click S2 "Compact 與 Session 管理 SOP"
    click S3 "陌生 Codebase 探索 SOP"
    click D1 "Leaf Node vs Core Code"
    click D2 "可驗證性設計三支柱"
    click D3 "Vibe Coding TDD 三條 e2e 測試"
    click P1 "Prompt 必備六元素"
    click P2 "過度約束反效應"
    click G1 "AI 編程 PR 模板"
    click G2 "Code Review 準則 (AI 編程)"
    click G3 "Vibe Coding Anti-Patterns"
    click G4 "常見情境決策表 (Vibe Coding)"
    click G5 "AI 編程角色責任矩陣"

🌳 圖 2:Leaf vs Core 決策樹

「我這個任務該不該 Vibe?」5 道題:

flowchart TD
    Start{要寫一個<br/>新功能 / 改動}
    Q1{涉及 secrets /<br/>payment / auth / PII?}
    Q2{跨多個 core 模組?}
    Q3{屬於架構決策?<br/>換 framework/DB/ORM}
    Q4{對這個 codebase 熟嗎?}
    Q5{失敗成本可承受 +<br/>可快速回滾?}

    Core[強制 Core code<br/>人主導 + 2 reviewer 逐行]
    Split[拆成多個 leaf-node PR]
    RFC[先寫 RFC<br/>本規範不適用]
    Explore[先做<br/>陌生 Codebase 探索 SOP]
    Vibe[Vibe Coding 適合<br/>3 條 e2e + soak test]
    SoakOnly[Leaf + soak test<br/>+ Module Owner review]

    Start --> Q1
    Q1 -- 是 --> Core
    Q1 -- 否 --> Q2
    Q2 -- 是 --> Split
    Q2 -- 否 --> Q3
    Q3 -- 是 --> RFC
    Q3 -- 否 --> Q4
    Q4 -- 不熟 --> Explore
    Q4 -- 熟 --> Q5
    Q5 -- 是 --> Vibe
    Q5 -- 否 --> SoakOnly

    classDef red fill:#fee2e2,stroke:#dc2626,color:#000
    classDef yellow fill:#fef3c7,stroke:#d97706,color:#000
    classDef green fill:#dcfce7,stroke:#16a34a,color:#000

    class Core,Split,RFC red
    class Explore,SoakOnly yellow
    class Vibe green

    click Core "Leaf Node vs Core Code"
    click Split "聚焦 Leaf Nodes 法則"
    click Explore "陌生 Codebase 探索 SOP"
    click Vibe "Vibe Coding"
    click SoakOnly "建立可驗證檢查點 法則"

👥 圖 3:角色 ↔ 責任 ↔ 工具

flowchart LR
    subgraph 角色
        A[Author<br/>PR 作者]
        R[Reviewer<br/>同儕]
        O[Module Owner<br/>核心守門員]
        T[Tech Lead<br/>規範看守人]
        M[每位成員<br/>長期能力建設]
    end

    subgraph 操作層工具
        Plan[Plan-then-Execute SOP]
        Prompt6[Prompt 必備六元素]
        PR[AI 編程 PR 模板]
        Review[Code Review 準則]
        Decision[常見情境決策表]
    end

    subgraph 治理層
        Anti[Anti-Patterns 11 條<br/>退回紅線]
        Quarter[每季重檢<br/>leaf/core 分類]
    end

    A -->|遵循| Plan
    A -->|寫| Prompt6
    A -->|填| PR
    R -->|依| Review
    R -->|查| Anti
    O -->|有否決權| PR
    T -->|主持| Quarter
    T -->|audit| Anti
    M -->|累積| Decision

    classDef role fill:#dbeafe,stroke:#2563eb,color:#000
    classDef ops fill:#dcfce7,stroke:#16a34a,color:#000
    classDef gov fill:#fee2e2,stroke:#dc2626,color:#000

    class A,R,O,T,M role
    class Plan,Prompt6,PR,Review,Decision ops
    class Anti,Quarter gov

    click A "AI 編程角色責任矩陣"
    click PR "AI 編程 PR 模板"
    click Review "Code Review 準則 (AI 編程)"
    click Anti "Vibe Coding Anti-Patterns"
    click Plan "Plan-then-Execute SOP"

📚 Entity 索引(19 atomic + 1 source artifact)

核心概念(concept × 7)

Entity一句話
Vibe CodingKarpathy 提出的 AI 編程模式:忘記程式碼存在,只透過抽象層驗證
四大黃金法則 (Vibe Coding)Appleboy 歸納的 4 條工程紀律總覽
Leaf Node vs Core Code哪些 code 適合大量 vibe(leaf)vs 必須人主導(core)
可驗證性設計三支柱介面優先 / 測試覆蓋 / 可觀測性
Prompt 必備六元素目標 / 範圍 / 既有模式 / 約束 / 驗證 / Done
過度約束反效應模型在沒被過度約束時表現最好
常見情境決策表 (Vibe Coding)12 個情境的 vibe / core / RFC 分類速查

規範(rule × 6)

Entity一句話
Be Claude’s PM 法則法則一:為 Claude 提供完整上下文
聚焦 Leaf Nodes 法則法則二:AI 大量產出集中在不擴散影響的葉節點
核心由人嚴格 Review 法則法則三:Core 兩位 reviewer 逐行讀,標示 AI 範圍
建立可驗證檢查點 法則法則四:Reviewer 不讀實作也能信任
Code Review 準則 (AI 編程)Reviewer 6 重點順序 + 標準退回理由
Vibe Coding Anti-Patterns11 條禁止事項,違反 PR 直接退回
AI 編程角色責任矩陣Author / Reviewer / Module Owner / Tech Lead / 成員 5 角色

工作流程(process × 4)

Entity一句話
Plan-then-Execute SOP7 步流程:需求 → 探索 → 計畫 → 執行 → 驗證 → PR → Review
Compact 與 Session 管理 SOP何時該 compact(吃午餐再回來那種臨界點)
陌生 Codebase 探索 SOP不熟 codebase 的 4 步建心智圖
Vibe Coding TDD 三條 e2e 測試一條 happy path + 兩條 error 即可

Artifact(artifact × 2)

Entity一句話
Vibe Coding 團隊規範Appleboy 整理的完整 SDLC 規範(本 map 來源)
AI 編程 PR 模板.github/pull_request_template.md 完整內容

🔗 跨主題連結

連到關係
Compounding Engineering廣義「AI 加速軟體開發」趨勢,Vibe Coding 是其中一種實作模式
Harness Engineering把 AI 工作流程具象化為 harness,Vibe Coding 的法則是 harness 內的 guard rails
3A 架構Architect/Author/Audit 對應 Vibe Coding 7 步流程的不同階段
Agent-native 開發者技能Vibe Coding 是 agent-native 技能的子集
CLAUDE.md 4 層機制Be Claude’s PM 法則的落地工具
Skills 九種類型Prompt 必備六元素可包成 skill
Sub-agent探索階段可派 sub-agent 主對話保持乾淨
Slash Commands/compact 對應 Compact 與 Session 管理 SOP
Context Rot Zone對話太長退化警訊背後的機制
Effort 推理強度Compact 後可調整 effort

📊 統計

  • Atomic entities:19(concept 7 / rule 6 / process 4 / artifact 2)
  • 全部在 claude/ domain
  • 3 個 mermaid 圖:法則鏈 / 決策樹 / 角色矩陣
  • 來源Vibe Coding 團隊規範(Appleboy clipping,原 497 行)

跟其他 Maps 的關係

  • Claude 索引 — 上層 MOC,包含本 map
  • 未來若有「AI 編程規範總覽」之類更上層的 MOC,可從本 map 連出去(目前無此頁,避免 wishful wiki-link)

← 回到 wiki | Claude 索引