From 82f4f44e5ae59d5758970b740b11afe7a1dc1ba6 Mon Sep 17 00:00:00 2001 From: Fam Zheng Date: Sat, 9 May 2026 21:28:33 +0100 Subject: [PATCH] =?UTF-8?q?post:=20code-doc-bot=20=E5=8A=A0=20mermaid=20?= =?UTF-8?q?=E5=9B=BE=E7=A4=BA?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- content/posts/code-doc-bot.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/content/posts/code-doc-bot.md b/content/posts/code-doc-bot.md index f0841c1..a79575b 100644 --- a/content/posts/code-doc-bot.md +++ b/content/posts/code-doc-bot.md @@ -22,6 +22,26 @@ summary: "code 是工程层,doc 是协作层,bot 在两层间穿梭。三位一 | 面向 | 机器(也给人 review) | 人(也给 bot 读) | 桥接两层 | | 寿命 | 长期 + git 历史 | 长期、可追溯 | 一次次 session | +```mermaid +flowchart LR + Human(("人")) + Agent(("AI Agent")) + Doc["doc · 协作层"] + Code["code · 工程层"] + + Human <-->|"操作"| Doc + Human -->|"review"| Code + Agent <-->|"读写"| Doc + Agent -->|"生成"| Code + + style Human fill:#fff,stroke:#333,stroke-width:2px,color:#000 + style Agent fill:#fff,stroke:#333,stroke-width:2px,color:#000 + style Doc fill:#fc9,stroke:#333,stroke-width:2px,color:#000 + style Code fill:#9cf,stroke:#333,stroke-width:2px,color:#000 +``` + +人和 AI Agent 各从一边接入两层:人在 doc 抛意图、在 code 上 review;AI 在 doc 上读写、把成果生成到 code。两个 actor 不在同一介质上面对面,而是隔着 doc 和 code 两层异步协作——这正是它健康的姿势。 + 注意 code 和 doc 不是按"内容种类"切分的——不是"过程归 code、结论归 doc"那种粗暴分工。它们是**同一份协作在两个层面的同时呈现**: - doc 端是**入口和出口**。入口是用户的混沌意图(需求一句话、背景几段、随手贴的截图);出口是给用户看的最终产出(结论、决策、总结)。doc 必须**灵活**,因为人脑就是灵活的、混乱的、随时改主意的